MiningRewards

MiningRewards позволяет награждать игроков за добычу выбранных блоков на серверах Spigot и Paper. Создавайте и настраивайте награды через меню в игре: все нужные параметры собраны в одном месте.

Награды могут выдавать предметы, деньги, опыт, эффекты зелий и зачарования. Они также могут выполнять команды, чинить инструменты, заменять или превращать блоки, добывать соединённые рудные жилы и сканировать местность. Mining Shield даёт временную защиту, а Auto Pickup отправляет добытые предметы прямо в инвентарь.

✅ Создание наград и управление ими

• Управление через интерфейс – Создавайте, редактируйте, просматривайте, сортируйте и удаляйте награды прямо из меню инвентаря.
  
• Пошаговый создатель наград – Настраивайте каждую награду через мастер с отдельными этапами для:
  
  • Название награды
    
  • Тип награды
    
  • Активирующие блоки
    
  • Настройки конкретной награды
    
  • Шанс активации
    
  • VIP-доступ
    
  • Отключённые миры
    
  • Регионы WorldGuard
    
  • Обычные предметы из блока
    
  
  
• Отдельные файлы наград – Каждая награда хранится в своём файле в папке Rewards.
  
• Безопасные названия наград – Названия проверяются перед созданием, переименованием, загрузкой или удалением наград.
  
• Автоматическое обновление конфигурации – Недостающие записи настроек и сообщений при необходимости добавляются при запуске.
  

✅ 20 типов наград
Доступны следующие типы наград:

• Выдать предмет – Выдайте игроку дополнительный настраиваемый предмет.
  
• Множественный дроп – Выдайте несколько копий предмета добытого блока.
  
• Выдать деньги – Наградите игрока валютой сервера через Vault.
  
• Выдать уровень – Выдайте один или несколько уровней опыта.
  
• Выдать опыт – Выдайте настраиваемое количество непосредственного опыта.
  
• Создать бонусный сундук – Создайте сундук с настроенными предметами награды.
  
• Выдать эффект зелья – Примените выбранный эффект на заданное время.
  
• Команда – Выполните одну или несколько серверных команд при активации. Поддерживаются переменные, такие как %PLAYER% и %BLOCK%.
  
• Починить инструмент – Почините инструмент, которым добыт блок.
  
• Взрывная награда – Создайте взрыв в месте добытого блока.
  
• Восстановить блок – Замените добытый блок блоком того же типа.
  
• Смена руды – Замените добытый блок случайно выбранной настроенной рудой.
  
• Награда зачарования – Добавьте выбранное зачарование и уровень к добывающему инструменту игрока.
  
• Выдать случайный эффект – Выдайте игроку случайный эффект из настроенного списка.
  
• Добыча жилы – Автоматически добывайте связанные рудные блоки с настраиваемыми радиусом и пределом блоков.
  
• Золотое яблоко – Примените настраиваемые регенерацию, поглощение и пищевые преимущества награды золотого яблока.
  
• Плавильщик руд – Заменяйте сырые рудные предметы слитками. Настраиваются Удача, опыт печи и визуальные эффекты. Поддерживает железо, золото, медь и древние обломки.
  
• Импульс старателя – Сканируйте загруженную местность на выбранные руды и показывайте личный компас из частиц. Настраиваются радиус, длительность, группы руд, максимум целей и режим только скрытых руд.
  
• Шахтёрский щит – Выдайте временный щит с настраиваемыми зарядами, длительностью, снижением урона и визуальными эффектами. Повторные активации добавляют заряды до предела безопасности и сохраняют более сильную защиту.
  
• Автоподбор – Отправляйте предметы добытого блока прямо в инвентарь. При желании собирайте опыт мгновенно, выбирайте выпадение излишков у игрока или блока и включайте эффекты подбора. Есть отдельные настройки создателя и редактора.
  

✅ Условия наград и управление шансами

• Несколько активирующих блоков – Назначайте несколько типов блоков одной награде вместо отдельной награды для каждого блока.
  
• Индивидуальный шанс активации – Настраивайте шанс каждой награды независимо, от 0.01% до 100%.
  
• Быстрое изменение шанса – Меняйте шанс прямо в интерфейсе с шагами 0.01%, 0.1%, 1% и 10%.
  
• Несколько наград на блок – Назначайте одному блоку несколько наград с собственными шансами и ограничениями.
  
• Управление обычным дропом – Выбирайте, должен ли блок выдавать обычный предмет после активации. Auto Pickup сохраняет обычный дроп включённым для его сбора.
  

✅ Глобальные настройки и защита от злоупотреблений

• Глобальный переключатель наград – Включайте или выключайте обработку для обычных игроков без удаления настроенных наград.
  
• Административный обход – Разрешайте уполномоченным сотрудникам получать награды при выключенном глобальном переключателе.
  
• Защита установленных блоков – Не позволяйте ставить и многократно разрушать собственные блоки ради наград.
  
• Постоянная база защиты – Координаты блоков игроков хранятся в SQLite и остаются защищёнными после перезапуска.
  

✅ Безопасность наград и управление производительностью

• Предел наград на блок – Ограничьте число наград за одно разрушение блока. По умолчанию 3, настраивается через Safety.MaxRewardsPerBlockBreak.
  
• Задержка активации игрока – При желании задайте задержку в тиках между успешными активациями для каждого игрока. По умолчанию отключена.
  
• Контроль творческого режима – По умолчанию пропускайте награды для игроков Creative с настраиваемым переключателем.
  
• Пределы добычи жилы – Совмещайте радиус и предел каждой награды с глобальным максимумом добытых блоков. Дополнительные блоки вызывают события разрушения, отменяемые защитными плагинами, без рекурсивных цепочек наград.
  
• Управление взрывами – Настраивайте максимальную силу и возможность разрушения блоков взрывами наград. Урон блокам по умолчанию отключён.
  
• Пределы зачарований – По умолчанию используйте обычные пределы уровней с необязательной настройкой небезопасных зачарований.
  
• Ограничения команд – Задайте максимальную длину и запрещённые префиксы для наград-команд.
  
• Проверка наград – Пропускайте награды с отсутствующими или неверными обязательными значениями. Ошибки выполнения записываются в журнал, неудачная награда пропускается.
  

✅ Ограничения миров

• Глобально отключённые миры – Отключайте награды за добычу в выбранных мирах из глобальных настроек.
  
• Отключённые миры отдельной награды – Отключайте отдельную награду в выбранных мирах через постраничный интерфейс.
  

✅ Поддержка регионов WorldGuard
Если установлены WorldEdit и WorldGuard, действие наград можно ограничить по регионам:

• Разрешённые регионы – Разрешайте активацию только внутри выбранных регионов WorldGuard.
  
• Отключённые регионы – Запрещайте активацию внутри выбранных регионов.
  
• Интерфейс управления регионами – Добавляйте, удаляйте и сбрасывайте разрешённые или отключённые регионы прямо в меню инвентаря.
  

✅ Права наград

• Необязательные VIP-награды – Помечайте отдельные награды как защищённые правами.
  
• Глобальное требование права – Требуйте право для каждой настроенной награды.
  
• Право всех наград – Выдавайте доступ ко всем защищённым наградам через miningrewards.reward.all.
  
• Право отдельной награды – Выдавайте доступ к одной выбранной награде через miningrewards.reward.<reward_name>.
  
• Отдельные права администрирования – Независимо управляйте доступом к главному меню, списку, просмотру, создателю, редактору, удалению и глобальным настройкам.
  

✅ Список наград и интерфейс просмотра

• Постраничный список – Просматривайте все настроенные награды в упорядоченном меню инвентаря.
  
• Подробный просмотр – Смотрите тип, блоки, шанс, VIP, обычный дроп, регионы и специальные значения.
  
• Сортировка – Переключайте алфавитный порядок между A–Z и Z–A.
  
• Быстрое редактирование – Откройте полный редактор через Левый клик.
  
• Безопасное удаление – Удаляйте награду через защищённое подтверждение Shift + правый клик.
  

✅ Полный редактор наград
Редактируйте готовые награды, не создавая их заново. В зависимости от типа можно изменить:

• Название награды
  
• Активирующие блоки
  
• Шанс активации
  
• Значения конкретной награды
  
• Требование VIP
  
• Обычные предметы из блока
  
• Отключённые миры
  
• Регионы WorldGuard
  

✅ Эффекты, звуки и сообщения

• Эффекты активации – Показывайте настраиваемые визуальные эффекты при активации.
  
• Звуки активации – Проигрывайте настраиваемый звук после успешной награды.
  
• Сообщения игроку – Отправляйте сведения игроку, активировавшему награду.
  
• Глобальные объявления – Сообщайте об успешных наградах другим игрокам онлайн.
  
• Сообщения консоли – Записывайте успешные активации в консоль сервера.
  
• Независимые переключатели – Отдельно включайте или выключайте сообщения игроку, глобальные объявления и сообщения консоли.
  
• Редактируемые сообщения – Настраивайте префиксы, сообщения, значения и переменные в Messages.yml.
  

✅ Команды и администрирование
Откройте /miningrewards или его псевдоним /mr для доступа к главному меню и инструментам управления:

• /miningrewards
  
• /miningrewards list
  
• /miningrewards create
  
• /miningrewards create <reward_name>
  
• /miningrewards edit <reward_name>
  
• /miningrewards remove <reward_name>
  
• /miningrewards globalsettings
  

Автодополнение по Tab помогает вводить подкоманды плагина.

✅ Интеграции и совместимость

• Экономика Vault – Денежные награды доступны при установленных Vault и совместимом поставщике экономики.
  
• WorldEdit и WorldGuard – Необязательные ограничения наград по регионам.
  
• SQLite – Постоянное хранение защиты установленных блоков.
  
• Spigot и Paper – Разработан для серверов с API Spigot/Paper 26.2 и Java 25.