XR Movement

Category: Executor Tier: Pro

Purpose

XR analog of Motion3D — handles all player locomotion paradigms by moving/rotating the XROrigin3D.

Visual Reference

As added to your scene

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.

…

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