TsunamiLib

TsunamiLib — это библиотека плагина от студии Voiid Studios, которая предоставляет набор общих утилит и систем для других плагинов, интегрирующихся с ней.

Назначение библиотеки

TsunamiLib (TL) — это библиотека плагина, разработанная студией Voiid Studios, которая предоставляет общие утилиты и системы для других плагинов, интегрирующихся с ней. Библиотека не добавляет игровой контент или самостоятельные функции на сервер. Вместо этого она обеспечивает переиспользуемую функциональность, позволяя зависимым плагинам использовать общие механизмы, сохраняя их согласованность между различными проектами. Если плагин зависит от TsunamiLib, он может работать некорректно без установленной библиотеки.

📚 Возможности библиотеки

Основные возможности проекта включают поддержку платформ Paper, Spigot и Folia, а также систему сообщений на основе YAML с поддержкой нескольких языков и префиксов для каждого плагина. Библиотека предоставляет компоненты интерфейса инвентаря (TsunamiGui) с поддержкой пагинации, прокрутки, интерфейсов хранения, конструкторов предметов и утилит NBT. Также реализована единая система структурированного логирования и функционал проверки обновлений для зависимых плагинов.

📦 Установка и совместимость

Для установки библиотеки необходимо скачать последнюю версию файла .jar и поместить его в папку plugins/ на сервере, после чего перезапустить сервер. TsunamiLib требует серверной среды и не поддерживается на стороне клиента. Плагин совместим с загрузчиками Bukkit, Folia, Paper, Purpur и Spigot, а также работает с версиями игры от 1.8 до 26.3.

⚡ Проекты, использующие TsunamiLib

Библиотека активно используется внутри студии Voiid Studios и планируется к интеграции в дополнительные проекты. Например, плагин WonderEvents с версии 26.10.0 требует TsunamiLib как обязательную зависимость. Также в разработке находится таймер обратного отсчета Voiid Countdown Timer, который будет переделан с использованием библиотеки для общей функциональности. Планируется интеграция в DynamicAPI, в то время как Waiting Screen и QuestMaster используют альтернативные реализации и не требуют TsunamiLib.

🛠️ Для разработчиков

Разработчики могут изучить документацию библиотеки через JDocs, где описаны доступные классы и методы. Исходный код проекта открыт и доступен для просмотра на GitHub. Лицензия MIT разрешает распространение и использование библиотеки в коммерческих и некоммерческих целях.