Конфигурация config.yml

Файл config.yml является сердцем плагина ECosmetics. Здесь вы можете настроить всё: от подключения к базе данных до механики работы косметики и интеграций с другими плагинами.

Основные настройки

Эти параметры определяют ключевое поведение плагина.

Параметр	Тип	Описание
permissions	true/false	Очень важный параметр. Определяет, как игроки получают косметику. false (по умолчанию): косметика хранится в базе данных, и ее нужно выдавать командами. true: косметика выдается через права (permissions), например, через LuckPerms.
debug	true/false	Включает режим отладки. В консоли будет появляться дополнительная информация о работе плагина. Полезно для поиска ошибок.
show-all-cosmetics-in-menu	true/false	Если true, в меню будут отображаться все существующие косметические предметы, даже те, которые игроку недоступны. Недоступные предметы будут выглядеть иначе. Если false, игрок увидит только ту косметику, которая у него есть.
main-menu	строка	ID меню из файла menus.yml, которое будет открываться по команде /ecosmetics. По умолчанию: hat.

Внимание!

Изменение параметра permissions с false на true (или наоборот) на работающем сервере может привести к тому, что игроки потеряют доступ к своей косметике. Выбирайте режим работы заранее.

База данных

Эти настройки отвечают за хранение данных игроков.

Параметр	Тип	Описание
MySQL.enabled	true/false	Если true, плагин будет использовать MySQL. Если false (по умолчанию), будет использоваться локальная база данных SQLite (cosmetics.db).
MySQL.host	строка	IP-адрес или домен вашего сервера MySQL.
MySQL.port	число	Порт вашего сервера MySQL (стандартно 3306).
MySQL.user	строка	Имя пользователя для подключения к базе данных.
MySQL.password	строка	Пароль пользователя для подключения к базе данных.
MySQL.database	строка	Название базы данных, которую будет использовать плагин.
MySQL.table	строка	Название таблицы для хранения данных. По умолчанию: player_cosmetics.
MySQL.options	строка	Дополнительные параметры подключения к MySQL (например, useSSL=false).

Зона Гардероба

Настройки, связанные с интерактивной зоной для примерки косметики.

Параметр	Тип	Описание
leave-wardrobe-gamemode	строка	Игровой режим, который будет установлен игроку после выхода из зоны гардероба. Возможные значения: SURVIVAL, CREATIVE, ADVENTURE, SPECTATOR. Если не указан, вернется исходный режим.
zones-hide-items	true/false	Если true, инвентарь игрока будет временно очищаться при входе в зону и восстанавливаться при выходе.
zones-actions	true/false	Если true, будут выполняться команды из zones.yml при входе (on_enter) и выходе (on_exit) из зоны.
bossbar-color	строка	Цвет босс-бара, отображаемого в зоне. Возможные значения: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE.

Настройки косметики

Эти параметры влияют на работу конкретных типов косметики.

Параметр	Тип	Описание
spray-key	строка	Комбинация клавиш для использования спрея. Возможные значения: SHIFT_F, SHIFT_E, SHIFT_Q, SHIFT_LC, SHIFT_RC, SHIFT_JUMP, API.
spray-stay-time	число	Время в секундах, которое спрей будет виден на поверхности.
spray-cooldown	число	Время в секундах, которое игрок должен подождать перед повторным использованием спрея.
balloons-rotation	число (дробное)	Скорость вращения воздушных шаров.
worlds-blacklist	список строк	Список миров, в которых косметика будет автоматически скрыта, а команды плагина — отключены.

Интеграции

Настройки для взаимодействия с другими плагинами.

Параметр	Тип	Описание
placeholder-api	true/false	Включает поддержку PlaceholderAPI. Требует перезагрузки сервера (не плагина) для регистрации.
luckperms-server	строка	Используется для LuckPerms, если вы хотите, чтобы права на косметику выдавались только на определенном сервере (контекст). Оставьте пустым, если не нужно.

Прочие настройки

Параметр	Тип	Описание
proxy	true/false	Включите, если ваш сервер работает в сети BungeeCord или Velocity для корректной синхронизации данных.
equip-message	true/false	Если true, игроку будет отправляться сообщение в чат при надевании косметики.
save-data-delay	число	Интервал в секундах, с которым данные игроков сохраняются в базу данных.
on_execute_cosmetics	строка	Команда, которая будет выполнена от имени игрока, когда он открывает меню (/ecosmetics).