BlueGit

timfa questward

Files

questward / docs / FEATURES.md

FEATURES.md

FEATURES.md 6.7 KiB Download Raw

Feature implementation tracker

Living companion to tile_mmo_server_technical_design_v0.6.md. Statuses: not implemented · partial · full.

Each entry is a short note on behaviour and where the code lives. Update this file in the same commit as the feature it describes.

---

World coordinates and spatial hierarchy

Status: not implemented Spec: World tile coordinates are canonical. Chunks are 16×16 tiles; regions are 4×4 chunks. Negative coordinates use true floor division. Code: —

Ground and block tile layers

Status: not implemented Spec: Every tile has a visual ground type. An optional block supplies collision and behaviour. Unedited chunks are default grass with no blocks. Code: —

Open and closed chunks

Status: not implemented Spec: Never-edited chunks are closed. Closed chunks are visible in the 3×3 view but cannot be entered. Pathfinding and spawners treat them as impassable. Code: —

ECS registry and components

Status: not implemented Spec: Entities are compositions of components. Simulation uses integer tile positions. Players in the world are character entities, not accounts. Code: —

Simulation tick

Status: not implemented Spec: Fixed tick from WorldSettings.simulationTickHz (default 20 Hz). Commands drain at tick boundaries. Code: —

Authored world and runtime state persistence

Status: not implemented Spec: world.sqlite holds revisioned authored chunks and settings. state.sqlite holds accounts, characters, and runtime entity state. Chunks persist on unload. Code: —

World revisions and pending editor saves

Status: not implemented Spec: Editor saves write a pending world revision. The running process stays pinned to the revision loaded at startup until restart or an explicit apply. Code: —

World settings

Status: not implemented Spec: Global cadence and timers (walk speed, tick rate, deletion delay, and similar) live in authored world settings, edited from a modal. Code: —

Baked lighting

Status: not implemented Spec: On chunk save, raycast light from blocks with lightRangeTiles through passable tiles, including across chunk borders. Store a 16×16 reach mask. Code: —

World editor (server)

Status: not implemented Spec: Admin API to load/save a chunk, toggle open/closed, paint ground/blocks, write changelog bullets, and edit world settings. Marketplace/bank/spawner placement comes later with assets. Code: —

World editor (client)

Status: not implemented Spec: Separate admin UI. One chunk at a time, chunk-step navigation, paint palette, open/closed, changelog, night preview slider, settings modal. Code: —

Per-chunk changelog

Status: not implemented Spec: Each save stores who, when, and structured bullets of ground/block/open-closed diffs. Code: —

WebSocket gateway

Status: not implemented Spec: Connections belong to a gateway. Clients send intentions. JSON messages for the first version. Code: —

Stub authentication

Status: not implemented Spec: Until auth.timfalken.com exists, each connection is admin-<n> (n = connected clients including this one). Stub accounts are admins. Code: —

Characters

Status: not implemented Spec: Unlimited characters per account, one in the world. First/last name rules, male/female, delayed deletion with inheritance (inheritance later). Code: —

Character deletion and inheritance

Status: not implemented Spec: 24h delayed delete, cancellable, email or stub log. Inventory/equipment/wallet/vault move to an account inheritance tab. Code: —

3×3 chunk replication

Status: not implemented Spec: Players receive the current chunk and eight neighbours as snapshots, then deltas. Closed chunks are still sent. Code: —

Click-to-move and A\* pathfinding

Status: not implemented Spec: MOVE_TO runs A\ over the visible 3×3 using block passability and open-chunk bounds. Server commits integer tiles. Code:* —

Global walk/run cadence

Status: not implemented Spec: Walk 2 tiles/s, run double. Movement ticks at run rate. SetGait chooses every-other vs every movement tick. Code: —

Client movement interpolation

Status: not implemented Spec: Client lerps sprites between replicated tiles over the walk or run interval. Code: —

FrameworkV3 client bootstrap

Status: not implemented Spec: FrameworkV3 is a git submodule at client/frameworkv3, built first. Game code lives in client/src. Server does not import it. Code: —

16×16 sprite contract

Status: not implemented Spec: World sprites must be exactly 16×16. Reject at load. CI/unit test lists every offender and fails. Code: —

Play viewport and camera

Status: not implemented Spec: Camera stays centered on the local player. Zoom is viewport-only and does not change server visibility. Code: —

Night shading

Status: not implemented Spec: World time is server time minus 1200 years. At night, tiles the baked light map cannot reach are darkened. Code: —

Region workers and cross-worker transfer

Status: not implemented Spec: Regions owned by simulation workers, ghost borders, entity transfer. First version is a single process. Code: —

ChunkLoader activation and unload persistence

Status: not implemented Spec: Reference-counted loaders keep chunks simulating. Persist on unload, not on a timer. Code: —

Midnight restart and Git deploy

Status: not implemented Spec: systemd + manifest-driven Git deploy. Pending world/code changes apply at server-local midnight, with an admin immediate-restart path. Crashes must not pull. Code: —

Spawners

Status: not implemented Spec: Spawner blocks with mob type, max alive, range. Do not fire in closed chunks. Code: —

Inventory, items, equipment, ground drops

Status: not implemented Spec: 32-slot inventory, stacking, equipment overlays, temporary ground items. Waiting on item assets. Code: —

Combat, skills, groups, proximity chat, pigeons

Status: not implemented Spec: Later systems described in the design. Not part of the first playable slice. Code: —

Banking, cheques, shops, player-driven marketplace

Status: not implemented Spec: Marketplace and related world features are built in the world editor after the required assets exist. Code: —

Player scripting hooks

Status: not implemented Spec: Reserved control abstraction; not in the initial release. Code: —

Source
1# Feature implementation tracker
2
3Living companion to `tile_mmo_server_technical_design_v0.6.md`.
4Statuses: **not implemented** · **partial** · **full**.
5
6Each entry is a short note on behaviour and where the code lives. Update this file in the same commit as the feature it describes.
7
8---
9
10## World coordinates and spatial hierarchy
11
12**Status:** not implemented
13**Spec:** World tile coordinates are canonical. Chunks are 16×16 tiles; regions are 4×4 chunks. Negative coordinates use true floor division.
14**Code:** —
15
16## Ground and block tile layers
17
18**Status:** not implemented
19**Spec:** Every tile has a visual ground type. An optional block supplies collision and behaviour. Unedited chunks are default grass with no blocks.
20**Code:** —
21
22## Open and closed chunks
23
24**Status:** not implemented
25**Spec:** Never-edited chunks are closed. Closed chunks are visible in the 3×3 view but cannot be entered. Pathfinding and spawners treat them as impassable.
26**Code:** —
27
28## ECS registry and components
29
30**Status:** not implemented
31**Spec:** Entities are compositions of components. Simulation uses integer tile positions. Players in the world are character entities, not accounts.
32**Code:** —
33
34## Simulation tick
35
36**Status:** not implemented
37**Spec:** Fixed tick from `WorldSettings.simulationTickHz` (default 20 Hz). Commands drain at tick boundaries.
38**Code:** —
39
40## Authored world and runtime state persistence
41
42**Status:** not implemented
43**Spec:** `world.sqlite` holds revisioned authored chunks and settings. `state.sqlite` holds accounts, characters, and runtime entity state. Chunks persist on unload.
44**Code:** —
45
46## World revisions and pending editor saves
47
48**Status:** not implemented
49**Spec:** Editor saves write a pending world revision. The running process stays pinned to the revision loaded at startup until restart or an explicit apply.
50**Code:** —
51
52## World settings
53
54**Status:** not implemented
55**Spec:** Global cadence and timers (walk speed, tick rate, deletion delay, and similar) live in authored world settings, edited from a modal.
56**Code:** —
57
58## Baked lighting
59
60**Status:** not implemented
61**Spec:** On chunk save, raycast light from blocks with `lightRangeTiles` through passable tiles, including across chunk borders. Store a 16×16 reach mask.
62**Code:** —
63
64## World editor (server)
65
66**Status:** not implemented
67**Spec:** Admin API to load/save a chunk, toggle open/closed, paint ground/blocks, write changelog bullets, and edit world settings. Marketplace/bank/spawner placement comes later with assets.
68**Code:** —
69
70## World editor (client)
71
72**Status:** not implemented
73**Spec:** Separate admin UI. One chunk at a time, chunk-step navigation, paint palette, open/closed, changelog, night preview slider, settings modal.
74**Code:** —
75
76## Per-chunk changelog
77
78**Status:** not implemented
79**Spec:** Each save stores who, when, and structured bullets of ground/block/open-closed diffs.
80**Code:** —
81
82## WebSocket gateway
83
84**Status:** not implemented
85**Spec:** Connections belong to a gateway. Clients send intentions. JSON messages for the first version.
86**Code:** —
87
88## Stub authentication
89
90**Status:** not implemented
91**Spec:** Until auth.timfalken.com exists, each connection is `admin-<n>` (n = connected clients including this one). Stub accounts are admins.
92**Code:** —
93
94## Characters
95
96**Status:** not implemented
97**Spec:** Unlimited characters per account, one in the world. First/last name rules, male/female, delayed deletion with inheritance (inheritance later).
98**Code:** —
99
100## Character deletion and inheritance
101
102**Status:** not implemented
103**Spec:** 24h delayed delete, cancellable, email or stub log. Inventory/equipment/wallet/vault move to an account inheritance tab.
104**Code:** —
105
106## 3×3 chunk replication
107
108**Status:** not implemented
109**Spec:** Players receive the current chunk and eight neighbours as snapshots, then deltas. Closed chunks are still sent.
110**Code:** —
111
112## Click-to-move and A\* pathfinding
113
114**Status:** not implemented
115**Spec:** `MOVE_TO` runs A\* over the visible 3×3 using block passability and open-chunk bounds. Server commits integer tiles.
116**Code:** —
117
118## Global walk/run cadence
119
120**Status:** not implemented
121**Spec:** Walk 2 tiles/s, run double. Movement ticks at run rate. `SetGait` chooses every-other vs every movement tick.
122**Code:** —
123
124## Client movement interpolation
125
126**Status:** not implemented
127**Spec:** Client lerps sprites between replicated tiles over the walk or run interval.
128**Code:** —
129
130## FrameworkV3 client bootstrap
131
132**Status:** not implemented
133**Spec:** FrameworkV3 is a git submodule at `client/frameworkv3`, built first. Game code lives in `client/src`. Server does not import it.
134**Code:** —
135
136## 16×16 sprite contract
137
138**Status:** not implemented
139**Spec:** World sprites must be exactly 16×16. Reject at load. CI/unit test lists every offender and fails.
140**Code:** —
141
142## Play viewport and camera
143
144**Status:** not implemented
145**Spec:** Camera stays centered on the local player. Zoom is viewport-only and does not change server visibility.
146**Code:** —
147
148## Night shading
149
150**Status:** not implemented
151**Spec:** World time is server time minus 1200 years. At night, tiles the baked light map cannot reach are darkened.
152**Code:** —
153
154## Region workers and cross-worker transfer
155
156**Status:** not implemented
157**Spec:** Regions owned by simulation workers, ghost borders, entity transfer. First version is a single process.
158**Code:** —
159
160## ChunkLoader activation and unload persistence
161
162**Status:** not implemented
163**Spec:** Reference-counted loaders keep chunks simulating. Persist on unload, not on a timer.
164**Code:** —
165
166## Midnight restart and Git deploy
167
168**Status:** not implemented
169**Spec:** systemd + manifest-driven Git deploy. Pending world/code changes apply at server-local midnight, with an admin immediate-restart path. Crashes must not pull.
170**Code:** —
171
172## Spawners
173
174**Status:** not implemented
175**Spec:** Spawner blocks with mob type, max alive, range. Do not fire in closed chunks.
176**Code:** —
177
178## Inventory, items, equipment, ground drops
179
180**Status:** not implemented
181**Spec:** 32-slot inventory, stacking, equipment overlays, temporary ground items. Waiting on item assets.
182**Code:** —
183
184## Combat, skills, groups, proximity chat, pigeons
185
186**Status:** not implemented
187**Spec:** Later systems described in the design. Not part of the first playable slice.
188**Code:** —
189
190## Banking, cheques, shops, player-driven marketplace
191
192**Status:** not implemented
193**Spec:** Marketplace and related world features are built in the world editor after the required assets exist.
194**Code:** —
195
196## Player scripting hooks
197
198**Status:** not implemented
199**Spec:** Reserved control abstraction; not in the initial release.
200**Code:** —