Troubleshooting and FAQ

Common Issues

Vehicle doesn't move

Symptoms: Vehicle spawns but doesn't respond to input.

Checklist:

1. Ensure the vehicle is registered as the player vehicle — check RCCP_SceneManager.Instance.activePlayerVehicle is not null
2. Verify canControl is true on the RCCP_CarController
3. Verify externalControl is false (unless you intend AI/script control)
4. Check that the engine is running — engineRunning should be true
5. Ensure RCCP_InputManager exists in the scene (added automatically with Scene Managers)
6. Check the Console for errors about missing components

Vehicle flips or behaves erratically

Symptoms: Vehicle spins, rolls over, or bounces uncontrollably.

Possible causes:

• Center of mass too high: The default COM position may not suit your vehicle mesh. In RCCP Pro, you can adjust the COM position; in Lite, it uses default placement
• Wheel collider position: Wheel colliders must be properly aligned with wheel models. Check that RCCP_WheelCollider transforms are at wheel centers
• Scale issues: Vehicle should be at realistic scale (approximately 4m long for a sedan). Non-uniform scale on parent objects causes physics issues
• Rigidbody mass: Verify the vehicle's Rigidbody mass is appropriate (typically 1000-2000 kg for a car)

No sound

Symptoms: Vehicle runs silently.

Checklist:

1. Check that RCCP_Audio component exists and is enabled on the vehicle
2. Verify audio clips are assigned in RCCP Settings (Resources/RCCP_Settings)
3. Check Unity's Audio settings — ensure volume is not muted
4. Check the AudioListener exists (usually on the camera)
5. Verify audio sources aren't destroyed by scene load

Camera doesn't follow the vehicle

Symptoms: Camera stays in place or doesn't spawn.

Checklist:

1. Ensure RCCP Camera is in the scene, or that a camera prefab is assigned in RCCP Settings
2. Register the vehicle as a player vehicle — RCCP.RegisterPlayerVehicle(vehicle)
3. Check RCCP_SceneManager.Instance.activePlayerCamera is not null
4. If the camera prefab is missing from RCCP Settings, re-assign it

Grayed-out fields in the Inspector

This is expected behavior in RCCP Lite. Advanced parameters are intentionally read-only to encourage upgrading to RCCP Pro. The grayed-out fields still function at runtime with their default values. See 14_LiteVsPro.md for a complete list of what's editable vs locked.

Compile errors after import

Possible causes:

• Unity version mismatch: RCCP Lite requires Unity 6000.0.49f1 or later. Earlier versions may have API incompatibilities
• Missing packages: Ensure the Input System package is installed if your project uses it
• Duplicate assemblies: If you have both RCCP Lite and RCCP Pro in the same project, remove one — they cannot coexist

Mobile controls not showing

Checklist:

1. Verify mobileControllerEnabled is true in RCCP Settings
2. Ensure the UI Canvas is in the scene
3. Check that the correct platform is selected in Build Settings
4. Mobile controls only appear when the platform is set to Android or iOS, or when forced via RCCP Settings

AI vehicle not driving

Checklist:

1. Ensure RCCP_AI component exists on the vehicle
2. Verify externalControl is true on the RCCP_CarController
3. Check that a waypoint container is assigned (for FollowWaypoints/RaceWaypoints modes)
4. Ensure a NavMesh is baked in the scene (Window > AI > Navigation > Bake)
5. Verify the waypoints are placed on or near the NavMesh surface

Wheels floating or clipping through ground

Possible causes:

• Wheel collider radius doesn't match the visual wheel mesh size
• Wheel collider suspension distance is incorrect
• Ground layers are not properly configured in the physics layer matrix

Performance issues

Tips:

• Enable multithreading in RCCP Settings for async physics processing
• Use RCCP_Lod on vehicles for level-of-detail switching at distance
• Reduce the number of active vehicles when possible
• Lower skidmark quality/count via RCCP_SkidmarksManager
• Disable telemetry and input debugger in RCCP Settings when not needed

---

FAQ

Can I ship a game with RCCP Lite?

Yes. All runtime features are fully functional with no restrictions. RCCP Lite is free to use in commercial projects under the Unity Asset Store license terms. The editor locks are only visible to developers in the Unity Editor.

Is there any DRM or time limit?

No. RCCP Lite has no DRM, no time limits, no watermarks, and no runtime restrictions. It complies with Unity Asset Store Section 1.4.a.

Can I modify the runtime scripts?

The runtime scripts are provided as source code. You can read and understand them. Modifying them is possible but not recommended in Lite, as changes may conflict when upgrading to Pro.

Will my project break if I upgrade to Pro?

No. Both Lite and Pro use the same component types, class names, and serialized field names. Upgrading is designed to be seamless — remove Lite, import Pro, and all scene references reconnect.

Can I use RCCP Lite with URP (Universal Render Pipeline)?

Yes. RCCP works with both the Built-in Render Pipeline and URP. Some light and material configurations may need adjustments for URP, but the physics and gameplay systems are pipeline-independent.

How do I create a new vehicle?

In RCCP Lite, the vehicle creation wizard is not available. You can:

1. Duplicate the included prototype vehicle and modify its mesh/colliders
2. Use the RCCP API to spawn and configure vehicles at runtime
3. Upgrade to Pro for the full vehicle creation wizard

Can I have multiple player vehicles?

Only one vehicle can be the active player vehicle at a time. However, you can switch between vehicles at runtime using RCCP.RegisterPlayerVehicle(newVehicle). All vehicles remain in the scene and can be AI-controlled or idle.

Does RCCP support multiplayer?

RCCP itself is a single-player vehicle physics system. For multiplayer, you would need to add a networking layer (such as Photon, Mirror, or Netcode for GameObjects) that synchronizes vehicle state. RCCP Pro documentation includes a Photon integration guide. The input override system makes it straightforward to apply network-received inputs to vehicles.

Where are the original Pro documentation PDFs?

The original RCCP Pro PDF documentation is in Assets/Realistic Car Controller Pro/Documentation/. These docs reference the full Pro feature set and may describe features or tools not available in Lite.

---

Support

• BoneCracker Games Support: bonecrackergames.com/contact
• Upgrade to Pro: Unity Asset Store
• Unity Forums: Search for "RCCP" or "Realistic Car Controller Pro" on the Unity Forums

Documentation Index

Document	Description
01_GettingStarted.md	Welcome and quick start
02_Installation.md	Import and setup
03_VehicleSetup.md	Vehicle architecture
04_DrivetrainComponents.md	Engine, Gearbox, Differential, etc.
05_VehicleSystems.md	Stability, Damage, Audio, etc.
06_CameraSystem.md	Camera modes
07_InputSystem.md	Input handling
08_AISystem.md	AI driving
09_Customization.md	Customization and upgrades
10_UISystem.md	UI system
11_SceneManagement.md	Vehicle spawning
12_Settings.md	Global settings
13_API.md	Scripting API
14_LiteVsPro.md	Lite vs Pro comparison
15_Troubleshooting.md	This guide