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

78 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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** tab in the left dock – the ⊙ icon right next to *Outliner* (inactive tabs show only
their icon) and click **Coin line** under **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.