llama coaster: ride the catacombs coaster cart on a new track (loop or grand circuit with drops, climbs, boosts, spin pads and jumps), 1-3 laps, three speeds, coins; offline cart simulation checks every jump and climb; roller coaster chapter in the strats docs

docs/manual/18-mods.md

@@ -74,6 +74,21 @@ another mod on the same chapter stops the apply with a message – pick another
 
 ![Alligator Arena: two alligators, coins popping out](img/mod_arena.jpg)
 
+## The Llama Coaster ride
+
+The **Llama Coaster** mod (Levels) puts a roller-coaster ride on a TestLevel chapter (32–49,
+default 48). You ride the cart from the Catacombs coaster levels: it leaves the station by itself,
+races down drops and up climbs, speeds up on the boost arrows, jumps over a gap and turns round on
+the spin pad. Press **Left** and **Right** to move the cart across the track and collect the
+coins. After the last lap the cart stops at the station, fireworks go off and the tally appears;
+**Enter** rides again, and *Beenden und zur Auswahlkarte wechseln* in the Esc menu goes back to the
+map. The options pick the track (*Loop* or the longer *Grand circuit*), the laps (1–3), the speed
+and whether there are coins. Unlock TestLevel on the **Save games** tab and pick the chapter on the
+world-9 map. A level project or another mod on the same chapter stops the apply with a message –
+pick another chapter then.
+
+![Llama Coaster: boost arrows on the Grand circuit](img/mod_coaster.jpg)
+
 ## Command line
 
 LlamaMod can be scripted:
@@ -109,6 +124,20 @@ A minigame on a TestLevel chapter: alligators come in waves into a walled pit. E
 | Coins per hit | 0 – 5 | 1 | Coins that pop out per hit (5 more at the end). |
 | TestLevel chapter | 32 – 49 | 49 | Chapter of world 9 the arena replaces (32–49; chapter 1 is the Test World's). |
 
+#### Llama Coaster
+
+A roller coaster ride on a TestLevel chapter, with the cart from the Catacombs coaster levels: drops, climbs, boost arrows, a spin pad that turns the cart backwards and a jump over a gap. Steer left and right to stay on the track and collect coins; the ride ends at the station. Unlock TestLevel on the Save games tab.
+
+*Id* `coaster`
+
+| Option | Values | Default | Description |
+|---|---|---|---|
+| Track | Loop, Grand circuit | Loop | Short loop (about 100 units) or the grand circuit (about 150 units, two jumps, two spins). |
+| Laps | 1 – 3 | 2 | Laps before the ride stops at the station. |
+| Speed | Slow, Normal (as in the game), Fast | Normal (as in the game) | Cruise speed and boost strength of the cart. |
+| Coins | on / off | on | Coins along the track. |
+| TestLevel chapter | 32 – 49 | 48 | Chapter of world 9 the coaster replaces (32–49; chapter 1 is the Test World's, 49 the arena's). |
+
 #### 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.