Skip to content

Configuring a new vehicle model

Cat Plus Plus edited this page Oct 1, 2021 · 10 revisions

Creating a new vehicle blueprint

As the initial step, please duplicate one of the existing car blueprints in the XVPDemo project or the XVP plugin content. That will allow you to start with a complete set of required components and links between them. In the next steps, you can focus on replacing the 3D model and aligning collision components to the vehicle body.

Placing the 3D model

  1. Add a model body wrapper as an empty scene component - it should be at [0,0,0] position

  1. Each wheel model Z-position has to be 0
  2. Wheels should be symmetrical on X and Y axes for easier configuration

Configuring the main body collision wrapper

  1. Add a box collision as a body collision wrapper
  2. The body collision wrapper should have [0,0,0] position and rotation
  3. The body collision wrapper usually is not used for collision, so its collision box extent should be [0,0,0]

Configuring the child element collision

  1. Add body collision components as children of the body collision wrapper
  2. Place collision shapes to cover the geometry of the vehicle

  1. Add collision components with mass to configure the mass distribution

Configuring the wheel collision

  1. For each wheel add a corresponding sphere collision component
  2. The wheel collision has to be at exact position of the wheel model
  3. Radius of the wheel collision should be the half of the wheel width

Configuring the axle hierarchy

  1. For each axle add an empty scene component as the axle wrapper. Set Y and Z positions to 0. The body wrapper must be the parent.

  1. Add an axle wrapper name to "Axle Scene Name" in the corresponding "XvpWheelPresentationState"

Configuring the wheel 3D model

  1. For each axle add an empty component (a wheel wrapper) with X and Z position at 0, Y should be at the wheel-axle connection (not at the wheel model center), where the axle wrapper is the parent

  1. Add the wheel model as child of the wheel wrapper

  1. Add the wheel wrapper name to "Wheel Scene Name" in appriopriate "XvpWheelPresentationState"

Configuring the brake pad 3D model

  1. Add brake pad models the same way as the wheels, next to them in hierarchy. Add an empty scene component (a brake pad wrapper) with X and z position at 0. Y position should be at the wheel-axle connection (not at the wheel mesh center). The axle wrapper must be the parent.

  1. Add a brake pad model as child of the brake wrapper

  1. Add the brake pad name and the wheel identifier to "Chassis Wheel Hub Names" in "XvpChassisPresentationConfig"

Clone this wiki locally