Плагин CustomMobArena 1.0

CustomMobArena: Улучшенная арена выживания
CustomMobArena — это мощный и легко настраиваемый плагин, который превращает любую область вашего мира в бесконечную арену для сражений. Откажитесь от скучного ванильного спавна! Наш плагин предлагает полностью кастомизируемые испытания с уникальными наградами.
Основные функции:
Настраиваемый спавн: Определите точные границы арены с помощью двух точек (P1/P2) и настройте количество мобов, которые будут появляться в заданный интервал времени.
Усиленные мобы: Шанс появления мобов с увеличенным здоровьем, уникальными названиями и кастомной экипировкой (броня и оружие с чарами).
Двухуровневая система лута:
Стандартный лут: Определите шанс выпадения ценных ресурсов из обычных мобов.
Босс-лут: Отдельная, более ценная таблица лута для усиленных мобов, гарантирующая достойную награду за сложное сражение.
Удобное управление: Интуитивно понятные административные команды (/mobarena setp1|setp2|start|stop|reload).
Интерфейс лута: Игроки могут просмотреть все возможные награды через GUI команду (/mobarena loot).
I. Установка и Настройка Арены
Для работы плагина необходимо определить границы боевой зоны (кубоида) и управлять циклом спавна.
Установка границ:
/mobarena setp1 (Разрешение: custommobarena.admin): Устанавливает первую угловую точку (P1) арены.
/mobarena setp2 (Разрешение: custommobarena.admin): Устанавливает вторую угловую точку (P2) арены.
Управление циклом:
/mobarena start (Разрешение: custommobarena.admin): Запускает постоянный цикл спавна мобов.
/mobarena stop (Разрешение: custommobarena.admin): Останавливает цикл спавна.
/mobarena reload (Разрешение: custommobarena.admin): Перезагружает конфигурационные файлы (config.yml и loot.yml).
II. Механика Сражения и Спавн
Плагин работает в режиме постоянного спавна (без волн), основываясь на настройках из config.yml.
Настройки спавна:
mobs_to_spawn: Количество мобов, которое спавнится за один цикл.
respawn_delay_seconds: Интервал (в секундах) между циклами спавна.
mob_type: Основной тип сущности, который спавнится (например, ZOMBIE).
Усиленные мобы (Кастомизация):
chance_to_be_custom: Шанс (0.0 до 1.0) на то, что моб получит усиленные характеристики.
Здоровье: Усиленные мобы получают множитель здоровья, делая их мини-боссами.
Экипировка: Кастомная экипировка (броня и оружие с чарами).
III. Система Лута
В плагине реализована двухуровневая система кастомного лута, которая полностью заменяет стандартный дроп мобов.
Стандартный Лут:
Использование: Выпадает из обычных мобов. Содержит базовые ресурсы.
Конфиг: Секция default_loot в loot.yml.
Босс-Лут:
Использование: Выпадает из усиленных (кастомных) мобов. Содержит более редкие и ценные предметы (например, незерит, зачарованные яблоки).
Конфиг: Секция boss_loot в loot.yml.
Просмотр лута
/mobarena loot (Разрешение: custommobarena.loot): Открывает GUI-меню с отображением всего доступного лута (стандартного и босс-лута) с указанием шанса и количества.
IV. Примечания для Администраторов
Конфликт версий: Если используется старая версия Spigot API (до 1.13), функция установки шанса дропа экипировки может не работать. Экипировка мобов будет выпадать с шансом по умолчанию.
Конфигурация лута: Для добавления новых предметов в loot.yml используйте Material.name в верхнем регистре (например, DIAMOND, IRON_SWORD).

V. Установка и Совместимость
1. Поддерживаемые Версии и Ядро
Плагин CustomMobArena разработан и оптимизирован для современных версий ядра Spigot, Paper или их форков.
Ядро: Spigot, Paper, Purpur или аналогичные ядра, поддерживающие API Bukkit/Spigot.
Версии Minecraft: 1.16.5
Примечание: Хотя плагин может работать на версиях 1.13–1.16.4, официальная поддержка и тестирование проводятся на 1.16.5 так как эта версия использует современный API для работы с чарами и предметами (NamespacedKey).
2. Установка Плагина на Сервер
Для установки плагина выполните следующие шаги:
Скачайте JAR-файл.
Перенесите файл: Скопируйте файл CustomMobArena-1.0-SNAPSHOT.jar в папку plugins/ на вашем Minecraft-сервере.
Перезагрузите/Запустите сервер:
Если сервер уже работает, выполните команду /reload (не рекомендуется, но работает).
Рекомендуется: Выполните полный перезапуск сервера, чтобы плагин полностью загрузил свои конфигурационные файлы.
Проверьте конфигурацию: После первой загрузки появиться папка CustomMobArena/
Настройте границы: Зайдите на сервер и используйте команды /mobarena setp1 и /mobarena setp2, чтобы установить границы арены.
Запустите: Введите команду /mobarena start, чтобы начать спавн мобов!
3. Зависимости (Dependencies)
В настоящее время плагин CustomMobArena не имеет обязательных сторонних зависимостей.