--- generated_by: gdlink-build generated_at: 2026-06-23T12:34:28Z do_not_edit: true title: XR Movement brick_type: executor tier: Pro generated: true --- # XR Movement **Category:** Executor **Tier:** Pro ## Purpose XR analog of Motion3D — handles all player locomotion paradigms by moving/rotating the XROrigin3D. ## Visual Reference ```{raw} html
As added to your scene
XR Movement brick as it appears in the GDLink editor
``` ## Runtime Behavior **Inputs** - **Activate** (Boolean): When true, apply movement. Joystick-driven modes read analog metadata from upstream XR Input Listener. **Properties** **Core (always visible)** - **movement_mode** (Enum, default `"Teleport"`): `Teleport`, `Smooth`, `Snap Turn`, `Continuous Turn`, `Climb`, `Fly` - **vignette_intensity** (Float, default `0.0`): Comfort tunnel-vision overlay intensity. 0 = disabled. - **vignette_threshold** (Float, default `0.2`, `visible_if: {vignette_intensity: "> 0"}`): Velocity threshold before vignette activates. **Teleport Mode (`visible_if: {movement_mode: "Teleport"}`)** - **fade_duration** (Float, default `0.2`): Fade-to-black transition time in seconds. - **offset_height** (Float, default `0.0`): Height offset above the hit point. - **max_slope** (Float, default `45.0`): Maximum surface angle in degrees (absorbed from demoted Teleport Gate). - **collision_mask** (Bitmask): Valid teleport surface layers (absorbed from demoted Teleport Gate). - **check_player_fit** (Bool, default `true`): Capsule cast to verify player fits at target (absorbed from demoted Teleport Gate). **Smooth / Fly Mode (`visible_if: {movement_mode: ["Smooth", "Fly"]}`)** - **speed** (Float, default `2.5`): Movement units per second. - **orientation** (Enum, default `"Hand"`): `Head`, `Hand` — determines forward direction. - **input_type** (Enum, default `"Joystick"`): `Joystick`, `Arm Swing` (godot-xr-tools jog/swing detection). - **sprint_multiplier** (Float, default `1.5`, `visible_if: {input_type: "Joystick"}`): Speed boost when sprint button held. ... ```{raw} html
Generated UI Mockup — showing expanded properties
XR Movement
-
x
Name:
Label this brick...
Mode:
Teleport
Vignette:
0.0
v
Vig Thresh:
0.2
v
Height Offset:
0.0
v
Input:
Joystick
Sprint:
1.5
v
Step (deg):
45.0
v
Turn Speed:
90.0
v
Fade (s)
0.2
v
Max Slope
45.0
v
Fit Check
Speed
2.5
v
Orient
Hand
Axis
Vertical
Sensitivity
1.0
v
``` ## Properties | Property | Type | Default | Notes | |---|---|---|---| | Mode | option | Teleport | Locomotion paradigm | | Vignette | float | 0.0 | Comfort tunnel-vision overlay (0 = disabled) | | Vig Thresh | float | 0.2 | Velocity threshold before vignette activates | | Fade (s) | float | 0.2 | Fade-to-black transition time | | Height Offset | float | 0.0 | Height offset above hit point | | Max Slope | float | 45.0 | Maximum surface angle in degrees | | Fit Check | bool | True | Capsule cast to verify player fits at target | | Speed | float | 2.5 | Movement units per second | | Orient | option | Hand | Forward direction source | | Input | option | Joystick | Movement input source | | Sprint | float | 1.5 | Speed boost when sprint held | | Step (deg) | float | 45.0 | Degrees per snap | | Turn Speed | float | 90.0 | Degrees per second | | Axis | option | Vertical | Which axes hand delta translates to | | Sensitivity | float | 1.0 | Multiplier on hand movement delta |