BlueGit

timfa questward

Add a feature tracker for implementation status and code locations.

Co-authored-by: Cursor <cursoragent@cursor.com>

timfa Tim Falken · pushed by timfa

Authored 2026-08-24 · 2 months ago

Hash
77da18cadb97418b3e7bd3bf577ee8084a626de0
Parent
b6dde188
1 file changed +200 −0
docs/FEATURES.md added +200 −0
@@ -0,0 +1,200 @@
1 # Feature implementation tracker
2
3 Living companion to `tile_mmo_server_technical_design_v0.6.md`.
4 Statuses: **not implemented** · **partial** · **full**.
5
6 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.
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:** —
@@ -0,0 +1,200 @@
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:** —