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

# Установка

> Пошаговая инструкция по установке и первому запуску CakeAuction.

### Требования

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

1. **Ядро сервера:** Paper (или его форки) и **Folia** (полная поддержка).
2. **Версия сервера:** 1.16.5 — 26.x (и выше).
3. **Java:** Java 17 или выше.
4. **Обязательная зависимость:** [**NBTAPI**](https://www.spigotmc.org/resources/nbt-api.7939/) — необходим для работы с данными предметов.

### Опциональные зависимости

Для расширения функционала рекомендуется установить следующие плагины:

* [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/) — для использования плейсхолдеров в меню и сообщениях.
* [**LuckPerms**](https://luckperms.net/download) — для работы с группами прав, лимитами и налогами.
* [**Vault**](https://www.spigotmc.org/resources/vault.34315/) / [**VaultUnlocked**](https://modrinth.com/plugin/vaultunlocked/versions) / **BVault** / [**PlayerPoints**](https://www.spigotmc.org/resources/playerpoints.80745/) — для интеграции с экономикой сервера.
* [**Floodgate**](https://geysermc.org/download/?project=floodgate) — для корректного отображения интерфейсов игрокам с Bedrock Edition.

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

1. **Скачайте** актуальную версию плагина `CakeAuction.jar`.
2. **Поместите** файл в папку `plugins` вашего сервера.
3. **Запустите** сервер для генерации начальных конфигурационных файлов.
4. **Остановите** сервер и откройте файл `plugins/CakeAuction/config.yml`.
5. **Укажите ваш лицензионный ключ** в поле `key-license`.
6. **Настройте подключение к базе данных** в `database.yml` (рекомендуется MySQL/MariaDB для стабильности).
7. **Запустите** сервер снова.

<Note>
  Не используйте `/reload` или плагины типа PlugMan для перезагрузки CakeAuction. Это может привести к повреждению данных в базе или утечкам памяти. Используйте встроенную команду `/ah admin reload`.
</Note>