Installation

This chapter walks you through installing RCCP Tuner, explains what the automatic installer does, and shows you how to confirm everything is ready before you open the demo.

System Requirements

Unity Version

RCCP Tuner requires Unity 6000.0 or newer - the same requirement as Realistic Car Controller Pro itself.

Realistic Car Controller Pro (Required)

RCCP Tuner is an add-on for Realistic Car Controller Pro (RCCP). It drives RCCP's own customization component (RCCP_Customizer), which sits as a child object on each RCCP vehicle prefab - so RCCP must already be in the project. Without it, the Tuner deliberately does not activate.

RCCP Tuner requires RCCP V3.0.0 or newer. An older RCCP is detected and refused rather than half-compiled, because building the Tuner's RCCP-facing code against an older API would break the whole editor, not just the Tuner.

A full copy of RCCP ships inside the Tuner. The bundled installer is Assets/RCCP Tuner/Installer/RCCP_Pro_V3.0.0.unitypackage. If RCCP is missing when the Tuner first loads, it offers to import that package for you, and you can run the same import at any time from Tools > BoneCracker Games > RCCP Tuner > Setup > Install Bundled Realistic Car Controller Pro.

If you already own RCCP on the Asset Store, import and update it yourself through the Package Manager instead. The bundled copy is a convenience, not the canonical source, and installing it overwrites the RCCP files already in your project.

If the Tuner loads into a project with no RCCP at all, nothing breaks. You get one console warning per editor session:

[RCCP Tuner] Realistic Car Controller Pro was not detected. RCCP Tuner
includes RCCP — use 'Tools > BoneCracker Games > RCCP Tuner > Setup >
Install Bundled Realistic Car Controller Pro' to install it.

⚠ If you once deleted an RCCP folder by hand, the warning is worded differently and mentions "a leftover BCG_RCCP setting". That is the half-removed case: RCCP's scripts are gone, but the project setting RCCP left behind is not, so the setting alone cannot be trusted as proof that RCCP is installed. Installing the bundled copy restores it.

Input System (for the keyboard hotkey)

The optional T hotkey that toggles the garage uses Unity's Input System package. RCCP already installs and uses the Input System, so in practice this is always present. If the Input System were ever missing, the hotkey component silently does nothing - the garage can still be opened from code or with Open On Start.

What Happens When You Import

RCCP Tuner installs itself. On the first editor load after import, the installer (RCCPT_InitLoad) runs automatically:

  1. It probes for RCCP by looking for RCCP's compiled classes (RCCP_CarController and RCCP_Version) and comparing the version it reports against the V3.0.0 minimum. It deliberately does not trust RCCP's BCG_RCCP project setting for this - that setting survives a manual folder delete, so it only proves RCCP was here at some point, not that it is here now.
  2. If RCCP checks out, it registers the Tuner's own scripting define symbol, BCG_RCCP_TUNER. A scripting define symbol is a project-wide compile switch - you can see the list under Edit > Project Settings > Player > Other Settings > Scripting Define Symbols. Nearly every one of the Tuner's runtime scripts is wrapped in this symbol, which is why the asset stays inert in a project without RCCP.
  3. Unity recompiles once (this is normal - the symbol changed) and the Console logs [RCCP Tuner] Installed. Registered BCG_RCCP_TUNER.
  4. The Welcome Window opens, showing the install status.

⚠ Step 4 happens once per machine, not once per project. The "already shown" flag lives in Unity's EditorPrefs, which is shared by every project on that Unity installation. If you have imported RCCP Tuner before, no window appears in your second project - that is not a failed install.

You do not need to do any of this manually. To re-check the status at any time, open Tools > BoneCracker Games > RCCP Tuner > Welcome Window:

The Welcome Window - all three status rows ticked means the install is healthy

The three status rows should all show a checkmark:

Status row What it means
Realistic Car Controller Pro detected RCCP's classes are compiled in this project and its version meets the V3.0.0 minimum. When RCCP is found, the detected version is appended in brackets, for example (V3.0.0). An RCCP that is present but too old shows a cross here, not a checkmark
BCG_RCCP_TUNER symbol registered The Tuner's own define is active - its scripts are compiled
Tuner settings asset present RCCPT_Settings.asset was found in the Tuner's own Resources folder (it is created automatically on first access)

When the first row shows a cross, the window explains which case you are in - missing, or present but too old - and, if the bundled package is there, gives you a button to install it without leaving the window. A full tour of the window is in Editor Tools.

Folder Structure

After import you will find everything under one folder:

Assets/RCCP Tuner/
  Audio/            <- Garage theme music + 8 UI sound effects
  Demo/             <- Showroom demo scene and everything it needs
    Catalogs/       <- Ready-made demo content (paints, wheels, prices...)
    Environment/    <- Showroom set dressing and lighting assets
    Materials/      <- Demo sky / floor / city materials
    Thumbnails/     <- Generated catalog icons (24 PNGs: wheels, spoilers, siren)
  Documentation/    <- This documentation (MD + HTML + Images)
  Editor/           <- Editor tooling (menus, builders, validator, Welcome Window)
  Fonts/            <- Chakra Petch font (SIL Open Font License - license text included)
  Installer/        <- The bundled Realistic Car Controller Pro .unitypackage
  Prefabs/          <- RCCPT_TunerCanvas.prefab - the garage UI
  Resources/        <- RCCPT_Settings + default Theme / Economy Config / Shot Library
  Scripts/          <- Runtime code (Adapter, Camera, Core, Data, Economy, UI)
  Textures/         <- Procedural UI sprites and category icons

Demo/Thumbnails/ is the output folder of the thumbnail generator - if you run Tools > Generate Catalog Thumbnails From Selected Vehicle, that is where the rendered icons land. See Editor Tools.

Two things worth knowing about this layout:

Opening the Settings Asset

Several chapters ask you to change a field on RCCPT_Settings, and it has no menu item of its own. Two ways to reach it:

That asset holds the four project-wide defaults (Catalog Set, Economy Config, Theme, Shot Library) that every scene falls back to. Each empty slot has a Locate button that finds and assigns a matching asset for you - handy right after a first import, so you can wire all four without dragging anything. It guesses, preferring assets inside the RCCP Tuner folder and ones named *_Default, so double-check the pick if you have authored your own. The full field reference is in Editor Tools.

Verification

After the import settles, confirm the install in under a minute:

  1. Open Tools > BoneCracker Games > RCCP Tuner > Welcome Window - all three status rows show checkmarks.
  2. The menu Tools > BoneCracker Games > RCCP Tuner shows the full tree: a Setup submenu, a Tools submenu, and Documentation. If the only entries are Welcome Window and Setup > Install Bundled Realistic Car Controller Pro, the BCG_RCCP_TUNER define never registered - RCCP is missing or older than V3.0.0. Those two entries are deliberately not gated on the define, so the tools you need to fix the problem are always reachable. The complete list is in the Menu Map below.

Both checks are true at any time, so they are the reliable ones. If the Console is still open from the import you will also see [RCCP Tuner] Installed. Registered BCG_RCCP_TUNER. - but that line is written only in the moment the symbol is registered, so a cleared Console or a later session will not show it. Its absence does not mean anything is wrong.

Everything the Tuner adds to the editor lives under Tools > BoneCracker Games > RCCP Tuner:

Menu item What it does
Welcome Window Install status, quick-start steps, links (Editor Tools)
Setup > Install Bundled Realistic Car Controller Pro Imports the RCCP copy that ships inside the Tuner. Overwrites any RCCP files already in the project - back up first
Setup > Create Tuner Canvas Drops the garage UI + a controller into the open scene (Scene Setup)
Setup > Add Vehicle Id To Selected Vehicle Gives the selected vehicle a stable save identity (Scene Setup)
Setup > Open Demo Scene Opens the shipped showroom (Quick Start). If the scene file is missing, it offers to build it for you
Setup > Build Demo Scene Rebuilds the showroom from scratch. Destructive - see the warning below
Tools > Validate Catalogs Checks your content for missing prices, bad indices, foreign materials (Editor Tools)
Tools > Generate Catalog Thumbnails From Selected Vehicle Renders 256 px catalog icons for wheels, spoilers and sirens from the selected vehicle's real models (Editor Tools)
Tools > Upgrade Tuner Canvas (Paint Studio) One-time patch for canvases built before the Paint Studio existed
Tools > Upgrade Tuner Canvas (UI Audio) One-time patch for canvases built before UI audio existed
Documentation Opens this documentation

Build Demo Scene overwrites files, and asset writes cannot be undone. It rewrites the showroom scene, the demo catalog assets under Demo/Catalogs/, and the demo sky and floor materials. Ctrl+Z will not bring your edits back. It asks for confirmation first and lists exactly what it is about to overwrite, so read that dialog instead of clicking through it. If you have hand-edited the showroom, save a copy under a different name before you run it.

Content assets (catalogs, themes, configs) are created through Assets > Create > BoneCracker Games > RCCP Tuner - covered in Creating Items. Every menu item, custom inspector and one-click fix in the asset is catalogued in Editor Tools.

Troubleshooting Installation

The Welcome Window shows a red cross on "Realistic Car Controller Pro detected"

Either RCCP is not in the project at all, or the RCCP that is there is older than V3.0.0. The window says which case you are in, and gives you a one-click install button when the bundled package is present. If you own RCCP on the Asset Store, updating it through the Package Manager is the better route - the bundled copy overwrites whatever RCCP files are already there.

The Welcome Window never opened after import

Expected on any machine that has imported RCCP Tuner before. It opens once per Unity installation, not once per project, so a second project on the same machine gets no window. Open it yourself from Tools > BoneCracker Games > RCCP Tuner > Welcome Window.

Unity recompiled right after import

Expected. Registering the BCG_RCCP_TUNER scripting define always triggers one recompile.

Unity recompiled again after I switched build target, and the install log repeated

Also expected, and not a broken install. Unity stores scripting define symbols per build target group, and the Tuner only ever writes the group that is currently selected. So the first time you switch to Android, iOS or WebGL, BCG_RCCP_TUNER is not yet defined for that platform and the installer registers it again: one extra recompile, a repeat of the [RCCP Tuner] Installed. Registered BCG_RCCP_TUNER. line, and a brief cross on the Welcome Window's second status row until it settles. The Welcome Window will not re-open, because that is gated separately.

I imported the Tuner before RCCP

That is fine, and it is the normal case when you use the bundled copy. Install RCCP - either from the Asset Store, or with Setup > Install Bundled Realistic Car Controller Pro - and on the next editor load the Tuner detects it and completes its own installation automatically.

Next Steps

  1. Open the shipped demo and press Play - see Quick Start.
  2. When you are ready for your own scene, continue with Scene Setup.
  3. To see what every menu item and inspector in the asset does, browse Editor Tools.