WolfyUtils

WolfyUtils (иногда ищут как ВольфиУтилс) - это базовое ядро и набор утилит для разработчиков плагинов под Spigot. Если вы обычный игрок, то этот плагин сам по себе ничего не делает в игре. Он работает как фундамент для других проектов, таких как CustomCrafting. Разработчики используют его, чтобы не писать один и тот же код с нуля, оптимизируя работу сервера и ускоряя создание сложных систем.

API и утилиты WolfyUtils

По факту ядро делится на три части: зависимое от плагина API, независимые утилиты (Utils) и глобальный реестр (Registry).

Основные API

• Inventory - функциональное API для создания внутриигровых меню (GUI). Позволяет разработчикам собирать сложные интерфейсы без куч бойлерплейт-кода.
• Language - система мультиязычности. Грузит JSON-файлы с переводами, что критически важно для крупных серверов с игроками из разных стран.
• Chat - отправка переводимых сообщений, кликабельные события в чате. Начиная с версии 3.16.1+ тут используется KyoriPowered/adventure, что делает чат намного гибче.
• Config - простые утилиты для конфигов.
• NMS - типобезопасный RecipeIterator и инструменты для работы с блоками и инвентарями.
• CustomItems - создание кастомных предметов. Можно задать свое топливо, прочность, действия и прочее. Для серверов с экономикой или кастомными механиками - просто находка.

Registry (Реестр)

Реестр - это база всего кастомного контента в WolfyUtils. Все объекты регистрируются под уникальными ключами (NamespacedKey). Это значит, что плагины могут легко обмениваться данными. Если один плагин создает предмет, другой может его вызвать и использовать.

Utils (Утилиты)

Тут лежат независимые инструменты, которые работают где угодно:

• NamespacedKey - уникальные ключи для всего регистрируемого контента.
• JSON - мощная обертка над Jackson. Сильно упрощает сериализацию и десериализацию данных. Есть поддержка HOCON (человеко-читаемый формат, удобнее YAML) и кастомные сериализаторы для объектов Bukkit.
• Particles - создание кастомных эффектов и анимаций частиц через JSON. Идеально для визуальных фишек на сервере.
• RandomCollection - коллекции с weighted random (выбор по весу). Полезно для лутбоксов и дропа с мобов.
• Reflection - базовые утилиты рефлексии.
• Player Head - работа с текстурами голов игроков.
• MySQL - базовое подключение к базе данных для выполнения запросов и обновлений.
• ItemBuilder - удобный паттерн для редактирования и создания ItemStacks.
• Сохранение данных игроков.

CustomCrafting и экосистема

Главный плагин, который построен на этом ядре - CustomCrafting. Он активно юзает InventoryAPI для создания внутриигрового редактора рецептов, а JSON утилиты нужны для сохранения и загрузки крафтов. Если вы ставите CustomCrafting на свой сервер Minecraft, WolfyUtils установится как зависимость.

Важный нюанс

Совет: если вы администратор и собираете сервер на плагинах вроде CustomCrafting, обращайте внимание на версию WolfyUtils. Разные сборки могут требовать разные версии ядра. И если у вас на сервере много кастомных предметов и сложных JSON-рецептов, лучше арендовать сервер Майнкрафт на BungeeHost. Плагин устанавливается туда в один клик, а стабильное железо легко потянет базу данных MySQL и сложные вычисления реестра без лагов.

Скачайте плагин WolfyUtils для Minecraft, если он требуется для работы других модулей вашей сборки, или если вы разработчик и хотите упростить себе жизнь при создании нового контента для Spigot.