UberEnchant

UberEnchant — плагин для нелегальных энкаунтов и эффектов

UberEnchant — серверный плагин для Minecraft, позволяющий накладывать любые энкаунты и эффекты зелий на предметы любой редкости. Инструмент включает поддержку кастомных механик (столики, алтари, торговля), интеграцию с экономикой и системами защиты, а также API для разработчиков. Плагин работает на платформах Bukkit, Paper, Purpur и Spigot с версии 1.17.1.

Суть плагина: энкаунты без границ

UberEnchant — это серверный плагин для Minecraft, который ломает стандартные ограничения на наложение энкаунтов. Он позволяет добавлять любые энкаунты любого уровня (вплоть до 255, что является внутренним лимитом игры с версии 1.17) на любые предметы: оружие, броню, инструменты, блоки и даже еду. В отличие от стандартных механик, где энкаунты привязаны к конкретному предмету при его создании, UberEnchant позволяет накладывать их динамически. Однако важно помнить: если предмет с энкаунтом из плагина будет помещен в инвентарь или использован, энкаунт исчезнет. Это сделано для предотвращения утечки мощных предметов, которые могут попасть в нежелательные руки. Плагин также добавляет поддержку эффектов зелий (potion effects) на предметы, которые применяются при нанесении урона, получении урона или потреблении предмета.

Расширенные возможности предметов: имена, лор и атрибуты

Помимо энкаунтов, плагин предоставляет полный контроль над внешним видом и свойствами предметов. Пользователи могут добавлять названия и описание (lore) с поддержкой цветных кодов и HEX-формата (например, #ff0000 для красного цвета). С версии 8.12.4 поддержка HEX-формата работает даже без обязательной установки Spigot или Paper. Кроме того, с версии 8.12.2 добавлена система атрибутов предметов (Item Attributes), позволяющая легко добавлять, устанавливать и удалять данные через команды. Также доступна функция скрытия/показа энкаунтов (hidden), что полезно для создания секретных предметов или предметов с нестандартной статистикой, невидимой для других игроков.

Команды управления: полный набор инструментов

Плагин предоставляет обширный набор команд для администраторов и игроков. Основные команды для добавления свойств включают:

• /uadd enchant — добавляет энкаунт на предмет в руке.
• /uadd enchant all — добавляет все доступные энкаунты на предмет.
• /uadd effect — применяет эффект зелия на предмет.
• /uadd name и /uadd lore — устанавливают название и описание.
• /uadd attribute [group] — добавляет атрибуты.

Для управления состоянием предметов доступны команды /uitem save, /uitem load (для загрузки сохраненных предметов в инвентарь) и /uitem delete. Команда /ulist выводит список всех доступных энкаунтов и эффектов, а /uhelp показывает справку по всем командам. С версии 8.11.8 добавлены команды для работы с мета-тегами энкаунтов (/uadd meta, /uset meta, /udel meta), позволяющие настраивать поведение эффектов (например, шанс активации, длительность, применение при выстреле из лука или блокировании щитом).

Кастомизация механик игры: алтари, столы и торговля

UberEnchant глубоко интегрируется с игровыми механиками, позволяя кастомизировать столах энкаунтов (Enchantment Tables) и алтарях (Anvils). Столы энкаунтов теперь могут предлагать кастомные энкаунты, а также повышать уровень ванильных энкаунтов выше стандартного лимита. С версии 8.11.5 добавлена механика "Floor Bonus", позволяющая использовать блоки под столом энкаунтов для увеличения максимального бонуса до 40 (вместо стандартных 15), что открывает доступ к энкаунтам 10-го уровня. Алтари поддерживают кастомные энкаунты и позволяют комбинировать ванильные энкаунты на более высокие уровни, с возможностью настройки максимальной стоимости.

С версии 8.12.2 плагин также влияет на торговлю с жителями: кастомные энкаунты появляются в предложениях торговцев как книги. Кроме того, при использовании терки (Grindstone) кастомные энкаунты удаляются с предмета, выдавая опыт игроку. Все эти механики можно настраивать через отдельные файлы конфигурации (например, mechanics/enchantment_table.yml), включая отключение функций или настройку коэффициентов бонусов.

Интеграция с системами защиты и экономики

Для обеспечения безопасности и экономической стабильности сервера плагин поддерживает интеграцию с популярными системами. Для работы с экономикой требуется плагин Vault, что позволяет использовать кастомные энкаунты в торговых автоматах и других экономических системах. С версии 8.11.8 добавлена поддержка WorldGuard, которая защищает сервер от злоупотреблений кастомными энкаунтами, учитывая флаги: pvp, damage_animals и potion_splash. С версии 8.12.1 плагин совместим с Towny, уважая защиты поселений, а также с ProtocolLib, что решает проблему "Too Expensive" при использовании алтарей. Также плагин совместим с ExcellentEnchants, позволяя отображать кастомные эффекты вместе с энкаунтами этой библиотеки в столах энкаунтов.

API для разработчиков и кастомные энкаунты

Для создателей серверов, желающих создать уникальные механики, UberEnchant предоставляет Custom Enchantment API. Это позволяет разработчикам создавать собственные энкаунты и эффекты, используя стандартные методы плагина. Документация (JavaDocs) и пример кода доступны на GitHub. API позволяет гибко расширять функционал плагина, добавляя новые типы энкаунтов, эффекты или изменяя поведение существующих. Это делает плагин не просто инструментом для наложения энкаунтов, а платформой для создания уникальных игровых механик, таких как энкаунты, применяющиеся только при выстреле из лука или при блокировании врагов щитом.

Ограничения и важные предупреждения

Несмотря на мощные возможности, плагин имеет ряд ограничений, о которых необходимо знать. Энкаунты не сохраняются на предметах, если они были помещены в инвентарь или использованы. Это означает, что предметы с энкаунтами из плагина должны храниться в специальных контейнерах или выдаваться игрокам напрямую. Также важно помнить, что при использовании алтарей с длинными названиями (>50 символов) лишние символы отрезаются, а при изменении названия на алтаре длинное имя теряется. Для применения эффектов зелий на предметы необходимо держать предмет в руке (с версии 8.10.0). Плагин также собирает статистику через Plugin Metrics, BStats и FastStats, что может быть отключено в конфигурации, если это необходимо.

Автор: coltonj96 · Лицензия: MIT