alligator arena minigame: walled pit in a testlevel chapter, waves of alligators with several lives (coins pop out on every hit, blink, back off), bites cost energy, exit opens after the last wave; options for lives, waves, energy, coins per hit and chapter

docs/manual/18-mods.md

@@ -59,6 +59,21 @@ not want with **Remove…**.
 
 ![Removing a level](img/levels_remove.jpg)
 
+## The Alligator Arena minigame
+
+The **Alligator Arena** mod (Levels) puts a small minigame on a TestLevel chapter (default 8):
+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
+coin counter. A bite costs you energy; with no energy left you get the game's usual
+*Continue* screen, which restarts the arena. After the last wave five bonus coins and sparkles
+appear on the purple pad at the north wall: step on it to finish the level. Unlock TestLevel on
+the **Save games** tab and pick the chapter on the world-9 map. The options set the alligators'
+lives, the number of waves, your energy (1–5) and the coins per hit. A level project or
+another mod on the same chapter stops the apply with a message – pick another chapter then.
+
+![Alligator Arena: two alligators, coins popping out](img/mod_arena.jpg)
+
 ## Command line
 
 LlamaMod can be scripted:
@@ -80,6 +95,20 @@ The following list is generated from the program, so it always matches your Llam
 <!-- generated:mods -->
 ### Levels mods
 
+#### Alligator Arena
+
+A minigame on a TestLevel chapter: alligators come in waves into a walled pit. Each kick or jump attack (jump, then Action) costs one of their lives and coins pop out; the bite costs your energy. Beat every wave and the exit pad opens. Unlock TestLevel on the Save games tab.
+
+*Id* `arena`
+
+| Option | Values | Default | Description |
+|---|---|---|---|
+| Alligator lives | 1 – 10 | 5 | Hits each alligator takes. |
+| 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. |
+
 #### Test World
 
 Turns the hidden TestLevel (world 9, chapter 1) into a playground island: a gallery of every character and object model of all worlds (standing still, grouped by world) and a parkour course with checkpoints. To reach it, click "Unlock TestLevel" on the Save games tab.