Customization

Table of Contents

RCCP's customization system lets players modify vehicles at runtime: paint color, wheels, spoilers, sirens, decals, neons, and performance upgrades. All customization is managed through the RCCP_Customizer component and its eight manager sub-components, with persistent save/load via PlayerPrefs and JSON serialization.

RCCP_Customizer Setup

Add the RCCP_Customizer component to your vehicle (it inherits from RCCP_Component). This is the central hub that coordinates all customization managers and handles save/load operations.

Key Properties

Property Type Default Description
saveFileName string Vehicle name Unique identifier for saving/loading this vehicle's customization. Auto-populated from the vehicle's GameObject name. Must be unique per vehicle if you want independent save slots.
autoInitialize bool true Automatically initializes all manager sub-components. Set to false for networked vehicles where you want to sync customization data manually.
autoLoadLoadout bool true Loads the last saved customization loadout on Awake.
autoSave bool true Automatically saves customization changes.
initializeMethod InitializeMethod Start Controls when managers are initialized. Options: Awake, OnEnable, Start, DelayedWithFixedUpdate.

Initialization Timing

The InitializeMethod enum controls when all upgrade managers are initialized:

Value When Use Case
Awake During Awake() When customization must be ready before other components.
OnEnable During OnEnable() When re-enabling a pooled vehicle.
Start During Start() Default. Suitable for most scenarios.
DelayedWithFixedUpdate After one FixedUpdate frame When other physics components need to initialize first.

Basic API

RCCP_Customizer customizer = vehicle.GetComponentInChildren<RCCP_Customizer>();

// Manually initialize all managers
customizer.Initialize();

// Save the current customization state
customizer.Save();

// Load previously saved customization
customizer.Load();

// Delete saved data and restore defaults
customizer.Delete();

// Hide/show all visual upgrades (spoilers, sirens, decals, neons)
customizer.HideAll();
customizer.ShowAll();

Manager Components

The customizer delegates work to eight specialized manager components. Each manager handles one category of customization and is found automatically via GetComponentInChildren.

Manager Visual Component Category
RCCP_VehicleUpgrade_PaintManager RCCP_VehicleUpgrade_Paint Vehicle body color
RCCP_VehicleUpgrade_WheelManager RCCP_VehicleUpgrade_Wheel Wheel model swapping
RCCP_VehicleUpgrade_SpoilerManager RCCP_VehicleUpgrade_Spoiler Rear spoilers
RCCP_VehicleUpgrade_SirenManager RCCP_VehicleUpgrade_Siren Police lights / sirens
RCCP_VehicleUpgrade_DecalManager RCCP_VehicleUpgrade_Decal Body decals
RCCP_VehicleUpgrade_NeonManager RCCP_VehicleUpgrade_Neon Underglow neons
RCCP_VehicleUpgrade_UpgradeManager (see Performance Upgrades) Engine, brake, handling, speed
RCCP_VehicleUpgrade_CustomizationManager (see Tuning Data) Suspension, transmission, aids

Paint System

Components: RCCP_VehicleUpgrade_PaintManager / RCCP_VehicleUpgrade_Paint

The paint system applies a color to the vehicle body materials at runtime. The selected color is stored in the loadout as a Color value (alpha of 0 means no paint has been applied).

Use RCCP_ColorPickerBySliders for a ready-made UI color picker with RGB sliders.

// Apply a custom paint color
RCCP_VehicleUpgrade_PaintManager paintManager = customizer.PaintManager;
if (paintManager != null)
    paintManager.Initialize();  // Applies the color stored in the loadout

Wheel Customization

Components: RCCP_VehicleUpgrade_WheelManager / RCCP_VehicleUpgrade_Wheel

Wheel customization swaps the visual wheel models on all axles at runtime. Available wheel presets are defined in the RCCP_ChangableWheels ScriptableObject located in Resources/.

Each preset in RCCP_ChangableWheels contains a wheel prefab. The wheel index stored in the loadout (-1 means no custom wheels applied) maps to this array.

To add new wheel options:

  1. Open RCCP_ChangableWheels from Tools > BoneCracker Games > Realistic Car Controller Pro > Configuration > Wheels.
  2. Add your wheel prefab to the list.
  3. The new wheel is immediately available for selection at runtime.

Spoiler System

Components: RCCP_VehicleUpgrade_SpoilerManager / RCCP_VehicleUpgrade_Spoiler

Add or swap spoiler prefabs on the vehicle. Each RCCP_VehicleUpgrade_Spoiler component represents one spoiler option. The manager tracks which spoiler is active by index (-1 means none).

Siren / Police Lights

Components: RCCP_VehicleUpgrade_SirenManager / RCCP_VehicleUpgrade_Siren

Adds police-style flashing lights and optional siren audio to the vehicle. Uses the RCCP_PoliceLights component for the light animation. The siren index (-1 means none) identifies which siren preset is active.

Decals

Components: RCCP_VehicleUpgrade_DecalManager / RCCP_VehicleUpgrade_Decal

Applies decal graphics to the vehicle body using Unity's DecalProjector component. Supports up to 4 decal slots: front, back, left, and right. Each slot has its own index in the loadout (-1 means no decal applied).

Important: Decals require URP or HDRP. The DecalProjector component is not available in the built-in render pipeline. If you are using the built-in pipeline, decals will not be visible. See Render Pipelines for pipeline setup instructions.

Neons

Components: RCCP_VehicleUpgrade_NeonManager / RCCP_VehicleUpgrade_Neon

Adds underglow lighting effects beneath the vehicle using DecalProjector. The neon index (-1 means none) identifies which neon preset is active.

Important: Like decals, neons require URP or HDRP. They will not work with the built-in render pipeline. See Render Pipelines for pipeline setup instructions.

Performance Upgrades

Component: RCCP_VehicleUpgrade_UpgradeManager

Performance upgrades modify the vehicle's driving characteristics. Four upgrade categories are available, each with its own level (starting at 0 for stock):

Upgrade Component Effect
Engine RCCP_VehicleUpgrade_Engine Increases maximum engine torque output
Brake RCCP_VehicleUpgrade_Brake Increases brake force for shorter stopping distances
Handling RCCP_VehicleUpgrade_Handling Improves suspension stiffness and steering response
Speed RCCP_VehicleUpgrade_Speed Increases maximum achievable speed

The RCCP_VehicleUpgrade_UpgradeManager tracks the current level for each category:

RCCP_VehicleUpgrade_UpgradeManager upgradeManager = customizer.UpgradeManager;
if (upgradeManager != null) {
    int engineLevel = upgradeManager.EngineLevel;
    int brakeLevel = upgradeManager.BrakeLevel;
    int handlingLevel = upgradeManager.HandlingLevel;
    int speedLevel = upgradeManager.SpeedLevel;
}

Tuning Data (RCCP_VehicleUpgrade_CustomizationManager)

Component: RCCP_VehicleUpgrade_CustomizationManager

This manager handles detailed vehicle tuning stored in RCCP_CustomizationData. Unlike the other upgrade categories that use simple level integers, this stores the full set of tunable parameters:

Suspension

Field Type Default Description
suspensionDistanceFront float 0.2 Front axle travel distance in meters
suspensionDistanceRear float 0.2 Rear axle travel distance in meters
suspensionSpringForceFront float 55000 Front spring force in Newtons
suspensionSpringForceRear float 55000 Rear spring force in Newtons
suspensionDamperFront float 3500 Front damper force
suspensionDamperRear float 3500 Rear damper force
suspensionTargetFront float 0.5 Front target position (0 = extended, 1 = compressed)
suspensionTargetRear float 0.5 Rear target position (0 = extended, 1 = compressed)

Camber and Transmission

Field Type Default Description
cambersFront float 0 Front wheel camber angle (-15 to 15 degrees)
cambersRear float 0 Rear wheel camber angle (-15 to 15 degrees)
gearShiftingThreshold float 0.8 Normalized RPM threshold for automatic gear shifts (0-1)
clutchThreshold float 0.1 Clutch engagement speed (0-1)

Stability Aids

Field Type Default Description
counterSteering bool true Automatic counter-steering for oversteer recovery
steeringLimiter bool true Limit steering angle based on vehicle speed
ABS bool false Anti-lock Braking System
ESP bool false Electronic Stability Program
TCS bool false Traction Control System
SH bool false Steering Helper (velocity-aligned steering correction)
NOS bool false Nitrous Oxide System
revLimiter bool false Engine rev limiter
automaticTransmission bool false Automatic transmission mode

Visual Settings

Field Type Default Description
headlightColor Color White Custom headlight color tint
wheelSmokeColor Color White Custom tire smoke particle color

Loadout System

All customization state is stored in an RCCP_CustomizationLoadout instance, a serializable class that serves as the single source of truth for a vehicle's customization.

Loadout Fields

Field Type Default Description
paint Color White (alpha 0) Vehicle body paint color. Alpha of 0 means no paint applied.
spoiler int -1 Equipped spoiler index. -1 means none.
siren int -1 Equipped siren index. -1 means none.
wheel int -1 Equipped wheel set index. -1 means none.
engineLevel int 0 Engine upgrade level. 0 is stock.
handlingLevel int 0 Handling upgrade level. 0 is stock.
brakeLevel int 0 Brake upgrade level. 0 is stock.
speedLevel int 0 Speed upgrade level. 0 is stock.
decalIndexFront int -1 Front decal index. -1 means none.
decalIndexBack int -1 Back decal index. -1 means none.
decalIndexLeft int -1 Left side decal index. -1 means none.
decalIndexRight int -1 Right side decal index. -1 means none.
neonIndex int -1 Neon underglow index. -1 means none.
customizationData RCCP_CustomizationData (defaults) Detailed tuning data (suspension, aids, transmission).

How Save / Load Works

The customizer uses PlayerPrefs with JSON serialization:

// Saving: serializes the loadout to JSON and stores it in PlayerPrefs
PlayerPrefs.SetString(saveFileName, JsonUtility.ToJson(loadout));

// Loading: reads JSON from PlayerPrefs and deserializes to a loadout
loadout = JsonUtility.FromJson<RCCP_CustomizationLoadout>(
    PlayerPrefs.GetString(saveFileName)
);

The saveFileName is the PlayerPrefs key. Each vehicle must have a unique saveFileName to avoid overwriting another vehicle's data.

Loadout Update Flow

When any manager component changes a value, it calls loadout.UpdateLoadout(component) which uses a type-switch to copy the relevant data:

Customization UI

RCCP provides ready-made UI prefabs for customization screens, managed through the RCCP_CustomizationSetups ScriptableObject (located in Resources/RCCP_CustomizationSetups.asset).

UI Prefab References

The RCCP_CustomizationSetups singleton holds references to UI prefabs for each category:

Field Description
paints Paint color selection UI panel
wheels Wheel selection UI panel
upgrades Performance upgrade UI panel
spoilers Spoiler selection UI panel
sirens Siren/police light UI panel
decals Decal selection UI panel
neons Neon underglow UI panel
customization Suspension and handling tuning UI panel

Key UI Components

Component Description
RCCP_UI_Customizer Main UI controller for the customization screen
RCCP_UI_CustomizationSlider Slider UI element for tuning parameters
RCCP_CustomizationTrigger Collider-based trigger zone that opens customization when the player drives in
RCCP_CustomizationStation Dedicated customization area with camera positioning
RCCP_ColorPickerBySliders RGB color picker with sliders for the paint system

Networking Considerations

For networked multiplayer vehicles:

  1. Set autoInitialize to false on remote vehicles.
  2. Sync the RCCP_CustomizationLoadout data across the network using your networking solution (Mirror, Photon, etc.).
  3. After receiving loadout data, call customizer.Initialize() manually to apply the customization.
  4. Do not use autoSave or autoLoadLoadout on remote vehicles since their state comes from the network, not from local PlayerPrefs.

Common Issues

Decals or neons not visible

Decals and neons use Unity's DecalProjector, which is only available in URP and HDRP. If you are using the built-in render pipeline, these features will not work. See Render Pipelines for migration instructions.

Loadout not saving or loading

Paint not applying

Wheels not changing

Customization not applied on spawn

Related Topics

Support: bonecrackergames@gmail.com | www.bonecrackergames.com

Need help? See Troubleshooting