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

docs/manual/01-introduction.md

@@ -76,7 +76,7 @@ created. Object types of other levels can be added later with **Assets → All w
 
 The game has eight worlds – **Village, Jungle at Night, River, Jungle by Day, Mountain, City,
 Catacombs, Lab** – each with several chapters. A ninth, hidden world called **TestLevel** has 49
-empty chapter slots. New levels go into one of these TestLevel chapters, so they never replace an
+empty chapter slots; 19 of them (1 and 32–49) are safe to use. New levels go into one of these TestLevel chapters, so they never replace an
 original level: each project gets its own chapter (shown in the New level dialog and in
 [Level settings](14-level-settings.md)). In the game they appear on the world-9 map as
 "TestLevel – chapter *n*".

docs/manual/03-editor-window.md

@@ -29,7 +29,7 @@ list of recent projects.
 | **Level name** | The name LlamaMod and the loading picture show. |
 | **Author** | Your name (remembered for the next level). |
 | **Base level** | The original level that provides object types, textures, sky, fog and music, shown with its loading picture. Default: Village – Chapter 1. See [Base levels](01-introduction.md#base-levels). |
-| **TestLevel chapter** | The chapter of world 9 (TestLevel) the level replaces when it is enabled. The next free chapter is suggested. |
+| **TestLevel chapter** | The chapter of world 9 (TestLevel, 32–49 or 1) the level replaces when it is enabled. The next free chapter is suggested. |
 | **Start with** | **Empty** (nothing but the base level's sky, fog and music), **Flat floor** (a 16×14 grass floor, player start and an exit) or **Island** (a grass island with trees in the sea, player start and an exit). |
 
 Every new level starts clean: of the base level it keeps only the **start zone** (its fog, colours

docs/manual/14-level-settings.md

@@ -25,7 +25,7 @@ nothing.
 | **Description** | A few sentences for the mod list. |
 | **Project** | *new level* or *changes to an original level* (read only). |
 | **Base level** | The original level the project is built on – it provides the object code, textures, sounds, sky and music (read only). |
-| **TestLevel chapter** | New levels only: the chapter of world 9 (TestLevel, 1–49) the level replaces when its mod is on. |
+| **TestLevel chapter** | New levels only: the chapter of world 9 (TestLevel: 32–49, or 1) the level replaces when its mod is on. Chapters 2–31 are not offered: the game would store this level's coins over other game data. |
 
 Below the chapter field the dialog lists which chapters other level projects in your `levels`
 folder already use, so you can pick a free one. Each level needs its own chapter; chapter 1 is

docs/manual/17-sharing.md

@@ -39,14 +39,17 @@ Then tick the level in LlamaMod, click **Apply** and **▶ Play**. To get rid of
 
 ## Chapters and conflicts
 
-Each new level occupies one of the 49 TestLevel chapters. The editor picks a free chapter for
+Each new level occupies one of the TestLevel chapters **32–49** (or chapter 1). The editor picks a free chapter for
 new projects, but levels from different people may use the same one. If two active level mods
 use the same chapter – or two mods change the same original level – LlamaMod stops applying and
 names the files involved. Fix it in the mod's options: every new-level mod has a
-**TestLevel chapter** option (1–49).
+**TestLevel chapter** option (1, 32–49).
 
-> **Note:** Chapter 1 of the TestLevel is also used by the built-in **Test World** mod. Prefer
-> chapters 2 and above for your own levels.
+> **Note:** Chapter 1 of the TestLevel is also used by the built-in **Test World** mod. The game
+> keeps coins and flags for chapters 2–31 of world 9 in memory that belongs to other things (your
+> progress, the text language …), so LlamaMod does not use them: levels saved with such a chapter
+> by an older version move to a free chapter from 32 on. With more than 18 new levels, some share a
+> chapter – only one of them can be on at a time.
 
 ## Updating a shared level
 

docs/manual/18-mods.md

@@ -38,7 +38,7 @@ option:
 
 | Option | Values | Meaning |
 |---|---|---|
-| TestLevel chapter | 1 – 49 | the chapter of world 9 the level occupies; each level needs its own (chapter 1 is also used by the Test World mod) |
+| TestLevel chapter | 1, 32 – 49 | the chapter of world 9 the level occupies; each level needs its own (chapter 1 is also used by the Test World mod). Other chapters would overwrite game data such as your progress, so older levels on chapters 2–31 move to a free one of 32–49 |
 
 Edited original levels have no options – they replace their chapter. See
 [Sharing levels](17-sharing.md).
@@ -61,7 +61,7 @@ not want with **Remove…**.
 
 ## The Alligator Arena minigame
 
-The **Alligator Arena** mod (Levels) puts a small minigame on a TestLevel chapter (default 8):
+The **Alligator Arena** mod (Levels) puts a small minigame on a TestLevel chapter (32–49, default 49):
 a walled sand pit where alligators come in waves (wave 1: one, then two at a time). Face an
 alligator and **kick** (Action) or **jump and press Action in the air** (the llama dives onto
 it). Every hit costs it one life: it blinks, backs off and coins pop out – they count on the
@@ -107,7 +107,7 @@ A minigame on a TestLevel chapter: alligators come in waves into a walled pit. E
 | Waves | 1 – 5 | 3 | Wave n brings n alligators (at most 2 at once). |
 | Llama energy | 1 – 5 | 4 | Energy cap of the llama in the arena (5 = normal). |
 | Coins per hit | 0 – 5 | 1 | Coins that pop out per hit (5 more at the end). |
-| TestLevel chapter | 2 – 8 | 8 | Chapter of world 9 the arena replaces. |
+| TestLevel chapter | 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 | 49 | Chapter of world 9 the arena replaces (32–49; chapter 1 is the Test World's). |
 
 #### Test World