CoolCars — Vehicle System for Minecraft

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ 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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━