llamamod/docs/manual/tutorial-first-level.md

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).

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 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.

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.

What next?

• Make a parkour – platforms, death floors, checkpoints.
• Building geometry – all primitives, rotating, arrays and alignment.
• Objects – enemies, checkpoints, secrets and parameters.
• Environment – fog, music and light.