VaultUnlocked

Плагин VaultUnlocked для Minecraft 1.21.11

Что такое VaultUnlocked?

VaultUnlocked — это современная вилка (fork) оригинального плагина Vault, созданная автором creatorfromhell. Основная цель проекта — упростить разработчикам процесс подключения плагинов к системам управления правами (permissions), чатом и экономикой. Вместо того чтобы каждый раз вручную подключаться к конкретному плагину, VaultUnlocked предоставляет единый интерфейс, скрывающий сложность внутренней реализации. Это решение возникло как ответ на недостатки существующих API, таких как Register, которые часто либо не обладают необходимыми функциями, либо слишком сложны в настройке.

Улучшенная функциональность

Главное отличие VaultUnlocked от оригинального Vault заключается в расширенном наборе возможностей, особенно для плагинов, реализующих обновлённый API. Проект активно развивается и предлагает ряд улучшений, делающих его более мощным и гибким инструментом для администраторов и разработчиков. Среди ключевых преимуществ — поддержка мультивалюты, улучшенная совместимость с популярными системами и полная интеграция с продвинутыми серверными фреймворками, такими как Folia.

Поддержка мультивалюты

Одной из наиболее значимых нововведений является поддержка работы с несколькими валютами одновременно. Эта функция критически важна для серверов со сложной экономической системой, где различные регионы, фракции или игровые режимы могут использовать разные типы денег. VaultUnlocked позволяет управлять этими системами через единый интерфейс, обеспечивая гибкость и точность при проведении экономических транзакций.

Точные расчёты с BigDecimal

Для обеспечения максимальной точности финансовых операций плагин использует поддержку класса BigDecimal. Это позволяет корректно обрабатывать большие числа и дробные значения, что особенно важно для экономик, где важны малые суммы или сложные проценты. Данная функция была добавлена благодаря вкладу разработчика LlmDl.

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

VaultUnlocked полностью поддерживает серверный фреймворк Folia, который известен своей высокой производительностью и масштабируемостью. Это позволяет плагинам, использующим VaultUnlocked, работать на серверах с тысячами игроков без потери эффективности. Также проект включает поддержку UUID (универсальных уникальных идентификаторов), что гарантирует стабильную идентификацию игроков даже при смене никнеймов. Поддержка UUID также была реализована благодаря LlmDl.

Улучшенная совместимость с Towny

Особое внимание уделено совместимости с популярным плагином Towny. VaultUnlocked обеспечивает более глубокую интеграцию, что минимизирует конфликты и улучшает взаимодействие между различными системами управления сервером. Это позволяет администраторам создавать более стабильные и cohesive игровые среды.

Настройка и права доступа

В конфигурации плагина есть опция update-check, которая позволяет включать или отключать проверку обновлений. Основное право доступа vault.admin предоставляет доступ к информации о Vault и командам конвертации валют. По умолчанию это право имеет привилегии для игроков с уровнем OP (оператора).

Сбор статистики bStats

Для аналитики VaultUnlocked использует сервис bStats, собирая метрики аналогично оригинальному Vault. Собираемые данные включают версию Java, режим работы сервера (offline/online), версию плагина, количество онлайн-игроков, используемые хуки чата, экономики и прав, а также версию операционной системы. Отключить сбор метрик можно, отредактировав файл plugins/bstats/config.yml и установив значение opt-out в true.

Лицензия и исходный код

Плагин распространяется под лицензией LGPLv3. Исходный код VaultUnlocked доступен на GitHub по адресу https://github.com/TheNewEconomy/VaultUnlocked. Отдельный репозиторий содержит сам API для разработчиков: https://github.com/TheNewEconomy/VaultUnlockedAPI. Для получения бейджа VaultUnlocked Economy плагину требуется пройти ревью, которое можно инициировать через тикет на GitHub.

Автор: creatorfromhell · Лицензия: LGPL-3.0-or-later