Tutorials · Crypt Knight · Chapter 8

Signs

The knight is noticed

1. Select knight. Under Groups, type knight and press Enter. The Hierarchy shows it as a tag beside his name.
2. Press Add component and choose AreaComponent.
3. Open its Shape, and set Size to 12 and 30 and Offset to 0 and -15: the same box as the body’s, standing on the node’s position, the knight’s feet. Leave Kind on Rectangle.
4. Click the Mask row, and untick the one layer it names, 0, so it reads Nothing. Leave the Area’s own Layer at 0.
5. Press Ctrl+S.

Layer and Mask

Which layer an Area is on, and which layers it looks for. A tablet looks for layer 0, which every Area is on until you say otherwise, so it notices the knight. The knight’s Area looks for none: it is noticed, and it never hears about a tablet, which it has no use for.

Pedestals for the tablets

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, the sixth tile of the third row, and click it. Click once inside each of the five cells in the first column of the table below.
3. Pick #69, the sixth tile of the fourth row, straight under it, and click once inside each of the five cells in the second column.
4. Press Save at the top of the Tilemap panel.

The sign’s script

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

/// A sign: its panel and words fade in while the knight is near, and out when
/// it leaves.
component Sign : Area {
    /// Seconds to fade in or out.
    #[suffix("s")]
    fade: f32 = 0.25,

    fn on_enter(other: NodeId) {
        if in_group(other, "knight") {
            anneal_colour("ShapeComponent", "color", vec4(0.05, 0.05, 0.08, 0.85), fade, .Linear);
            anneal_colour("WorldTextComponent", "color", vec4(1.0, 0.94, 0.8, 1.0), fade, .Linear);
            anneal_colour("WorldTextComponent", "outline", vec4(0.0, 0.0, 0.0, 1.0), fade, .Linear);
        }
    }

    fn on_exit(other: NodeId) {
        if in_group(other, "knight") {
            anneal_colour("ShapeComponent", "color", vec4(0.05, 0.05, 0.08, 0.0), fade, .Linear);
            anneal_colour("WorldTextComponent", "color", vec4(1.0, 0.94, 0.8, 0.0), fade, .Linear);
            anneal_colour("WorldTextComponent", "outline", vec4(0.0, 0.0, 0.0, 0.0), fade, .Linear);
        }
    }
}

component Sign : Area

A script with an Area base. The Area of the node it is on is the tablet’s trigger, and the script hears what that Area meets: on_enter when another Area comes into it, on_exit when it leaves, each with the other’s NodeId.

in_group

Whether the node other is in a group. The tablet fades only for the knight, which the group says he is. A skeleton walking by would not light it.

anneal_colour

Eases a colour field of one of this node’s components to a value over a time: here to the panel’s color, the words’ color and the words’ outline, over fade seconds, .Linear. In: a dark panel, 85% opaque, warm white words, a black outline. Out: the same colours, with their alpha at 0.

fade

A field, 0.25 seconds, which is a row in the Inspector. The /// line over it is its tooltip.

The first tablet

1. Select Gate, press + Add node, choose Shape, and rename it sign_walk. Set its Position to 88 and 114: the middle of its pedestal, in cell 5 across, and a little over it.
2. In its Shape, set Size to 92 and 13, Outline to 0 and Sort Layer to 8. Set Color to 0.05, 0.05, 0.08 with an alpha of 0: a dark panel you cannot see yet.
3. Press Add component and choose WorldTextComponent. Set Text to A / D to walk., Offset to 0 and 0, and Sort Layer to 9, over the panel.
4. Set its Color to 1, 0.94, 0.8 with an alpha of 0, and, in its Effects, its Outline to 0, 0, 0 with an alpha of 0.
5. Press Add component and choose AreaComponent. In its Shape, set Size to 48 and 56, and Offset to 0 and 18. Leave Layer and Mask as they are.
6. Press Add component and choose Sign, and keep its Fade at 0.25.
7. Press Ctrl+S.

The panel

A rectangle behind the words: the text’s width in pixels, six for each character, with a margin of eight, by 13 tall. Its Color has an alpha of 0 until the knight comes, and the script raises it.

The words

The built-in 5 by 9 pixel face, with a clear outline the script fills in. A sign’s Sort Layer is 9, one over its panel’s 8, and both are over the knight’s 5, so the words are not hidden by him.

The Area

A box 48 across and 56 tall, reaching from just above the panel down to the floor the pedestal stands on, so the knight is in it while he walks past, jumps beside it, or stands at its foot.

Four more

1. Right-click sign_walk in the Hierarchy and choose Duplicate. Rename the copy sign_jump, and set its Position, the Text of its World Text and the Size of its Shape from the table below.
2. Do the same for sign_high, sign_drop and sign_spikes.
3. For sign_spikes, also set the Area’s Offset to 0 and 23, and press Enter in its Text between the lines, so it reads on two.
4. Press Ctrl+S.

What comes next

Check it works