> ## Documentation Index
> Fetch the complete documentation index at: https://coolcars.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://www.spigotmc.org/resources/protocollib.1997/), and for placeholders to work, [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/).

***

## 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):

```bash theme={null}
/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](/en/quick-start) guide to learn the basics of vehicle operation.