flatland3 0.2.2

Flatland3 terminal play client and account CLI
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
58

//! Built-in capabilities reference for `flatland3 capabilities`.

pub fn print() {
    println!(
        r#"Flatland3 CLI — capabilities (Tier 1.3)

BINARIES
  flatland3                 Play client + account CLI (this binary)
  flatland-server           Game TCP server (:7373)
  flatland-control-plane    HTTP API (:7380) — accounts, tokens
  flatland-bot              Headless bot harness
  flatland-dev              Embedded server + TUI (monorepo dev only)

AUTH → CHARACTER → PLAY
  flatland3 auth register --email E --password P --name DISPLAY
  flatland3 auth login --email E --password P
  flatland3 character create MadSin     Create once (session auth only)
  flatland3 character list              List characters (* = last played)
  flatland3 --name MadSin               Play as existing character
  flatland3                             Play last character (or only one)

  Play NEVER auto-creates characters. Names: letters/digits/_/- only.

PLAY
  flatland3 --server HOST:7373      Remote game server address
  flatland3 keys                    All play keybindings by category
  Controls: WASD move, ? keybindings, Ctrl+Q quit

AUTH TOKENS
  flatland3 auth token create --name LABEL --scope play,read
  flatland3 auth token list
  flatland3 auth token revoke UUID

ENVIRONMENT
  FLATLAND_API_URL          Control plane base (default http://127.0.0.1:7380)
  FLATLAND_API_TOKEN        flat_live_… for agent/CI play (scope: play)
  FLATLAND_CHARACTER_ID     Character UUID (required with API token; optional override)
  FLATLAND_SESSION_TOKEN    flat_sess_… alternative to session file
  RUST_LOG                  Log level (warn, info, debug)

LOCAL STACK
  cp .env.example .env && make db-up
  cargo run -p flatland-control-plane-bin
  cargo run -p flatland-server
  flatland3 auth login …
  flatland3 character create traveler
  cargo run -p flatland3 -- --name traveler

SOLO DEV (embedded server, monorepo):
  cargo run -p flatland-dev -- --bots 8

DOCS
  README.md                 Quickstart
  plans/05-cli-and-developer-guide.md   Full CLI + HTTP reference
  plans/04-implementation-roadmap.md  Implementation checklist
"#
    );
}