Переменные
Переменная в AbstractMenus - это любые данные, которые хранятся в памяти и доступны через плейсхолдеры.
Сохранять и редактировать их можно через действия или админские команды. Переменные бывают глобальные и персональные.
Глобальная переменная
Доступна из любого места, лежит в глобальном пространстве.
Персональная переменная
Привязана к игроку - у каждого игрока своё значение.
Именование переменных
Заголовок раздела «Именование переменных»В именах используй только латиницу и _. С другими символами плейсхолдер может сломаться.
Операции с переменными
Заголовок раздела «Операции с переменными»Переменные можно создавать, менять, удалять и (если они числовые) выполнять с ними арифметику. Все операции расписаны на странице Действия с переменными.
Временные переменные
Заголовок раздела «Временные переменные»По умолчанию переменная живёт, пока её не удалят. Но можно делать и временные - они исчезают сами через заданное время. Как их создавать - в разделе Временная переменная.
Оставшееся время жизни тоже можно прочитать - через специальные плейсхолдеры из таблицы ниже.
Доступ к переменным
Заголовок раздела «Доступ к переменным»Значение переменной достаётся плейсхолдером. Работает и без PlaceholderAPI, но с PAPI лучше. Список плейсхолдеров для переменных - ниже.
< >
Обязательный аргумент.
[ ]
Необязательный аргумент.
| Плейсхолдер | Описание | Пример |
|---|---|---|
| %var_:<variable_name>[:<default_value>]% | Получить значение глобальной переменной | %var_:myvar% %var_:myvar:No% |
| %varp_:<variable_name>[:<default_value>]% | Получить значение персональной переменной игрока, открывшего меню | %varp_:myvar% %varp_:myvar:No% |
| %var_:<player>.<variable_name>[:<default_value>]% | Получить значение персональной переменной по имени игрока | %var_:Notch.myvar% %var_:Notch.myvar:No% |
| %vart_:<variable_name>% | Время жизни глобальной временной переменной. Если переменная не временная, вернёт 0 секунд | %vart_:myvar% %vart_:another_var% |
| %varpt_:<variable_name>% | Время жизни персональной временной переменной. Если переменная не временная, вернёт 0 секунд | %varpt_:myvar% %varpt_:another_var% |
Значение по умолчанию - это текст или число, которое плейсхолдер подставит, если переменной нет. Без значения по умолчанию плейсхолдер для несуществующей переменной заменится пустой строкой.
Синхронизация переменных
Заголовок раздела «Синхронизация переменных»Если у тебя несколько серверов под BungeeCord, переменные можно синхронизировать между всеми серверами, где стоит плагин. По умолчанию выключено - включается в конфиге через syncVariables: true и bungeeCord: true.