initial commit: llamamod 0.2.0 – reverse-engineered level formats (wad, map, trak, text, stpc), python tools and notes, java mod manager (iso install, mod pipeline with exe patching, save editor, wine/windows launcher) with mods (test world, debug wireframe, mirror, randomizer, fog, cheats, intro skip, practice, free camera, boot to level, level projects) and the 3d level editor (geometry, objects, cross-world import, environment, textures, play-test, manual)

docs/manual/tutorial-first-level.md

@@ -0,0 +1,76 @@
+# Tutorial: Your first level in 10 minutes
+
+In this tutorial you make a small level from scratch: a grass floor, a few blocks to climb, a
+coin trail and an exit – and you play it in the game. You need LlamaMod set up with your game
+([Installing LlamaMod](02-installing.md)).
+
+## Step 1: Create the level
+
+1. Start LlamaMod and click **Level Editor**.
+2. On the start page click **New level** (or **File → New level…**, **Ctrl+N**).
+3. Type a **Level name**, for example *My first level*.
+4. Leave the **Base level** at *Village – Chapter 1*: its objects (coins, checkpoints, the exit
+   door) are what you will place.
+5. Choose **Start with: Flat floor** and click **Create**.
+
+![The New level dialog](img/ui_dialog_new.jpg)
+
+The editor opens a 16×14 grass floor with a player start (the llama) and an exit door. The
+TestLevel chapter shown in the dialog is where your level will appear in the game.
+
+## Step 2: Look around
+
+* Hold the **right mouse button** and move the mouse to look around; add **W A S D** to fly.
+* Press **Home** to see the whole level, click the llama and press **F** to frame it.
+* Press **Numpad 7** for the top view and **Numpad 5** to get back.
+
+## Step 3: Add something to climb
+
+1. Press **B** for the **Brush** tool. In the options bar choose **Block**.
+2. Drag a 2×2 square on the floor next to the llama, move the mouse up until the status bar
+   shows a height of about 0.5, and click. You have a step.
+3. Choose **Platform** and draw a wider platform a bit further away, about 1.2 high.
+4. Choose **Ramp** and draw a ramp leading up to the platform – it rises in the direction you
+   drag.
+
+![Drawing a ramp](img/geo_draw.jpg)
+
+Click a brush with the **Select** tool (**Q**) to see its handles; drag a handle to resize it.
+Every change can be undone with **Ctrl+Z**.
+
+## Step 4: A coin trail
+
+1. Open the **Objects** panel (left) and click **Coin line** under the quick setups – or press
+   **O** for the **Coin line / arc** tool.
+2. Click once at the start of the trail and once at its end. Coins appear every *spacing* cells
+   on the ground (also up the ramp).
+
+## Step 5: Check the exit
+
+The template already has an exit: a **LevelDoor** standing on an **exit floor** (collision
+material 16). Press **C** to see collision colours – the exit floor has its own colour. If you
+want the exit somewhere else, select the door and its floor brush and move them together with
+the **Move** tool (**W**).
+
+## Step 6: Play it
+
+1. Press **F5**. The editor builds the level, installs it as a mod and starts the game directly
+   in it.
+2. Walk the llama up the ramp, collect the coins and step on the exit.
+3. Press **Escape** to come straight back to the editor.
+
+Want to test only the platform jump? Point the middle of the view at the platform and press
+**Shift+F5** – the llama starts right there.
+
+## Step 7: Save
+
+Press **Ctrl+S**. The project is saved in LlamaMod's `levels` folder and shows up as a mod in
+LlamaMod's **Levels** category. Send the `.llamalevel` file to a friend to let them play it –
+see [Sharing levels](17-sharing.md).
+
+## What next?
+
+* [Make a parkour](tutorial-parkour.md) – platforms, death floors, checkpoints.
+* [Building geometry](06-geometry.md) – all primitives, rotating, arrays and alignment.
+* [Objects](09-objects.md) – enemies, checkpoints, secrets and parameters.
+* [Environment](12-environment.md) – fog, music and light.