Tutorials · Crypt Knight · Chapter 10

Levels

The Levels list

1. In your file manager, open the crypt-knight folder and make a folder in it called audio. Copy the music in, from where the list above says it is, under its own name.
2. Back in the editor, press Refresh in the bar of the Assets panel. audio appears.
3. Click the Levels tab, at the bottom right of the editor, beside Build. If it is not there, choose View → Panels → Levels. It says No levels yet.
4. Type The Gate into the box in the panel’s bar and press Add level. The new row names a scene for it, scenes/the_gate.ron, and warns that the file does not exist.
5. With the row selected, press Scene and choose gate.ron. The warning goes, and the row says startup: it is the scene the project opens on.
6. Open audio in Assets, and drag abandoned_castle_music_-_starninjas_6.ogg onto the Music button in the row’s lower line. The button names the file. The triangle beside it plays it.

A relic on an altar

1. Select ground, open the Tilemap tab, turn on Paint mode, and choose Brush. Under Layers, click back.
2. In the picker, hover until the tooltip reads #48, and click it. Click once inside cell (68, 8) and once inside cell (76, 8).
3. Pick #69, and click once inside cell (68, 9) and once inside cell (76, 9), under them.
4. Press Save at the top of the Tilemap panel.

1. Click the Viewport tab. Select Gate, press + Add node, choose Shape, and rename it relic. Set its Position to 1224 and 120.
2. In its Shape, set Kind to Circle, Size to 10 and 10, Anchor to 0.5 and 0.5, Outline to 0 and Color to 0.6, 0.85, 1.0 with an alpha of 1: a pale blue. Set its Sort Layer to 6.
3. Press Add component and choose AreaComponent. In its Shape, set Size to 16 and 48, and Offset to 0 and 16: a column that stands the knight’s height over the floor and takes in the circle above it. Leave its Layer and Mask as they are: it is on layer 0 and looks for layer 0, where the knight is.
4. Press Ctrl+S.

1. In Assets, press Create, choose New script, type relic, and press Enter.
2. In the Code tab’s Scripts list, click relic.rgs, replace everything in it with the script below, and press Ctrl+S.

/// A relic on an altar: it glows, and the knight takes it by walking into it.
/// Taking it keeps 1 under `power` for the rest of the game, and the relic is
/// gone.
component Relic : Area {
    /// The kept value that taking it sets to 1.
    power: String = "double_jump",

    fn on_create() {
        pulse_colour("ShapeComponent", "color", vec4(1.0, 1.0, 1.0, 0.4), 0.6, .InOutSine);
    }

    fn on_enter(other: NodeId) {
        if in_group(other, "knight") {
            keep_number(power, 1.0);
            // A hidden Area meets nothing, so it cannot be taken twice.
            hide();
        }
    }
}

1. Click the Viewport tab, select relic, press Add component, and choose Relic. Its Power is double_jump already, and stays.
2. Press Ctrl+S.

power

The name the relic keeps a 1 under. A string field, so one script serves every relic: chapter 11’s sword is another node with another power.

pulse_colour

Eases the Shape’s colour toward a see-through white and back, 0.6 seconds each way, for as long as the node exists: the glow. It is the pulse the knight’s blink uses in chapter 9, slow.

keep_number and hide

keep_number("double_jump", 1.0) keeps the 1 for the rest of the game: a kept value outlasts a change of scene, which is how the power carries from level to level. hide() hides the node, and a hidden node’s Area meets nothing, so the relic cannot be taken twice.

1. Right-click sign_walk in the Hierarchy and choose Duplicate. Rename the copy sign_air.
2. Set its Position to 1096 and 114, the Text of its World Text to You can jump once more in the air., and the Size of its Shape to 212 and 13.
3. Press Ctrl+S.

The knight jumps once more

/// The knight: runs where `move` points, jumps on `jump`, jumps lower when
/// `jump` is let go early, drops through a ledge when `down` is held as it
/// jumps, jumps once more in the air once the relic is taken, faces the way it
/// last moved, and shows the clip for what it is doing. It keeps where it last
/// stood on safe ground. A spike or a pit costs it a heart and puts it back
/// there; the hurt shakes the camera and blinks the knight, and nothing can
/// hurt it while it blinks. With no hearts left, the level is lost.

    fn loop() {
        // One more jump in the air once the relic is taken: double_jump is
        // kept as 0 or 1.
        set_number("CharacterBodyComponent", "air_jumps", kept_number("double_jump", 0.0));
        let x = direction("move").x;

The way out

1. In Assets, press Create, choose New script, type exit, and press Enter.
2. In the Code tab’s Scripts list, click exit.rgs, replace everything in it with the script below, and press Ctrl+S.

/// The way out of a level: walking into it wins the level.
component Exit : Area {
    fn on_enter(other: NodeId) {
        if in_group(other, "knight") {
            complete();
        }
    }
}

1. Click the Viewport tab. Select Gate, press + Add node, choose Shape, and rename it exit. Set its Position to 1584 and 160: the foot of the right wall’s inner face.
2. In its Shape, keep Kind on Rectangle, set Size to 20 and 36, Anchor to 0.5 and 1, Outline to 0, Color to 0.02, 0.02, 0.04 with an alpha of 1, and Sort Layer to 1.
3. Press Add component and choose AreaComponent. In its Shape, set Size to 24 and 36, and Offset to 0 and -18. Leave its Layer and Mask.
4. Press Add component again and choose Exit.
5. Press Ctrl+S.

What happens when a level ends

Check it works