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

3
Tools/README.md
View file

@ -33,7 +33,8 @@ so they only help between paths. Expect a regeneration to take minutes, or to ne
| File | What it is |
|---|---|
| `MapData_Seed_<seed>.dat` | The binary blueprint the server reads (~512 MB at 8K) |
| `MapData_Seed_<seed>.dat` | The binary blueprint the server reads — **v2 tagged container** (~336 MB at 8K; contract in `Core/Scripts/BLUEPRINT_FORMAT.md`) |
| `MapData_Seed_<seed>_v1.dat` | The same content in the legacy v1 format (~512 MB), dual-written as a safety net until a future removal task |
| `Map_Seed_<seed>.png` | Visual snapshot of the map, for reviewing and picking seeds |
On Linux: `~/.local/share/godot/app_userdata/islaApocolypse/`.