testlevel chapters 2-31 overwrite game memory (coin counter and flag rows end after world 8: progress, language, options): level projects, play-tests and the arena use chapters 1 and 32-49, old settings migrate; level tally counts the level's own coins and secrets

notes/mod-arena.md

@@ -11,11 +11,12 @@ Registered in `ModRegistry` (one line). Test-only: `ArenaTestMod` (src/test, scr
 | `waves` | 3 (1–5) | wave n has min(n, 2) alligators (3 waves = 5 alligators) |
 | `energy` | 4 (1–5) | llama energy cap (5 = game normal) |
 | `coins` | 1 (0–5) | EnemyCoins per hit (+5 on defeat, +5 bonus at the exit) |
-| `chapter` | 8 (2–8) | TestLevel chapter; a chapter already written by another mod → apply error |
+| `chapter` | 49 (32–49) | TestLevel chapter; a chapter already written by another mod → apply error; a stored 2–8 falls back to 49 |
 
-Chapter ≤ 8 on purpose: `levelRecord` (coin counter) lives at `0x584F1C[world·6 + chapter]`; for
-world 9 chapter 9 that is 0x585018 = furthest progress (unverified risk for level projects on
-chapters ≥ 9, see "Issues").
+Only chapters 32–49: the coin counter `0x584F1C[world·6 + chapter]` and the flag byte
+`0x584EC8[…]` of world-9 chapters 2–31 overwrite other globals (chapter 8 = last played map,
+chapter 9 = furthest progress – verified, see [testlevel-chapters.md](testlevel-chapters.md)).
+The tally total (LNFO) is 2 placed coins + alligators · ((lives − 1) · coins + 5) + 5 bonus.
 
 Script options (`Arena`, tests/`ArenaTestMod`): `probe=true` (event probe 1.6 ahead of the llama),
 `master=false` (no alligators), `start=x,z,rot`, `debug=true` (HUD coin counter shows
@@ -72,7 +73,9 @@ per type (nVars/slots/typeFlags/extra), then `LevelBuilder` builds the level.
 * `spawn` copies the strat's matrix/translation block, not `x/y/z`: after `self.x = …` the child
   appears at the old place unless the spawner yields first.
 * Energy 0: the game's "Weiter / Beenden" screen; Weiter restarts the level (all strats fresh).
-* The level tally after the exit shows "Münzen gesammelt 0 / 55" (not our coin counter).
+* The level tally after the exit showed "Münzen gesammelt 0 / 55" on chapter 8: 0 = the coin slot
+  after endLevel wrote the last played map into it, 55 = LNFO of the Village base. Fixed: chapter
+  32–49 and recounted LNFO ("2 / 12" for 1 alligator with 1 life).
 
 ## Verified in game (apptest :24, Wine 6, load 3–9, 2026-11-07)
 
@@ -101,7 +104,6 @@ mod's chapter → IOException; probe option.
 
 ## Issues / limits
 
-* Loading picture and tally use the TestLevel texts ("TestLevel Kapitel 8").
+* Loading picture and tally use the TestLevel texts ("TestLevel Kapitel 49").
 * The exit target is the arena itself (1, 9, chapter): it restarts after the tally.
-* Level projects on TestLevel chapters ≥ 9 may write the coin counter over furthest progress
-  (0x585018) – not verified.
+* Exiting chapter 49 unlocks "chapter 50" (progress 9/50); the map caps the cursor at 49 (checked).