Плагин "Царь горы" для Minecraft



Описание плагина
Плагин "Царь горы" добавляет на сервер Minecraft динамичную мини-игру, в которой игроки соревнуются за контроль над специальными блоками (горами). Игрок, который дольше всех удерживает гору, получает награду в виде очков.

Основные возможности
Создание множества гор с уникальными ID
Настройка материала блока-горы
Система наград и кулдаунов
Визуальные эффекты (частицы, звуки)
Голограммы с информацией о победителях
Отбрасывание игроков с горы
Поддержка двух типов хранения данных: YAML и MySQL
Гибкая система сообщений и перевода

Установка
Скачайте файл плагина (KingOfTheHill.jar)
Поместите его в папку plugins вашего сервера
Перезапустите сервер
Настройте конфигурационный файл по своему усмотрению

Команды
Основная команда: /koth
Доступные подкоманды:

/koth set <id> - Установить точку горы (стоя на нужном блоке)
/koth remove <id> - Удалить точку горы
/koth score <id> - Проверить счёт горы
/koth reload - Перезагрузить конфиг
/koth lastwinner <id> - Показать последнего победителя
/koth resetcooldown [игрок] <id> - Сбросить кулдауны
/koth list - Список всех гор
/koth clearholograms - Очистить все голограммы

Настройки конфигурации
Конфигурационный файл (config.yml) автоматически создается при первом запуске плагина и содержит подробные комментарии ко всем настройкам.

Основные разделы конфигурации:
Настройки игры:
max-time - время удержания для победы (секунды)
win-reward - награда за победу (очки)
hill-material - материал блока-горы
winner-cooldown - базовый кулдаун для победителя
cooldown-increase-per-win - увеличение кулдауна за каждую победу

Настройки хранилища:
type - тип хранилища (YAML или MySQL)
Параметры подключения к MySQL (если выбран этот тип)

Эффекты:
Частицы и звуки при удержании/победе
Настройки отбрасывания игроков

Голограммы:
Включение/отключение
Текст и длительность показа

Настройки для креатива:
Разрешение на использование команд
Разрешение на захват гор
Сообщения для креативных игроков

Сообщения:
Полная кастомизация всех сообщений плагина
Поддержка цветовых кодов
Система хранения данных
Плагин поддерживает два типа хранения данных:
YAML (по умолчанию):
Данные сохраняются в файле data.yml
Простая настройка, не требует дополнительного ПО
MySQL:
Для больших серверов с высокой нагрузкой
Требует настройки подключения к базе данных
Автоматическое создание таблиц

Разрешения
Основные пермишены:

koth.* - Полный доступ ко всем функциям плагина (только для админов)
koth.set - Позволяет создавать новые горы (команда /koth set)
koth.remove - Позволяет удалять горы (команда /koth remove)
koth.reload - Позволяет перезагружать конфиг плагина
koth.score - Позволяет проверять свой счёт на горе (для всех игроков)
koth.lastwinner - Позволяет смотреть последнего победителя (для всех)
koth.resetcooldown - Сбрасывает кулдауны победителей (для админов)
koth.list - Показывает список всех гор (для всех игроков)
koth.clearholograms - Очищает голограммы (для админов)
По умолчанию:
Все пермишены кроме score и lastwinner выдаются только операторам
Обычные игроки могут только смотреть счёт и победителей

API для разработчиков
Плагин предоставляет следующие возможности для интеграции с другими плагинами:
Методы для управления горами:
Создание/удаление гор
Получение информации о текущем короле
Управление голограммами

События:
Событие захвата горы
Событие победы
Событие потери контроля

Доступ к данным:
Получение статистики игроков
Управление кулдаунами

Совместимость
Плагин тестировался на версиях Spigot/Paper 1.21 - 1.21.8. Для работы требуется Java 21.