Installation

How to properly install and set up the CoolCars plugin for the first time.

Installing CoolCars is straightforward, but following the correct sequence ensures all configuration files and model folders are generated properly.

System Requirements

Before installing, make sure your server meets the following requirements:

• Server Core: Paper, Spigot, or Purpur (1.21 and above).
• Java: Version 21 or higher.
• Dependencies: For correct packet processing, it is recommended to install Protocolib, and for placeholders to work, PlaceholderAPI.

---

Installation Steps

Follow these steps in order:

Step 1: Upload the Plugin

Place the CoolCars.jar file into your server’s plugins folder.

Step 2: First Boot

Start your server. The plugin will create the plugins/CoolCars directory and generate default configuration files:

• config.yml — Global settings.
• items.yml — Item configurations.
• sounds.yml — Sound effects settings.
• cars/Volga folder — An example vehicle model configuration.

Step 3: Resource Pack Setup

To make vehicles look like real cars instead of iron ingots, you need to set up a resource pack.

1. Ensure the CustomModelData values in your model’s components.yml match your resource pack.
2. Install the resource pack on your server or provide it to your players.

---

Verification

Once the server is running, type the following command in the console or in-game (if you are OP):

/car spawn volga

If the vehicle appears, the plugin is successfully loaded. If you see an error message, check the server console for any startup errors.

---

What’s Next?

After a successful installation, we recommend checking out the Quick Start guide to learn the basics of vehicle operation.