---
generated_by: gdlink-build
generated_at: 2026-06-23T12:34:28Z
do_not_edit: true
title: Variable
brick_type: executor
tier: Basic
generated: true
---

# Variable

**Category:** Executor
**Tier:** Basic

## Purpose

Writes values into Local or Global variables, supports gameplay text-buffer flows with optional mask formatting, supports direct vector/array edits, and can sample native physics data directly into a variable without a GDScript bridge.

## Visual Reference

```{raw} html
<div class="illustration-container"><div class="illustration-box"><div class="box-header">As added to your scene</div><img src="https://gdlink.solventech.ca/guide/assets/images/bricks/variable_executor.png" alt="Variable brick as it appears in the GDLink editor" loading="lazy" style="max-width:100%;height:auto;display:block;margin:0 auto;border-radius:8px;" /></div></div>
```

```{raw} html
<div class="illustration-container">
        <div class="illustration-box">
            <div class="box-header">Generated UI Mockup — showing expanded properties</div>
            <div class="real-node brick-executor">
                <div class="real-header">
                    <div class="real-title"><span class="brick-icon-fallback"></span> <span>Variable</span></div>
                    <div class="real-controls"><div class="real-checkbox"></div><div class="real-btn">-</div><div class="real-btn">x</div></div>
                </div>
                <div class="real-inner-panel"><div class="real-row name-row" style="position:relative;"><span class="real-label">Name:</span><div class="real-input" style="color:#666; font-style:italic;">Label this brick...</div><div class="real-port" style="left:-15px;"></div></div><div class="real-row"><span class="real-label">Scope:</span><div class="real-input-dropdown">Global</div></div><div class="real-row"><span class="real-label">Field:</span><div class="real-input-dropdown"></div></div><div class="real-row"><span class="real-label">Test:</span><div class="real-input-dropdown">Equal</div></div><div class="real-row"><span class="real-label" style="width: auto; padding-right:8px;">Value:</span><div class="real-input" style="justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div><div class="real-row"><span class="real-label">Min:</span><div class="real-inline-input" style="border-bottom: 1px solid #2f333b;"><span>0.0</span></div><div class="real-val-btn" style="margin-left:4px;">v</div></div><div class="real-row"><span class="real-label">Max:</span><div class="real-inline-input" style="border-bottom: 1px solid #2f333b;"><span>0.0</span></div><div class="real-val-btn" style="margin-left:4px;">v</div></div></div>
            </div>
        </div>
    </div>
```

## Properties

| Property | Type | Default | Notes |
|---|---|---|---|
| Scope | option | Global | Global: Check shared variables. Local: Check this node's variables |
| Var Name | variable_name |  | Variable to check (Timer dicts and the reserved Global '_system_time' supported) |
| Field | option |  | Optional Dictionary/Transform subfield. Timer dicts: elapsed/remaining/etc. _system_time: formatted/hms/hm/hour/minute/second/etc. Transform2D/3D: position/rotation/scale/origin/basis axes. |
| Test | option | Equal | Type of comparison to perform |
| Value | string |  | Value to compare against |
| Min | float | 0.0 | In Range: lower bound (inclusive) |
| Max | float | 0.0 | In Range: upper bound (inclusive) |

## Notes

- Empty `target_node` means "sample the owner node"
- `1 Godot unit = 1 meter`, so the stored magnitude is meters per second
- This executor stores the raw sampled number only; unit conversion and smoothing belong in `Math`
- Mask formatting is deterministic and separator-driven; it is intentionally not a general-purpose template language
- Local and Global variable panels parse Array values with Godot Variant syntax first, preserving integer values instead of coercing all numbers to floats.