AA Vehicle Controller

⚙ Requirements

Minimum setup needed to use this package.

⚡ Quick Start Guide

Get a driveable vehicle in under 2 minutes.

Method 1: Vehicle Creator Wizard (Recommended)

1. Go to Tools → Abyssal Ababeel → Vehicle Creator Wizard
2. Drag your vehicle 3D model into the Vehicle Model slot
3. Assign the 4 wheel meshes (FL, FR, RL, RR)
4. Select a preset (Sports, Sedan, SUV, Racing, etc.)
5. Enable desired systems: Audio, AI, Nitro, Damage, Lights, etc.
6. Click "Create Vehicle" — done!

Method 2: Manual Setup

1. Add a Rigidbody to your vehicle root object
2. Add 4 child WheelCollider components at each wheel position
3. Add the VehicleController component (auto-adds WheelManager, SoundManager, VehicleInput)
4. Assign wheel colliders in the WheelManager
5. Configure the VehiclePreset in the inspector
6. Add a VehicleCamera to your Main Camera
7. Press Play!

🛠 Architecture Overview

How the package components connect together.

Namespace Structure

AbyssalAbabeel.VehicleController           // Core (VehicleController, VehicleInput, VehiclePreset, Events)
AbyssalAbabeel.VehicleController.Audio     // SoundManager, VehicleAudio
AbyssalAbabeel.VehicleController.AI        // AIVehicleController, AIForesight
AbyssalAbabeel.VehicleController.Systems   // Nitro, Damage, Lighting, SkidMark, TireSmoke
AbyssalAbabeel.VehicleController.Camera    // VehicleCamera
AbyssalAbabeel.VehicleController.UI        // VehicleDashboard
AbyssalAbabeel.VehicleController.Mobile    // MobileInputHandler, SteeringWheel/Drag/Buttons
Pathfinder.Runtime                         // PathGrid, AStarSolver, PathNode, RuntimePathfinder

🚗 Vehicle Controller

Core physics and driving simulation component. Attach to the vehicle root GameObject.
Script: Runtime/Core/VehicleController.cs • Requires: Rigidbody, WheelManager, SoundManager, VehicleInput

Engine Settings

Transmission

Physics

Drift System

Launch Control

Read-Only Properties

🎮 Vehicle Input

Unified input handler supporting Legacy, New Input System, and Mobile modes.
Script: Runtime/Core/VehicleInput.cs • Auto-added with VehicleController

Input Modes

Legacy Input Key Bindings

📦 Vehicle Presets

ScriptableObject-based vehicle configuration. Save and share vehicle setups as assets.
Script: Runtime/Core/VehiclePresetAsset.cs • Menu: Abyssal Ababeel → Vehicle Preset

Built-in Factory Presets

Usage

// Create preset from code
var preset = VehiclePresetAsset.CreateSportsPreset();

// Apply preset to vehicle at runtime
vehicleController.activePreset = preset.ToRuntimePreset();

// Save current settings to preset asset
preset.FromRuntimePreset(vehicleController.activePreset);

🔔 Vehicle Events

UnityEvent-based callbacks for game logic integration.
Script: Runtime/Core/VehicleEvents.cs

🎵 Sound Manager

Advanced positional audio with 11 independent sound components, interior/exterior switching, and per-component volume control.
Script: Runtime/Audio/SoundManager.cs • Auto-added with VehicleController

Sound Components

Master Settings

Positional Audio Offsets

🎧 Vehicle Audio (Legacy)

Simpler audio system with two modes: Multi-Clip (4 crossfaded loops) or Single-Clip (pitch-based).
Script: Runtime/Audio/VehicleAudio.cs

Audio Modes

🔥 Nitro System

Boost system with fuel management, particle effects, and auto-refill.
Script: Runtime/Systems/NitroSystem.cs

💥 Damage System

Real-time mesh deformation on collision. Supports MeshFilter and SkinnedMeshRenderer.
Script: Runtime/Systems/DamageSystem.cs

💡 Lighting System

Configurable light groups with key bindings, plus automatic brake and reverse lights.
Script: Runtime/Systems/LightingSystem.cs

Light Groups

Create unlimited light groups (headlights, fog lights, interior lights, etc.). Each group has a toggle key and list of GameObjects to enable/disable.

Brake & Reverse Lights

🏇 Skid Mark System

Dynamic tire mark rendering using procedural mesh generation.
Script: Runtime/Systems/SkidMarkSystem.cs

💨 Tire Smoke System

Per-wheel smoke particles driven by wheel slip. Auto-spawns from prefab or creates procedural particles.
Script: Runtime/Systems/TireSmokeSystem.cs

🎥 Vehicle Camera

3-mode camera system: Follow, Orbit, and Interior. Attach to Main Camera.
Script: Runtime/Camera/VehicleCamera.cs

Camera Modes

Follow Mode Properties

📈 Dashboard UI

In-game HUD showing speed, RPM gauge, gear indicator, nitro bar, and engine status.
Script: Runtime/UI/VehicleDashboard.cs • Requires: TextMeshPro

UI Slots

📱 Mobile Controls

Touch-based input with 3 steering modes.
Script: Runtime/Mobile/MobileInputHandler.cs

Steering Modes

Button Assignments

🤖 AI Vehicle Controller

Autonomous driving AI with 4 behavior modes, integrated GPS pathfinding, obstacle avoidance, and predictive targeting.
Script: Runtime/AI/AIVehicleController.cs • Requires: VehicleController

Detection Settings

Intelligence

Speed & Handling

🗺 GPS Pathfinder

Integrated A* pathfinding with async grid scanning for zero FPS impact. Finds optimal paths around complex obstacles.

🛠 AI Modes

4 behavior modes for different gameplay scenarios.

Drive States

The AI operates through an internal state machine: Forward → SlowingDown → Turning → Reversing → EscapingStuck → AggressiveChase. States are shown in the Debug Info section of the inspector.

🔧 Vehicle Creator Wizard

One-click vehicle setup editor window.
Script: Editor/VehicleCreatorWindow.cs • Menu: Tools → Abyssal Ababeel → Vehicle Creator Wizard

Features

• Auto-creates Rigidbody, WheelColliders, and all components
• 7 built-in presets (Sports, Sedan, SUV, Racing, Truck, Offroad, Van)
• Optional systems: AI, Nitro, Damage, Lighting, SkidMarks, TireSmoke, Dashboard
• Auto-generates gear ratios based on speed and RPM
• Creates center of mass transform
• Supports both SoundManager and VehicleAudio

🗻 Runtime Pathfinder

Standalone A* pathfinding component with visual debugging. Can be used independently of the AI system.
Script: Runtime/Pathfinder/RuntimePathfinder.cs

⌨ Default Controls

Default keyboard bindings (all configurable in VehicleInput inspector).

💻 Public API Reference

Key methods available for scripting integration.

VehicleController

// Engine control
vehicleController.StartEngine();
vehicleController.StopEngine();
vehicleController.ToggleEngine();

// Runtime properties
float speed = vehicleController.KPH;
float rpm = vehicleController.engineRPM;
float rpmNorm = vehicleController.RPMPercent;    // 0-1
float load = vehicleController.EngineLoad;       // 0-1
int gear = vehicleController.currentGear;
bool reversing = vehicleController.isReversing;

NitroSystem

float fuelPercent = nitroSystem.GetBoostFuelPercent();  // 0-1
float fuelCurrent = nitroSystem.GetCurrentBoostFuel();
float fuelMax = nitroSystem.GetMaxBoostFuel();
bool boosting = nitroSystem.IsBoosting();

DamageSystem

damageSystem.Repair();  // Restore all meshes to original state

VehicleCamera

vehicleCamera.CycleCamera();   // Next camera mode
vehicleCamera.currentMode = VehicleCamera.CameraMode.Interior;

VehicleInput

vehicleInput.SetInputMode(VehicleInput.InputMode.Mobile);
vehicleInput.isAIControlled = true;  // Disable human input

AIVehicleController

aiController.GPSForceRescan();  // Force new pathfinding scan

🔍 Troubleshooting

Common issues and solutions.