Плагин PrismEarn | Добавление награды за убийство мобов в виде монет [1.0]

---

PrismEarn добавляет награды за убийство мобов через экономику Vault. Выберите, как игрок получает деньги: подбирает выпавшую монету или получает сумму сразу на баланс. Для каждого моба можно задать собственный шанс и диапазон награды.

Плагин подойдёт серверам с прокачкой, фермами, титулами и дополнительными бонусами за активность игроков.

---

Возможности

• Два режима награды: предмет на земле (drop) и прямое начисление (direct).
• Выпавшую монету может подобрать любой игрок. Сумма хранится в данных предмета; монета не занимает место в инвентаре и не подбирается воронкой.
• Настройка материала монеты, CustomModelData, свечения и звука при получении.
• Отдельные диапазоны суммы, шансы выпадения, названия и включение награды для мобов в mobs.yml.
• Общие настройки для остальных мобов через mobs.default.
• Возможность отключить награды в выбранных мирах и от мобов из обычных спавнеров.
• Бонусы к монетам через permissions. Если у игрока несколько бонусов, применяется самый большой процент.
• Сообщения о награде в чате или action bar, настраиваемые цвета & и &#RRGGBB.
• Перезагрузка конфигов без перезапуска сервера.

---

Как работают награды

• Сервер определяет игрока, убившего моба, и проверяет мир, происхождение моба, право prismearn.earn и настройки mobs.yml.
• Плагин выбирает сумму в заданном диапазоне, учитывает шанс и активный бонус игрока.
• В режиме drop рядом с мобом появляется монета. Баланс пополняется при её подборе; награду получает подобравший игрок.
• В режиме direct сумма сразу поступает на баланс убийцы через Vault.
• Если бонус положительный, его размер в дополнительных монетах можно показать в сообщении. Без бонуса соответствующая часть сообщения скрывается.

Важно: для работы нужны Vault и плагин экономики, зарегистрированный в Vault. Без провайдера экономики PrismEarn не запустится.

---

Настройка мобов

Все награды настраиваются в mobs.yml. Параметры отдельного моба наследуются из default, если они не указаны:


min и max — диапазон монет; chance — шанс от 0 до 100; enabled: false отключает награду для указанного моба.

---

Режимы и ограничения

В config.yml:


Для direct замените reward-mode на direct. Для запрета награды с обычных спавнеров установите allow-spawner-mobs: false. Название и лор монеты не нужны: она начисляет деньги при подборе и не попадает в инвентарь.

---

Бонусы через права

По умолчанию в config.yml заданы:


Это прибавка +10%, +15% или +20% к награде. Права по умолчанию никому не выдаются. Их можно выдавать через LuckPerms или другой менеджер прав. Если активны несколько прав, применяется наибольший бонус.

PrismCustomTituls может выдавать право вида prismearn.bonus.<процент> на время ношения титула. PrismEarn распознаёт такой процент без отдельной записи каждого значения в config.yml. Например, титул «Охотник» может давать prismearn.bonus.15.

---

Сообщения и action bar

Настройте notification.channel как chat или actionbar. Текст и место бонуса задаются отдельно:


{amount} — итоговая награда, {mob} — название моба, {bonus} — дополнительные монеты. %message-bonus% и %actionbar-bonus% подставляют настроенный текст только при положительном бонусе; иначе становятся пустыми. Это внутренние шаблоны PrismEarn, PlaceholderAPI для них не требуется.

---

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



После /prismearn reload плагин показывает время перезагрузки в миллисекундах.

---

Установка

1. Установите Vault и совместимый плагин экономики.
2. Поместите PrismEarn.jar в папку plugins и перезапустите сервер.
3. Настройте config.yml и mobs.yml в папке плагина.
4. Примените изменения командой /prismearn reload.

---

Совместимость

• Minecraft: 1.16.5–26.2
• Java: 8+ для самого плагина; версия Java сервера зависит от версии Minecraft.
• Сервер: Paper / Spigot
• Обязательно: Vault + провайдер экономики

---

Автор

PrismDeveloper

Telegram: PrismDeveloper | Канал

---