> ## 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.

# Установка

> Инструкция по правильной установке и первому запуску плагина CoolCars.

Установка CoolCars проста, но требует соблюдения определенной последовательности для корректной генерации всех конфигурационных файлов и папок моделей.

## Системные требования

Перед установкой убедитесь, что ваш сервер соответствует следующим требованиям:

* **Ядро:** Paper, Spigot или Purpur (версия **1.21** и выше).
* **Java:** Версия 21 или выше.
* **Зависимости:** Для корректной обработки пакетов рекомендуется установить [Protocolib](https://www.spigotmc.org/resources/protocollib.1997/), а для работы плейсхолдеров, [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/).

***

## Процесс установки

Выполните эти шаги по порядку:

### Шаг 1: Загрузка плагина

Поместите файл `CoolCars.jar` в папку `plugins` вашего сервера.

### Шаг 2: Первый запуск

Запустите сервер. Плагин создаст папку `plugins/CoolCars` и сгенерирует стандартные конфигурационные файлы:

* `config.yml` — общие настройки.
* `items.yml` — настройки предметов.
* `sounds.yml` — настройки звуков.
* Папку `cars/Volga` — пример настроенной модели автомобиля.

### Шаг 3: Настройка Resource Pack

Для того чтобы машины выглядели как настоящие автомобили, а не как железные слитки, вам необходимо настроить ресурспак.

1. Убедитесь, что в `components.yml` вашей модели указаны правильные значения `CustomModelData`.
2. Установите ресурспак на сервер или предложите его игрокам.

***

## Проверка работоспособности

После запуска сервера введите в консоль или в чат (если у вас есть OP) команду:

```bash theme={null}
/car spawn volga
```

Если машина появилась, значит плагин успешно загружен. Если вы видите сообщение об ошибке, проверьте консоль сервера на наличие ошибок при запуске.

***

## Что дальше?

После успешной установки мы рекомендуем ознакомиться с разделом [Быстрый старт](/ru/quick-start), чтобы узнать основы управления автомобилем.