Плагин для серверов Майнкрафт, который позволяет создавать собственные переменные PlaceholderAPI без написания Java-плагина. Через YAML-конфиги можно выводить статистику, ранги, состояния событий, прогресс игроков и общие данные сервера.
Возможности
- Статические переменные с текстом, цветами и вложенными плейсхолдерами PlaceholderAPI.
- Условные переменные: числовые и текстовые сравнения, проверки прав и миров, регулярные выражения, поиск начала или части текста.
- Вычисляемые переменные с операторами
+,-,*,/,%,^и функциямиmin(),max(),abs(),round(),floor(),ceil(),sqrt(). - Форматирование чисел: число знаков после запятой, округление, разделители тысяч, префиксы, суффиксы и значение при ошибке.
- Постоянные данные игрока и общие для сервера значения: очки событий, репутация, валюта, статистика, названия сезонов и состояние мероприятий.
- Значения игроков сохраняются по UUID в SQLite и остаются после перезапуска сервера.
- Переменные могут ссылаться друг на друга и на плейсхолдеры PlaceholderAPI.
- YAML-файлы в папке
plugins/PlexVariables/variables/, включая вложенные папки, находятся автоматически. - Защита от циклических ссылок, чрезмерной вложенности и сложных выражений; при неудачной перезагрузке продолжает работать предыдущая корректная конфигурация.
Команды
/pv help— список справки./pv list [page]— список переменных./pv reload— перезагрузить конфигурацию./pv parse <player|--null> <text>— обработать текст с плейсхолдерами./pv test <player|--null> <variable>— проверить вычисление переменной./pv get <variable> [player|global]— получить сохранённое значение./pv set <variable> <player|global> <value>— установить значение./pv add <variable> <player|global> <amount>— прибавить число к значению./pv reset <variable> <player|global>— сбросить значение.
Альтернативные команды: /plexvariables, /plexvar, /pvar, /pv.
Настройка
Обычный плейсхолдер имеет вид %plexvar_<variable>%, например %plexvar_player_gems%. Для общего значения сервера также подходит формат %plexvar_global_<variable>%.
Постоянная переменная игрока задаётся с type: stored и scope: player, а общая — с scope: global. Условия проверяются сверху вниз: используется первое совпавшее условие.
Требования
Нужны Paper, Java 21 и PlaceholderAPI. Если в переменных используются плейсхолдеры другого плагина или расширения PlaceholderAPI, этот источник также должен быть установлен.
