The plugin will create and manage the connection between the Tilt Five hardware and one or more XR rigs it will create in your root scene. An XR rig is just a regular Godot scene with a specific layout of required nodes that map to parts of the Tilt Five hardware. Where and how each XR rig is created is controlled by a T5Manager node in the root scene.

The default XR rig T5XRRig is found in res://addons/tiltfive/scenes/ folder of your project.

The XR rig has the following required layout of

• T5XRRig is a Godot SubViewport node at the root node of the hierarchy. This is the viewport that your world will be rendered to for the pair of glasses attached to this rig.
• Origin is a T5Origin3D node that is a child of T5XRRig node. It maps the center of the Tilt Five gameboard to a location in world coordinates.
• Camera is a T5Camera3D node that is a child of the T5Origin3D node. It will track the location of the users head relative to the origin.
• Wand_1 is a T5Controller3D node that is also a child of the T5Origin3D node. It will track the location of the Tilt Five wand relative to the origin.

It's very likely that you will eventually want attach things like colliders, raycasters or custom scripts to the XR rig nodes for your particular Tilt Five application. You can do this by inheriting from T5XRRig.tcsn to get all the required nodes in the correct layout.

The main scene should have a T5Manager node. It is a basic manager that will create one XR rig for each pair of Tilt Five glasses that is connected to the computer. T5Manager has a couple of properties to customize it's behavior.

• Glasses Scene can be set to a custom XR rig to be used in place of the default T5XRRig.
• Start Location can be set to a T5Gameboard node in the scene. The manager will use this to set the initial location and content scaling of the T5Origin3D in the XR rig it creates. If this field is blank the manager will set the 'T5Origin3D' to the world origin.

The T5Gameboard node is useful for visualizing the size of 3D content on the physical gameboard.

The gameboard has several properties.

• Content Scale - The active area of an Tilt Five LE game board is 0.7m X 0.7m. Content scale maps this area into Godot units. A content scale of 1 means that Godot units match the physical units of the gameboard so it would map to a 0.7m X 0.7m area in Godot world coordinates. Setting content scale to 10 would map a 7m X 7m area.
• Gameboard Type - This sets the type of gameboard visualized in the scene.
• Show at Runtime - By default when the application is run the gameboard visualization will be hidden. However, when the application is setup to mirror the scene to the main display it might be desirable to visualize the gameboard in this view.
• Layers - In support of Show at Runtime this can be set to change the layers the gameboard is rendered to.

When the T5Gameboard node is linked in the T5Manager the manager will use the location and content scale of the gameboard to set up the T5Origin3D node of the XR rig. This can be useful for setting player start locations.