PlayerBiomes

PlayerBiomes — это серверный плагин, который определяет текущий биом игрока с учётом локализации и кастомных биомов из datapacks.

Определение и локализация биома

Плагин PlayerBiomes позволяет игрокам узнавать название текущего биома в точности так, как оно отображается в клиенте Minecraft. Это обеспечивает корректную работу с кастомными биомами, созданными в datapacks, таких как Terralith или Incendium. Основное действие — использование команды /whatbiome для мгновенного получения названия биома. Также плагин отправляет персонализированные переводы названий биомов каждому игроку, что позволяет создавать уникальные игровые механики, зависящие от локации.

Команды управления

Для работы с плагин предоставляет две основные команды. Команда /whatbiome (также доступна как /whereami) отображает название текущего биома для исполнителя. По умолчанию для её выполнения требуется право доступа playerbiomes.command.whatbiome, которое включено по умолчанию. Вторая команда /playerbiomes reload (или /pb reload) используется для перезагрузки конфигурации и обновления кэша переводов. Для её выполнения необходимо право playerbiomes.command.reload, которое отключено по умолчанию.

Работа с локализацией и конфигурацией

Администратор может настроить отображение названий биомов для различных языковых регионов. Для этого в папке сервера внутри plugins/PlayerBiomes/ следует создать подпапку lang и поместить в неё файлы с расширением .json. Эти файлы содержат переводы названий биомов для конкретного лока. Плагин позволяет извлечь эти файлы из клиентского jar-архива Minecraft или загружать их на лету с внешних ресурсов. Загрузка файлов по умолчанию отключена, и её необходимо включить в конфигурационном файле config.yml, где также описаны остальные опции с комментариями.

PlaceholderAPI переменные

Плагин интегрируется с PlaceholderAPI, предоставляя набор переменных для вставки в плагины, плашки или чаты. Переменная %playerbiomes_biome_raw% возвращает полный namespaced ID биома, например minecraft:jungle или terralith:moonlight_grove. Для получения заглавной части названия без внутренних путей используется %playerbiomes_biome_name% (или вариант _english). Переменная %playerbiomes_biome_namespace% возвращает заглавное имя пространства имен (например, Terralith). Также доступны переменные %playerbiomes_biome_formatted% и %playerbiomes_biome_formatted_english% для вывода полного названия в формате 'Пространство: Название'.

Технические детали и библиотеки

Для корректной работы с версиями игры младше 1.19.3 плагин использует библиотеку JeffLib для получения namespaced ключей биомов. Сборка проекта возможна через Maven командой mvn install после клонирования репозитория. Статистика использования плагина собирается через bStats. Лицензия распространения — MIT, что позволяет свободно использовать и распространять плагин.