Damage

•Before you start

Use a working RCCP vehicle in a test scene with a solid obstacle. Save the scene and stop Play Mode before setup.

Denting changes mesh vertices: the points that make up the model. The source model must allow Unity to read and write those points.

1. Enable damage

1. Select the vehicle root in the Hierarchy.
2. Find Features > Damage in the module cards.
3. Add it with + if missing, then click the card to open its Inspector.
4. Enable Collect parts automatically and Dent the bodywork.
5. Check Damage from layers includes the layer of your test obstacle.

Check: the Damage module is enabled and configured to collect the vehicle's parts.

The Setup Wizard can also add Damage from its Modules step.

Figure 01Open full size ↗

Open the screenshot at full size. 1 Enable automatic collection for this first setup; the example car shown uses manually assigned parts, so its box is unchecked. 2 Include your obstacle's layer. 3 Enable bodywork dents. The other values shown belong to this example car; you do not need to copy them or enable soft-body denting to follow this guide.

Turning damage on

If you want to choose exactly which objects can be damaged, turn off Collect parts automatically and fill the body, wheel, lamp and detachable-part lists. Get Meshes, Get Lights, Get Parts and Get Wheels can help populate them.

Use Include inactive GameObjects when parts that start inactive should be collected too.

2. Make the model readable

If the Setup Wizard already enabled Read/Write for your model, continue to the driving test.

Otherwise:

1. Select the original imported model in the Project window.
2. In its model import settings, enable Read/Write Enabled.
3. Click Apply and wait for the reimport.

Check: there are no unreadable-mesh warnings for the intended body panels in the Console.

This changes the model asset used by its instances and adds memory cost. A model that is not readable can still render, but its panels cannot be deformed by this system.

3. Test a dent and repair it

1. Press Play and drive into the test obstacle.
2. Stop the car and inspect the struck panel. A very light touch may be ignored.
3. Select the Damage module while still in Play Mode.
4. Click Repair Now near the bottom of its Inspector.
5. Wait for Repaired in Live values to become true.

Check: the crash changes the body shape and repair restores it. The repair button is a Play Mode control; it is disabled outside Play Mode.

Stop Play Mode before changing the saved setup.

•Controlling how bad the dents look

Start by changing one of these, then repeat the same impact:

The same impact can look different on models with different mesh detail. Increasing strength cannot add missing vertices to a very simple panel.

Dents that look flat or faceted

Recalculate normals updates the lighting after deformation. Preserve authored normals preserves authored shading away from the deformation, and Weld seam normals helps avoid unwanted hard seams.

Leave Keep bent panels visible enabled so the bounds used for visibility follow the deformed shape.

For crowded scenes, profile the cost of normal recalculation and the soft-body settings before increasing visual detail.

•Soft-body denting

Classic denting changes the panel shape immediately. Soft-body denting lets panels bend and wobble before settling, and supports animated repair.

To try it:

1. Stop Play Mode.
2. Enable Soft-body denting on the Damage component.
3. Open the added Deformation Solver and choose a Stiffness preset.
4. Repeat the impact-and-repair test.

Check: the panel moves after the hit and eventually settles. Confirm repair finishes before relying on it in gameplay.

Turn the feature off using its checkbox. Deleting the solver child while the feature remains on causes it to be recreated.

Preparing panels uses memory and processing time. Solver passes, Substeps and relighting affect cost; scene-wide deformation budgets live in RCCP Settings. Performance and Platforms and Field Reference cover those controls.

Do not assume a classic-denting strength change produces the same proportional response under soft-body denting; compare your own vehicle.

•Bumpers, hoods and doors that fall off

The panel must be a separate object in the vehicle hierarchy.

1. Select that panel.
2. Use Add Component > BoneCracker Games > Realistic Car Controller Pro > Misc > RCCP Detachable Part.
3. Set Part Type to its role.
4. On the Damage module, enable Damage the parts.
5. Test nearby impacts.

Check: the panel starts attached, can loosen or detach as configured, and returns on repair.

On Damage, Part damage reach sets how close the impact must be; Part damage strength scales the damage.

•Wheels knocked out of place

Enable Bend the wheels for impact displacement. Wheel damage reach and Wheel damage strength control how impacts affect them.

Wheels can come off allows detachment after sufficient damage. Spawn protection delays wheel detachment just after spawning; if wheels detach immediately, also check whether the starting car overlaps the ground or other objects.

•Broken lamps

Enable Break the lamps on Damage and Can be smashed on the individual lamps. Lamp damage reach and Lamp damage strength control the impact response.

Check: a hit near a breakable lamp can turn it off, and repair restores it. Lights explains the lamp setup.

•Knowing how wrecked the car is

Track damage by area records separate front, rear, left and right condition scores. These support the damage HUD and engine-related mechanical damage.

Tracking a score alone does not dent a panel or reduce power. The corresponding damage features must also be enabled.

•Making damage affect how the car drives

Enable Mechanical damage to add Damage Mechanics, then choose the effects you need.

Set Engine location to the correct end of the vehicle. Then test damage at that end.

Health to torque shapes power loss. Radiator and overheating controls set how damage builds into heat. Leak starts at and Time to go flat control tire leaks. For fire, keep Goes out above higher than Catches fire below to avoid rapid on/off changes.

Smoke and flames need the particle setup described in Surfaces and Effects. Recompute inertia on detach optionally recalculates weight distribution after detachments.

•Repairing a car

Repair Now restores body shape, wheel positions and attachment, tires, detachable parts, lamps and tracked area health. Mechanical repair clears its consequences, including fire.

Soft-body repair can take time unless configured as instant. In a script, use the public repair-status API instead of assuming the car is fully restored in the same frame; see Damage and repair API.

•Saving a damaged car

1. Give the vehicle a unique Save slot before running.
2. In Play Mode, damage it and click Save.
3. Repair it, then click Load.
4. Confirm the saved damage returns.

Check: the slot restores the saved condition. A healthier save can also reattach parts and reinflate tires. Delete removes that slot's saved damage.

These buttons store damage on the device. Give different persistent vehicles different slot names so they do not share the same damage record.

•If damage does not work

•Read next

• Lights — breakable lamps.
• Surfaces and Effects — sparks, smoke and fire.
• Field Reference — detailed damage and solver fields.

Back to the guide