A spatial node representing a spatially tracked controller.
    public class ARVRController : Spatial

This is a helper spatial node that is linked to the tracking of controllers. It also offers several handy pass throughs to the state of buttons and such on the controllers.

Controllers are linked by their id. You can create controller nodes before the controllers are available. Say your game always uses two controllers (one for each hand) you can predefine the controllers with id 1 and 2 and they will become active as soon as the controllers are identified. If you expect additional controllers to be used you should react to the signals and add ARVRController nodes to your scene.

The position of the controller node is automatically updated by the ARVR Server. This makes this node ideal to add child nodes to visualise the controller.

Inheritance Chain


    public ARVRController()


    "button_pressed" (int button)

Emitted when a button on this controller is pressed.

    "button_release" (int button)

Emitted when a button on this controller is released.


    public int ControllerId { get; set; }

The controller’s id.

A controller id of 0 is unbound and will always result in an inactive node. Controller id 1 is reserved for the first controller that identifies itself as the left hand controller and id 2 is reserved for the first controller that identifies itself as the right hand controller.

For any other controller that the ARVRServer detects we continue with controller id 3.

When a controller is turned off, its slot is freed. This ensures controllers will keep the same id even when controllers with lower ids are turned off.

    public float Rumble { get; set; }

The degree to which the tracker rumbles. Ranges from 0.0 to 1.0 with precision .01. If changed, updates ARVRPositionalTracker.Rumble accordingly.


    public int GetControllerId()

Getter for ControllerId

    public string GetControllerName()

If active, returns the name of the associated controller if provided by the AR/VR SDK used.

    public ARVRPositionalTracker.TrackerHand GetHand()

Returns the hand holding this controller, if known. See TRACKER_* constants in ARVRPositionalTracker.

    public bool GetIsActive()

Returns true if the bound controller is active. ARVR systems attempt to track active controllers.

    public float GetJoystickAxis(int axis)

Returns the value of the given axis for things like triggers, touchpads, etc. that are embedded into the controller.

    public int GetJoystickId()

Returns the ID of the joystick object bound to this. Every controller tracked by the ARVR Server that has buttons and axis will also be registered as a joystick within Godot. This means that all the normal joystick tracking and input mapping will work for buttons and axis found on the AR/VR controllers. This ID is purely offered as information so you can link up the controller with its joystick entry.

    public float GetRumble()

Getter for Rumble

    public int IsButtonPressed(int button)

Returns true if the button at index button is pressed.

    public void SetControllerId(int controllerId)

Setter for ControllerId

    public void SetRumble(float rumble)

Setter for Rumble