---

⚙️ System Requirements

• Server Version: Minecraft 1.21 or higher (Paper, Purpur).
• Runtime Environment: Java 21 or higher.
• Dependencies: ProtocolLib (Required).

---

📥 Installation

1. Install the latest version of ProtocolLib.
2. Drop CoolCars-1.0.0.jar into your server's plugins/ folder.
3. Restart the server to generate configuration files.
4. Ensure your server resource pack is active to see 3D models.

---

🚀 Core Features

🏎 Physics & Movement

• Inertia Simulation: Calculated acceleration, braking, and coasting mechanics.
• Terrain Handling: Smooth movement over slabs, stairs, and slopes.
• Collision System: Intelligent block and entity collision detection.
• Suspension: Visual chassis tilt animation during maneuvers.

🎨 Customization (YAML)

• 3D Model Support: Easy CustomModelData integration from your resource pack.
• Technical Tuning: Individual max speed, acceleration, and fuel capacity settings for each model.
• Sound Engine: Support for custom engine start, driving, and signal sounds.

🎮 Gameplay Mechanics

• Fuel System: Configurable consumption and refueling system.
• Access Control: Key Item system to lock/unlock vehicles and prevent theft.
• Storage: Integrated trunk (inventory) for every vehicle.
• Dynamic HUD: Real-time speedometer and fuel level display in the Action Bar.

---

🐛 Bug Reports

If you encounter any bugs or technical issues, please report them directly via Discord DM: devbasi

---

⌨️ Commands & Permissions

| Command | Description | Permission |
| :--- | :--- | :--- |
| /car spawn <model> | Spawn a vehicle of the selected model | coolcars.admin.spawn |
| /car givekey <player> <model> | Give a vehicle key to a player | coolcars.admin.givekey |
| /car list | View all available vehicle models | coolcars.player.list |
| /car reload | Reload configuration files | coolcars.admin.reload |

---