Drivable Vehicles

If you are new to the Creator Toolkit, make sure to check out following page to get your Unity editor setup!

Getting Started

This guide will show you how to set up a drivable vehicle that can be used in Spatial. This is to be used in conjunction with the Custom Prefab Object package type, which you can reference in the package configuration.

Importing a Vehicle Model & Requirements

• Import your vehicle model as an FBX file or .UnityPackage into your Unity project
• Currently supported: Grounded, 4 wheeled vehicles
• Each wheel needs to be a separate mesh/object within the model

Setting Up Your Vehicle (Grounded, 4-wheeled)

1. Change the Layer of your vehicle to Vehicles

2. Add Rigidbody component to the top level of your vehicle’s hierarchy
1. Make sure to add the Mass of your vehicle (in KG), as well as the Drag and Angular Drag values.
2. Leave Interpolate and Collision Detection as default
3. Place an empty GameObject for the driver seat position, and move it to the location where the driver will be seated (NOTE: do not add it as a Seat Hotspot)
1. Make sure it’s a child object of the vehicle

4. Add a Mesh or Box Collider to the vehicle’s body
5. Add a Center of Mass
1. Create an empty Game Object, rename it “Center of Mass”
2. Move the empty object to the approximate position of the Center of Mass of the vehicle
6. Add Wheel Colliders for each wheel (make sure you have a rigidbody on your vehicle first
1. Create a new empty Game Object called “Wheel Colliders” to place all the wheel colliders into
2. With Wheel Colliders, create a collider for each wheel
1. Create an empty Game Object
2. Add the Wheel Collider component to the Game Object
3. Give the colliders a consistent naming convention - for example “FR - Collider” for the Front Right wheel.
4. Move the collider so it’s perfectly centered on the wheel
5. Adjust the radius of the collider so it’s just visible around the wheel

Make sure to set the proper values of your Wheel Colliders’ properties specific to your vehicle. Learn more about Unity’s Wheel Collider Component here.

Ensure the wheel colliders and wheel meshes are facing the same orientation (Z+ forward orientation).


7. Add 2 Interactable components (no modifications or events for these Interactables needed)
• StartInteractable - this will be used to have an avatar enter and take control of a vehicle.
• StopInteractable - to exit the vehicle and return control back to the avatar.
• Ensure the StopInteractable component is disabled by default
8. Add a Variables component
1. To the top level vehicle object, add a Variables component
2. Open the Vehicle sample provided in the Starter Template, and copy it’s Variables component as shown below

3. Paste the Component values back in the Variables component of your vehicle

9. Assign your vehicle’s assets to the relevant Variables
• Driver Seat hotspot
• StartInteractable
• StopInteractable
• WheelColliders (in order: Front Left, Front Right, Rear Left, Rear Right) - rear wheels must be last two in the list
• Center of Mass
• CameraTarget - On web and mobile, the camera will focus on this point when you enter the vehicle.
• Wheel meshes (allWheelVisuals) - must be in same order as WheelColliders

10. Set values for other Variables
• maxDrive (Newton-Meters) - the maximum torque of the vehicle
• brakeForce (Newton-Meters) - the maximum brake force of the vehicle
• maxSteer - maximum angle that wheels turn (degrees)
11. Add a Script Machine component to your vehicle to the top level of your vehicle
• Open the sample Vehicle, and under it’s Script Machine click Edit Graph
• Ctrl/Cmd + A to select all the nodes, then Ctrl/Cmd+C to copy them
• Back on your Vehicle’s Script Machine, click new and save your Script. Then Edit Graph.
• Cmd/Ctrl + V to paste all the nodes

12. Add a Synced Object Component
1. Check Sync Transform
2. Under Synced Variables, enable the following variables to be Synced
1. isControlled
2. drive
3. steer
4. brake
5. isHonking


13. If publishing as an individual object that can be accessed from your Content menu, add the Prefab Object Component

Vehicle Sample - Golf Cart

👉

Click below to download the sample from the Samples page, bring it into your project and review how to properly set up your own drivable vehicle!

Samples & Examples

• Drivable Vehicles
• Importing a Vehicle Model & Requirements
• Setting Up Your Vehicle (Grounded, 4-wheeled)
• Vehicle Sample - Golf Cart