Node reference
All 11 Logic Nodes, by family. Every node also has the shared Comment, Start Enabled and Trace settings and the Enable and Disable inputs, described in How it works.
Trigger Volume
Triggers · LogicTriggerA box that fires when something walks into it or out of it. Use it for proximity doors, jump scares, music changes and checkpoints. The activator it passes on is whatever entered or left.
| Output | When it fires |
|---|---|
| On Trigger Enter | Something that matches Only Group entered the box. |
| On Trigger Exit | Something that matches Only Group left the box. |
| Setting | Default | What it does |
|---|---|---|
| Size | (2, 2, 2) | Width, height and depth of the box in meters, centered on the node. |
| Only Group | gln_player | Only react to bodies in this group. Leave empty to react to any body. |
| Collision Mask | layer 1 | Which physics layers it detects. |
| Volume Color | orange | Editor only: tint of the see-through box, so different triggers are easy to tell apart. Never shown in the game. |
Only physics bodies set it off, for example a CharacterBody3D or RigidBody3D, and only when they're on a layer in the Collision Mask and in the Only Group group. See Set up your player.
See it used: Proximity door, Delayed spike trap.
Interact Zone
Triggers · LogicInteractA box where the player presses a key to use something: a lever, a button, a door handle. It also fires on enter and exit, which is handy for showing and hiding a "Press E" prompt.
| Output | When it fires |
|---|---|
| On Interact | The interact key was pressed while someone matching Only Group was inside. Activator is whoever pressed it. |
| On Trigger Enter | Something that matches Only Group entered the box. |
| On Trigger Exit | Something that matches Only Group left the box. |
| Setting | Default | What it does |
|---|---|---|
| Action | gln_interact | The Input Map action that counts as interacting. The plugin adds gln_interact on E when it's enabled. |
| Size | (2, 2, 2) | Width, height and depth of the box in meters. |
| Only Group | gln_player | Only react to bodies in this group. Leave empty for any body. |
| Collision Mask | layer 1 | Which physics layers it detects. |
| Volume Color | orange | Editor only: tint of the see-through box. |
To use another key, change the action in Project Settings > Input Map, or point Action at one of your own. The node warns you if the action is missing.
When several bodies are inside at once, the zone only credits the first one. Fine for one player; see Limitations.
See it used: Door with a button, Elevator.
Move
Movers · LogicMoveSlides a node in a straight line between where you placed it (the start) and an offset from there (the end). Use it for sliding doors, elevators, platforms and gates.
| Input | What it does |
|---|---|
| Start | Start moving, or carry on after Stop. Resting at an end, it heads for the other end (in Loop mode, it jumps back to the start first). Ignored while it's already moving. |
| Go To End | Head for the end, turning back if it's on its way to the start. Already there or on its way: nothing happens. |
| Go To Start | Head for the start, turning back if it's on its way to the end. |
| Stop | Stop where it is. The next Start carries on in the same direction. |
| Output | When it fires |
|---|---|
| On Move Start | Began moving. |
| On Move End | Arrived at either end. |
| Setting | Default | What it does |
|---|---|---|
| Target | empty | The node to move. Empty moves this node and everything under it. |
| Move Offset | (0, 0, 0) | Where the end is, relative to the start, in meters. Drawn as a cyan line in the editor. |
| Space | Local | Local: along the target's parent's axes, so the move turns with its scene. Best for prefabs. World: along the world's axes, however the scene is turned. |
| Speed | 2 m/s | Meters per second. |
| Mode | Once | Once: each Start goes to the other end and stops. Ping Pong: back and forth until Stop. Loop: to the end, jump back to the start, repeat until Stop. |
| Auto Start | off | Start moving as soon as the scene starts, without an Auto node. Ignored while Start Enabled is off. |
Start or Go To? Use Start for a button that toggles something back and forth. Use Go To End and Go To Start when a pair of events drives it, like enter and exit, or a Branch's On True and On False. They always mean the same thing, so fast repeated presses can't leave it the wrong way round.
Platforms the player rides: make the moving body an AnimatableBody3D. A moving StaticBody3D slides out from under the player, and the node warns you about it.
See it used: Proximity door, Elevator, Patrolling platform.
Rotate
Movers · LogicRotateTurns a node between how you placed it and an offset in degrees. Use it for hinged doors, fans, levers and drawbridges.
| Input | What it does |
|---|---|
| Start | Start turning, or carry on after Stop. Resting at an end, it heads for the other end. Ignored while it's already turning. |
| Go To End | Head for the end, turning back if it's on its way to the start. |
| Go To Start | Head for the start, turning back if it's on its way to the end. |
| Stop | Stop where it is. The next Start carries on in the same direction. |
| Output | When it fires |
|---|---|
| On Rotate Start | Began turning. |
| On Rotate End | Arrived at either end. |
| Setting | Default | What it does |
|---|---|---|
| Target | empty | The node to turn. Empty turns this node and everything under it. |
| Rotate Offset | (0, 0, 0) | How far to turn, in degrees around X, Y and Z, measured on the target's parent's axes. A door swinging open is usually (0, 90, 0). |
| Speed | 90 °/s | Degrees per second. |
| Mode | Once | Once, Ping Pong or Loop, as in Move. A fan is Loop with an offset of (0, 360, 0). |
| Auto Start | off | Start turning as soon as the scene starts. Ignored while Start Enabled is off. |
The pivot is the Rotate node's position when the door is its child. For a hinged door, put the Rotate node on the hinge and the door under it. Because the axes are the parent's, a door that was already turned when you placed it still swings the way you'd expect.
See it used: Spinning fan, Three-switch gate.
Auto
Logic · LogicAutoFires once when the scene starts, after every other node is ready. Use it to kick off anything that should happen on load: lock a gate, start music, show a message.
| Output | When it fires |
|---|---|
| On Scene Start | The scene has started. Activator is always empty. |
| Setting | Default | What it does |
|---|---|---|
| Delay | 0 s | Extra seconds to wait after the scene is ready before firing. |
For a single Move or Rotate that should run from the start, ticking its Auto Start does the same job without an extra node.
See it used: Spinning fan.
Relay
Logic · LogicRelayPasses a signal on to everything wired to it, optionally after a delay. Use it to fan one event out to many targets, to add a pause in the middle of a chain, or to make something happen only the first time.
| Input | What it does |
|---|---|
| Trigger | Pass the signal on. |
| Cancel Pending | Drop any triggers still waiting on the delay. |
| Output | When it fires |
|---|---|
| On Trigger | Fires after Delay seconds. |
| Setting | Default | What it does |
|---|---|---|
| Delay | 0 s | Seconds to wait before firing. Adds to each connection's own Delay. |
| Fire Once | off | Only ever fire once. |
Every Trigger waits its own Delay, so three quick Triggers on a 1 s Relay fire three times, each a second after it arrived. Send Cancel Pending to drop the ones still waiting.
See it used: Delayed spike trap.
Timer
Logic · LogicTimerWaits a set time, then fires, once or on repeat. Use it for timed doors, countdowns and anything that should happen every few seconds. It pauses when the game is paused.
| Input | What it does |
|---|---|
| Start | Start counting. After Stop, carries on with the time that was left. Ignored if already running. |
| Stop | Pause and keep the time left. The next Start carries on from there. |
| Restart | Start again from the full Wait Time, whether running or not. |
| Output | When it fires |
|---|---|
| On Timeout | Wait Time ran out. Activator = whoever sent the last Start or Restart. |
| Setting | Default | What it does |
|---|---|---|
| Wait Time | 1 s | Seconds until On Timeout. |
| Repeat | off | Off: fire once and stop. On: fire every Wait Time until Stop. |
| Max Repeats | 0 | Only used when Repeat is on. 0 = forever; 3 = fire 3 times, then stop. |
See it used: Door that closes by itself.
Counter
Logic · LogicCounterCounts how many times something happened and fires when it reaches a goal. Use it for "hit three switches to open the gate" puzzles, or anything that should only happen on the Nth time.
| Input | What it does |
|---|---|
| Add | Count up by one. |
| Subtract | Count down by one. Never goes below 0, and does nothing at 0. |
| Reset | Go back to Start Count and start counting again. |
| Output | When it fires |
|---|---|
| On Count Change | The count went up, down or was reset. Handy for a click on each switch. |
| On Goal Reached | The count reached Goal. Activator = whoever sent the Add that reached it. |
| Setting | Default | What it does |
|---|---|---|
| Goal | 3 | Count needed to fire On Goal Reached. |
| Start Count | 0 | Count when the scene loads, and what Reset goes back to. |
| After Goal | Stop | Stop: ignores Add and Subtract until Reset, so it fires once per Reset. Reset: goes straight back to Start Count, so it fires again every Goal adds. Keep Counting: counts past Goal, and fires again only if the count drops below Goal and comes back up. |
See it used: Three pressure pads.
Branch
Logic · LogicBranchRemembers one yes/no fact about the level, like "the power is on", and sends an event one of two ways depending on it. Setting the value and checking it are separate inputs, so one part of the level can flip the switch and another can ask about it later.
| Input | What it does |
|---|---|
| Set True | The value becomes true. |
| Set False | The value becomes false. |
| Toggle | Flip the value. |
| Check | Fire On True or On False for the value right now. Doesn't change the value. |
| Output | When it fires |
|---|---|
| On True | Check was sent and the value is true. |
| On False | Check was sent and the value is false. |
| On Value Change | The value changed (by Set True, Set False or Toggle). Setting it to the value it already has fires nothing. |
| Setting | Default | What it does |
|---|---|---|
| Start Value | off (false) | The value when the scene loads. |
| Check On Change | off | Every change also runs Check, so On True and On False fire right away. Use this when something should always show the current value, like a light or a panel. |
The value resets to Start Value every time the scene loads. It isn't saved between play sessions.
See it used: Door that needs power, Three-switch gate.
Audio Clip
Feedback · LogicAudioClipPlays a sound from logic. With Loop off it plays once per Play (a door creak, a click). With Loop on it repeats until Stop (an ambient hum, music).
| Input | What it does |
|---|---|
| Play | Play from the start. With Loop on, it then repeats until Stop. |
| Stop | Stop the sound. Doesn't fire On Audio End. |
| Output | When it fires |
|---|---|
| On Audio Start | Play started the sound. |
| On Audio End | A one-shot sound reached its end. Never fires with Loop on. |
| Setting | Default | What it does |
|---|---|---|
| Stream | empty | The sound file (.wav, .ogg or .mp3). |
| Loop | off | Off: plays once per Play. On: repeats until Stop. Overrides the file's own Loop import setting, without changing the file. |
| Volume Db | -12 dB | Loudness. 0 = the file's own level; every -6 is about half as loud. |
| Pitch Variation | 0 | Each Play picks a random pitch within ± this amount, so repeated sounds don't feel robotic. |
| Positional | on | On: the sound comes from this node's spot and fades with distance. Off: same volume everywhere (music, announcements). |
| Max Distance | 30 m | Positional only. Beyond this the sound can't be heard. 0 = no limit. |
| Polyphony | 1 | How many copies can play at once. 1 = Play restarts the sound. |
| Bus | Master | The audio bus it plays on, for separate SFX and Music volume. |
For a different sound each time (footsteps, impacts), put an AudioStreamRandomizer in Stream. Place a positional Audio Clip where the sound should come from, for example at the door it belongs to.
See it used: Door that needs power.
Debug
Feedback · LogicDebugShows a short message on the game screen when something reaches it, then passes the event on. Drop it into the middle of a chain to see what fired while you play. Repeated messages stack into one line with a count (×3).
| Input | What it does |
|---|---|
| Trigger | Show the message, then fire On Show. |
| Output | When it fires |
|---|---|
| On Show | The message was shown. Also fires in a release build, where nothing is shown, so the chain keeps working. |
| Setting | Default | What it does |
|---|---|---|
| Message | Debug | The text to show. Empty shows the node's name. |
| Color | yellow | Text color, so different checkpoints are easy to tell apart. |
| Duration | 3 s | Seconds the line stays on screen before it fades. |
| Show Activator | off | Adds who set it off, e.g. "Gate open (Player)". |
| Print To Console | off | Also print the line to the Output panel. |
| Debug Builds Only | on | Show and print nothing in an exported release game. |
You don't need to add anything else to your scene; the on-screen list creates itself the first time a Debug node fires. For a complete log of every input and output instead, turn on Trace.
See it used: Seeing what your logic does.