Refnodes

Ref nodes are used to define the orientation and position of the car, as well as the position of the cameras. They consist in a set of 4 nodes that define a coordinate system, along with 2 nodes that define the front of the vehicle.

A single set of refnodes must be present on the vehicle at all times, meaning this should be part of your chassis or body jbeam. A vehicle with no refnodes will fail to spawn.

While refnodes do not need to be precisely centered in the vehicle, all refnodes excluding the corner nodes need to be perfectly aligned with each other in their respective direction, otherwise you might experience camera and/or spawning issues, like the vehicle spawning upside down. You might need to do some adjustements to your jbeam for this to be possible, and in some cases the addition of nodes that serve solely as refNodes might be required.

Required arguments

"refNodes":[
    ["ref:", "back:", "left:", "up:", "leftCorner:", "rightCorner:"]
    ["fr9", "fr10", "fr9l", "fr11", "f7ll", "f7rr"],
],
string
type
A node near the center and lowest point of the vehicle body
This node doesn’t need to be in the 0,0,0 position, but should be close to it.
string
type
A node directly behind the ref node (y axis)
string
type
A node directly left of the ref node (x axis)
string
type
A node directly above the ref node (z axis)
string
type
A node at the front left corner of the vehicle.
Used to trigger checkpoints.
string
type
A node at the front right corner of the vehicle.
Used to trigger checkpoints.
Last modified: May 6, 2024
On this page:

Any further questions?

Join our discord
Our documentation is currently incomplete and undergoing active development. If you have any questions or feedback, please visit this forum thread.