Optional modules

01Before you start

Use a vehicle that you can drive. Stop Play Mode before you add a module.

Most modules on this page are module cards. Select the vehicle root to see the cards. Click + on a dim card to add that module. Click an installed card to select the module. Vehicle Setup explains the cards.

For the full list of settings, see Field Reference.

02NOS

NOS gives the engine a short torque boost while the player holds the nitrous input. The tank empties during the boost. After a delay, the tank refills.

1. Select the vehicle root.
2. In the Features group, click + on the NOS card.
3. Click the NOS card to select the module.
4. Set the values in the Boost and Refill sections.

Check: press Play. Hold the throttle and the nitrous input. The vehicle accelerates faster, and Tank level decreases.

The boost fires only when all these conditions are true:

• The nitrous input is at least half pressed.
• The throttle is at least half pressed.
• The engine runs.
• The tank is not empty.

Controls lists the nitrous key and button.

03Fuel tank

The fuel tank uses fuel while the engine runs. When the tank is empty, the module can stop the engine.

1. Select the vehicle root.
2. In the Features group, click + on the Fuel Tank card.
3. Click the Fuel Tank card to select the module.
4. Set the values in the Tank and Consumption sections.

Check: press Play and drive. Burning now shows the fuel use. The fuel readout on the dashboard decreases. See UI and HUD.

The fuel use changes from Idle consumption to Full-throttle consumption with the throttle and the engine RPM.

NOTE: In Play Mode, Tank capacity shows the fuel that remains, and Starting fill shows how full the tank is.

To refill the tank from a script, call Refill() on the fuel tank component. API Reference lists the fuel-empty event.

04Trailer

A vehicle tows a trailer through two hitch triggers. One trigger is on the rear of the vehicle. The other trigger is on the front of the trailer. When the two triggers touch, the trailer hitches.

Prepare the towing vehicle:

1. Select the vehicle root.
2. In the Features group, click + on the Trailer card.
3. Click the Trailer card to select the hitch trigger.
4. Move the hitch trigger to the hitch point at the rear of the vehicle.
5. Make sure that the hitch trigger has a Box Collider with Is Trigger enabled.

Prepare the trailer:

1. Put the trailer model in the scene and select its root object.
2. Click Add Component and select BoneCracker Games > Realistic Car Controller Pro 2 > Misc > RCCP Trailer Controller.
3. Add a Unity WheelCollider for each trailer wheel.
4. Add one entry to Trailer wheels for each wheel. Assign the WheelCollider and the wheel model of that wheel.
5. Move the Center of mass point low and between the axles.
6. Move the hitch trigger of the trailer and the Hitch point to the front of the trailer. The joint connects at the Hitch point.
7. If the trailer has support legs, assign them to Support legs.

The trailer component adds a Rigidbody and a Configurable Joint. The component also creates the center of mass point, the hitch trigger and the Hitch point.

Check: press Play. Reverse the vehicle until the two hitch triggers touch. The trailer hitches and the support legs disappear. Press the detach trailer input to release the trailer. Controls lists the key.

After a detach, the trailer cannot hitch again for 1 second. The detach input works only on a vehicle that the player controls. Lamps on the trailer follow the lights of the towing vehicle while the trailer is hitched.

05Body tilt

Body tilt leans the visible body in corners and under braking. The effect is visual only. The physics and the colliders do not change.

The Body Tilt card shows its name in red because the module is experimental.

1. Select the vehicle root.
2. In the Behavior group, click + on the Body Tilt card.
3. Click the Body Tilt card to select the module.
4. In Parts that lean, select the body parts that lean.

Check: press Play and drive through a corner. The selected parts lean, and the wheels stay in position.

The module skips a part that holds the wheel colliders or the center of mass. A warning shows the skipped parts. After you select a part, the editor also adds the Lights, Customizer and Exhausts modules to the list. The sideways lean decreases during a sideways slide and below 1 m/s.

NOTE: The module reads Parts that lean when the vehicle starts. In Play Mode, the list is read-only.

06Wheel blur

Wheel blur shows a blurred wheel mesh over each wheel. The blur increases as the wheel turns faster.

1. Select the vehicle root.
2. In the Presentation group, click + on the Wheel Blur card.
3. Click the Wheel Blur card to select the module.
4. Click Create New Material. The editor saves a new material as Assets/<root object name>_WheelBlur.mat.
5. Click Toggle to show the blur meshes in the Scene view.
6. Adjust Offset and Scale until each blur mesh covers its wheel.
7. Click Toggle again to remove the preview.

Use a separate material for each vehicle. Each Create New Material click makes a new material asset. Render Pipelines explains the shader for each pipeline.

Check: press Play and accelerate. The blur appears as the wheels spin up.

LOD disables wheel blur on distant vehicles. See Performance and Platforms.

07Fake shadow

Fake shadow draws a soft dark quad under the body and a contact spot under each wheel. The effect changes no vehicle physics.

1. Select the vehicle root.
2. In the Presentation group, click + on the Fake Shadow card.
3. Click the Fake Shadow card to select the module.
4. Adjust Strength, Softness, Width Scale and Length Scale to match the body.
5. Set Ground Mask to include the road layers.
6. Optional: to use your own material, assign it to Shadow Material. The material must use the BoneCracker Games/RCCP/Fake Shadow shader. RCCP Settings already holds the default material.

The card adds the module below RCCP_OtherAddons. The module measures the body renderers and excludes wheel renderers. The soft edge centers on the body outline.

The multiply shader darkens the road. Built-in and URP need no renderer feature, decal projector or depth texture.

The module uses Shadow Material first, then Fake Shadow Material in RCCP Settings. The settings reference keeps the shader in a build. If both slots are empty, the module uses Shader.Find, which can fail in a build.

If realtime shadows are enabled, decrease Strength because the two shadows stack.

Check: press Play and drive. The shadow follows the body, fades during jumps, and disappears beyond Cull Distance Meters. Each wheel spot fades when that wheel leaves the ground.

After runtime changes to the body, the wheels or the shadow shape, call Rebuild() on the module. The next frame measures the vehicle again. See API Reference.

08Exhausts

The Exhausts module holds the exhaust tips of the vehicle. Each tip makes smoke, backfire flames, a pop sound, a flash of light and a camera shake.

1. Select the vehicle root.
2. In the Presentation group, click + on the Exhausts card.
3. Click the Exhausts card to select the module.
4. Click Create Exhaust. The new tip appears 2 m behind the module and is selected.
5. Move the tip to the end of the exhaust pipe.
6. For a second pipe, click Duplicate To Other Side on the tip.

Check: press Play. Increase the engine RPM to between 5000 rpm and 5500 rpm. Then release the throttle. A flame pops at the tip.

All settings are on each tip. The defaults in this table are the values of a tip that Create Exhaust adds.

Pop on engine braking needs Engine braking on the engine. If Engine braking is off, a throttle release never makes a pop, and the tip Inspector shows a warning. Pop on launch control has an effect only when Launch control is on for the engine.

09Interior

The Interior module turns the interior steering wheel and the dashboard needles. The module also operates the interior lights.

1. Select the vehicle root.
2. In the Presentation group, click + on the Interior card.
3. Click the Interior card to select the module.
4. Drag the interior steering wheel model into Steering Wheel.
5. Set Steering Wheel Rotate Around to the local axis of the steering wheel.
6. In the RPM dial and in Speed Dial, drag the needle object into Dial.
7. Add the cabin lights to Interior Lights.

Check: press Play. Steer and accelerate. The steering wheel turns and the needles move. When the low beams are on, the interior lights are on.

10Brake calipers

A brake caliper component keeps a caliper model on its wheel. The caliper follows the suspension travel, the steering, the camber and the caster of the wheel. The caliper does not spin with the wheel.

1. Select the caliper object.
2. Click Add Component and select BoneCracker Games > Realistic Car Controller Pro 2 > Misc > RCCP Visual Brake Caliper.
3. Drag the wheel collider object of that wheel into Wheel Collider.
4. Do steps 1 to 3 again for each caliper.

Check: press Play, steer and drive. Each caliper stays on its brake disc and does not spin.

11Police lights

The police lights component flashes red and blue light groups. The component can also rotate reflectors behind steady bulbs.

1. Select the lightbar object of the vehicle.
2. Click Add Component and select BoneCracker Games > Realistic Car Controller Pro 2 > Misc > RCCP Police Lights.
3. Drag the red Light components into Red Lights and the blue Light components into Blue Lights.
4. Drag the bulb renderers into Red Bulbs and Blue Bulbs. Enable emission on their materials.
5. For a rotating lightbar, assign Rotating Reflectors, White Lights and White Bulbs.
6. Set Siren Mode to On.

Check: press Play. The red and blue groups flash in turn. With reflectors, the reflectors rotate and the bulbs stay on.

If Rotating Reflectors is empty, the red and blue groups give alternating double flashes. Reflectors rotate around their local Y axis.

No default input switches the police lights. To switch them from a script, call SetSiren(true) or SetSiren(false) on the component. To add a lightbar as a selectable siren, see Customization and Upgrades.

12Related pages

• Vehicle Setup — the module cards.
• Controls — the nitrous and trailer keys.
• UI and HUD — the fuel and nitrous readouts.
• Lights — headlights and the low beams.
• Surfaces and Effects — smoke and other effects.
• Field Reference — every setting of these modules.

Back to the guide