Skip to content

Yulfic/RoyalBattle

Repository files navigation

⚔️ RoyalBattle

RoyalBattle — Плагин для проведения королевских битв на вашем сервере Minecraft.

RoyalBattle автоматизирует все этапы PvP-ивентов в стиле Battle Royale: от подготовки и наполнения сундуков до определения победителя и управления игровыми стадиями.


✨ Основные функции

🎯 Полная автоматизация ивента

Плагин управляет стадиями игры: подготовка, запрет PvP, основная битва, сужение барьера, определение победителя.

🗃️ Синхронное заполнение сундуков

  • Безопасное и быстрое наполнение сундуков лутом
  • Поддержка настройки ценности предметов для центра карты
  • Прогресс отображается через BossBar

⏱️ Гибкая настройка таймеров

Все тайминги (подготовка, запрет PvP, основная игра, сжатие барьера) настраиваются в config.yml.

🛡️ Управление барьером

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

👥 Система участников

  • Только онлайн-игроки на момент старта становятся участниками
  • Новые игроки после старта — наблюдатели
  • Alive-статус сохраняется даже после выхода

🧱 Ограничения на ломание блоков

  • Во время подготовки нельзя ломать блоки
  • После — только определённые из конфига, затем любые

⚔️ PvP и бессмертие

  • После подготовки 30 минут нельзя атаковать игроков
  • После использования тотема бессмертия игрок становится уязвим

🌐 Локализация

Все сообщения вынесены в lang.yml — легко перевести под свой сервер.

📊 Логирование и сохранение

  • Сохраняются все данные о состоянии игры и участниках
  • Победитель записывается в отдельный файл win.yml

🛠️ Команды и права

Команда Описание Права (permission)
/royalbattle start Запустить игру royalbattle.start
/royalbattle stop Остановить игру royalbattle.stop
/royalbattle reload Перезагрузить конфиг и локализацию royalbattle.reload
/royalbattle list Показать список участников и их статусы royalbattle.list
/chestreset Начать асинхронное заполнение сундуков royalbattle.chestreset
/chestresetstop Остановить процесс заполнения сундуков royalbattle.chestreset
/chestmenu Открыть меню настройки лута royalbattle.chestmenu
/chestchance Настроить шансы выпадения предметов royalbattle.chestmenu
/chestvalue Настроить ценность предметов royalbattle.chestmenu

⚙️ Как настроить

  1. Скопируйте .jar файл в папку plugins вашего сервера.
  2. Перезапустите сервер — появятся файлы: config.yml, lang.yml, win.yml.
  3. Настройте параметры в config.yml:
    game:
      timers: ...
      allowed_blocks: ...
      barrier: ...

About

RoyalBattle is an advanced plugin for organizing large-scale PvP events in the style of "Battle Royale" on the Minecraft server. The plugin automates all stages of the game: from preparing and filling chests to determining the winner and managing the game stages.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages