beezm/islaApocalypse
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: BLUEPRINT_FORMAT.md + README updates for the v2 container (terrain-water task 02)

Browse source 
Byte-accurate v2 contract (magic/version, tagged sections, registered
FourCC table, validation rules, re-encode sentinels, extension path)
plus the v1 legacy summary — v1 stays live per the safety-net plan.
READMEs updated additively: parser dispatch, dual-write outputs,
harness usage, server params cross-check, wire-format hazard rewording
(u8 on v2 path, range-checked; append-only rule unchanged).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Stewart Howe 2026-08-06 07:31:03 -04:00
parent 8532d88771
commit a7e6c17422
7 changed files with 185 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Server/README.md
View file

@ -8,11 +8,15 @@ future multiplayer setup this is the side that dictates terrain and ships chunk
Attached to the `World` root node of `Scenes/Main.tscn`. Runs the whole 3D world at boot.
### Startup
1. Loads `ServerConfig.json` and the seed's `.dat` blueprint.
2. **Finds the Capitol** in the parsed town list and uses it as the world origin point.
3. Converts its pixel position to chunk coordinates (`pixel / CHUNK_SIZE`).
4. Builds a `(2 × ChunkRadius)²` grid of chunks around it — **synchronously, all at boot**.
5. Teleports the `Camera3D` to 120 m above the Capitol, looking down.
1. Loads `ServerConfig.json` and the seed's `.dat` blueprint (v2 or legacy v1 — the parser
dispatches automatically; see `Core/Scripts/BLUEPRINT_FORMAT.md`).
2. **Cross-checks the blueprint's embedded params** (v2 only) against the config and logs a
prominent `BLUEPRINT/CONFIG DESYNC` warning if the seed or MapSize disagree — a config edited
after generation is loud now, not silent.
3. **Finds the Capitol** in the parsed town list and uses it as the world origin point.
4. Converts its pixel position to chunk coordinates (`pixel / CHUNK_SIZE`).
5. Builds a `(2 × ChunkRadius)²` grid of chunks around it — **synchronously, all at boot**.
6. Teleports the `Camera3D` to 120 m above the Capitol, looking down.
⚠ **Two things to know about startup.** The chunk grid is built in one blocking pass with no
streaming or unloading, so `ChunkRadius` directly controls boot cost — 32 means 4,096 chunks and