Add a feature tracker for implementation status and code locations.
Co-authored-by: Cursor <cursoragent@cursor.com>
@@ -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 tracker2
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 hierarchy11
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 layers17
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 chunks23
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 components29
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 tick35
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 persistence41
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 saves47
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 settings53
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 lighting59
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 changelog77
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 gateway83
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 authentication89
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
## Characters95
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 inheritance101
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 replication107
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\* pathfinding113
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 cadence119
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 interpolation125
126
**Status:** not implemented 127
**Spec:** Client lerps sprites between replicated tiles over the walk or run interval. 128
**Code:** —129
130
## FrameworkV3 client bootstrap131
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 contract137
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 camera143
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 shading149
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 transfer155
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 persistence161
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 deploy167
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
## Spawners173
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 drops179
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, pigeons185
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 marketplace191
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 hooks197
198
**Status:** not implemented 199
**Spec:** Reserved control abstraction; not in the initial release. 200
**Code:** —