Trail
A ribbon stroked behind this node's own movement: a dash streak, a thrown arc, a comet's tail, a swing's smear. Tapers head to tail width; by default it fades once stopped, or set a fixed length to keep a comet's shape while moving.
On this page
Add it
+ Add node → Trail creates a node with it already on. Already have a node for it? Add component → TrailComponent.
From a script
A script on the same node writes these fields by name. TrailComponent is the name to pass.
rgs
set_flag("TrailComponent", "emitting", true);
set_number("TrailComponent", "head_width", 10.0);
set_number("TrailComponent", "tail_width", 0.0);
set_colour("TrailComponent", "color", vec4(1.0, 1.0, 1.0, 1.0));
set_number("TrailComponent", "lifetime", 0.35);
set_number("TrailComponent", "max_length", 0.0);
set_number("TrailComponent", "min_distance", 8.0);
set_number("TrailComponent", "break_speed", 4000.0);Fields
| Field | Script name | Kind | Default | What it does |
|---|---|---|---|---|
| Emitting | emitting | checkbox | on | Whether new positions are being recorded. |
| Head Width | head_width | number, at least 0 | 10 | Stroke width at the node, in world units. |
| Tail Width | tail_width | number, at least 0 | 0 | Stroke width at the far end. |
| Color | color | colour | #ffffff | Colour of the ribbon. |
| Lifetime | lifetime | number, at least 0, step 0.05 | 0.35 s | How long a recorded position survives, in seconds. |
| Max Length | max_length | number, at least 0 | 0 u | How long the drawn ribbon may be, in world units. |
| Min Distance | min_distance | number, at least 0 | 8 u | How far the node must move before another position is recorded. |
| Break Speed | break_speed | number, at least 0 | 4000 u/s | Above this speed, a move is treated as a teleport and the ribbon breaks. |
| Sort Layer | layer | number | 0 | Lower draws first. |