flatland3-gfx 0.2.28

Flatland3 Macroquad + egui graphical play client
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# flatland3-gfx

Macroquad + egui graphical play client for [Flatland3](https://github.com/bvelasquez/flatland3).

## Install

```bash
cargo install flatland3-gfx
```

Run from a checkout that includes `assets/` (or set `FLATLAND_ASSETS` to your content tree) so terrain tiles and sprites resolve.

## Quickstart

```bash
flatland3-gfx
# or pick a character by name:
flatland3-gfx --name traveler
```

On first launch (or when the saved session is expired **and** no remembered password is available), the client shows **Login** / **Create account**. After a successful login, email/password are saved to platform config `flatland/login.json` (mode `0600`). When Redis/dev restarts invalidate the control-plane session token, the client silently re-logs in with those credentials and keeps your last character.

New accounts continue to **Create character**. Accounts with **two or more** characters always get a **Select character** screen (last played is marked ★ and remembered after you pick). A single character is used automatically.

In-game (**F2**): **Switch character** returns to the picker; **Log out** clears the session token and returns to Login (saved email/password remain for autofill).

Session file: platform config dir `flatland/session.json` (same as `flatland3 auth login`). Login autofill: `flatland/login.json`. Game server defaults to `127.0.0.1:7373` from `client.json`.

**One-shot remote host** (does not write `client.json`):

```bash
flatland3-gfx --host server2.flatland3.com
# optional character:
flatland3-gfx --host server2.flatland3.com --name traveler
```

`--host` accepts DNS or IP; gateway port defaults to **7373**, API to **7380**. Session for that host is stored separately (`session.<host>.json`) so your local `session.json` is left alone. Prefer `--host` over `--server` (IP:port only). Set `FLATLAND_API_TOKEN` to skip interactive onboarding (agents/CI).

## Crates.io stack

| Crate | Role |
|-------|------|
| `flatland-protocol` | Wire types and codecs |
| `flatland-client-lib` | TCP session and game state |
| `flatland-client-ui` | Engine-agnostic play UI (input, world grid, presentation) |
| `flatland-gfx-engine` | Macroquad map renderer + egui HUD |
| `flatland3-gfx` | This binary (`cargo install flatland3-gfx`) |

The terminal client remains `cargo install flatland3`.

## Monorepo dev

```bash
make dev-play-gfx
# or
cargo run -p flatland3-gfx -- --name traveler
```