Шпаргалка

Автор меню

Справочник на одну страницу. Имена, краткие описания и ссылка на полную документацию по каждому пункту. Удобно искать через Ctrl-F.

Активаторы - что открывает меню

Название	Что делает	Подробнее
command	/menu или любая другая кастомная команда	docs
chat	Игрок пишет в чат точную фразу	docs
containsChat	Сообщение игрока в чате содержит подстроку	docs
join	Игрок зашёл на сервер	docs
regionJoin	Игрок вошёл в регион WorldGuard	docs
regionLeave	Игрок вышел из региона WorldGuard	docs
clickItem	ПКМ по предмету в руке	docs
clickNPC	ПКМ по NPC из Citizens	docs
clickEntity	ПКМ по сущности	docs
shiftClickEntity	Shift + ПКМ по сущности	docs
clickBlock	Клик по блоку в конкретной локации	docs
clickBlockType	Клик по любому блоку заданного типа	docs
button	Нажатие кнопки	docs
lever	Переключение рычага	docs
plate	Наступание на нажимную плиту	docs
table	Клик по табличке с конкретным текстом	docs
swapItems	Нажатие клавиши смены руки (по умолчанию F)	docs

Правила - проверяются перед открытием/показом предмета/запуском действия

Название	Что проверяет	Подробнее
permission	У игрока есть право	docs
world	Игрок в указанном мире	docs
gamemode	Режим игры игрока совпадает	docs
group	Игрок в группе LuckPerms	docs
money	У игрока хотя бы N валюты (Vault/настроенный провайдер)	docs
level	У игрока хотя бы N уровней	docs
xp	У игрока хотя бы N XP	docs
health	У игрока хотя бы N HP	docs
foodLevel	У игрока хотя бы N еды	docs
chance	Случайная проверка с шансом N процентов	docs
online	На сервере хотя бы N игроков	docs
playerIsOnline	Конкретный игрок онлайн	docs
inventoryItems	У игрока в инвентаре есть указанные предметы	docs
heldItem	Предмет в основной руке совпадает	docs
freeSlot	В инвентаре есть свободный слот (или конкретный слот свободен)	docs
freeSlotCount	В инвентаре хотя бы N свободных слотов	docs
existVar	Глобальная переменная существует	docs
existVarp	Персональная переменная существует	docs
placedItem	В drag-and-drop слоте лежит ожидаемый предмет	docs
region	Игрок внутри региона WorldGuard	docs
bungeeOnline	На BungeeCord-сервере хотя бы N игроков	docs
bungeeIsOnline	BungeeCord-сервер онлайн	docs
if	Логическое сравнение плейсхолдеров/значений	docs
js	Выполнить JavaScript-выражение	docs
and	Все вложенные правила выполнены	docs
or	Хотя бы одно вложенное правило выполнено	docs
oneof	Останавливается на первом true	docs
playerScope	Перепроверить правила относительно другого игрока	docs

Действия - что выполняется по клику/открытию/срабатыванию активатора

Название	Что делает	Подробнее
message	Отправить игроку чат/actionbar/title/json	docs
broadcast	Тот же формат, что и message, но всем онлайн	docs
miniMessage	Отправить MiniMessage-строку (legacy - message уже поддерживает MiniMessage)	docs
playerChat	Отправить сообщение в чат от лица игрока	docs
print	Печать в консоль - помощник для отладки	docs
command	Выполнить команды от лица игрока и/или консоли	docs
inputChat	Захватить ввод из чата в переменную	docs
teleport	Телепортировать игрока в локацию	docs
bungeeConnect	Отправить игрока на BungeeCord-сервер	docs
setGamemode	Сменить режим игры	docs
setHealth	Установить здоровье	docs
setFoodLevel	Установить уровень еды	docs
sound	Проиграть Bukkit-звук	docs
customSound	Проиграть звук из ресурспака	docs
potionEffect	Наложить эффект зелья	docs
removePotionEffect	Снять эффект зелья	docs
openBook	Открыть виртуальную книгу	docs
addRecipe	Добавить рецепт-знание	docs
itemAdd	Добавить предметы в инвентарь игрока	docs
itemRemove	Удалить предметы по слоту или совпадению	docs
itemClear	То же, что itemRemove, без учёта количества в стаке	docs
inventoryClear	Очистить инвентарь игрока	docs
openMenu	Открыть другое меню	docs
openMenuCtx	Открыть другое меню с передачей контекста активатора	docs
closeMenu	Закрыть текущее меню	docs
refreshMenu	Перерисовать всё меню	docs
refreshItem	Перерисовать один предмет	docs
setProperty	Добавить или перезаписать свойства предмета в открытом меню	docs
remProperty	Удалить свойства у предмета в открытом меню	docs
setButton	Добавить или заменить кнопку в открытом меню	docs
removeButton	Удалить кнопку из открытого меню	docs
placeItem	Drag-and-drop помощник: положить предмет в перетаскиваемый слот	docs
removePlaced	Удалить (или частично удалить) положенный предмет	docs
pageNext/pagePrev	Листание страниц в генерируемом меню	docs
delay	Запустить вложенные действия через N тиков	docs
bulk	Запустить несколько групп действий в одном блоке	docs
randActions	Случайно выбрать один блок	docs
playerScope	Запустить действия для другого игрока	docs
takeMoney/giveMoney	Снятие/зачисление валюты (провайдер экономики)	docs
givePermission/removePermission	Выдать/отозвать право (провайдер прав)	docs
addGroup/removeGroup	Добавить/убрать группу (провайдер прав)	docs
lpMetaSet/lpMetaRemove	Изменение метаданных LuckPerms (нужен LuckPerms)	docs
giveXp/takeXp	Зачисление/списание XP (провайдер уровней)	docs
giveLevel/takeLevel	Зачисление/списание уровней (провайдер уровней)	docs
setSkin/resetSkin	Установить/сбросить скин (провайдер скинов)	docs
setVar/removeVar/incVar/decVar/mulVar/divVar	Операции с глобальными переменными	docs
setVarp/removeVarp/incVarp/decVarp/mulVarp/divVarp	Операции с персональными переменными	docs

Если действие связано с деньгами/уровнями/правами/плейсхолдерами/скинами, можно дописать provider: "vault" (или любой другой зарегистрированный id), чтобы зафиксировать, какой бэкенд это обработает. См. хендлеры провайдеров.

Свойства предметов

Группа	Свойства
Установщик материала	material, texture, skullOwner, hdb, mmoitem, itemsAdder, oraxen, equipItem, serialized
Отображение	name, lore, nameLight, loreLight, glow, flags, color, model
Механика	count, damage, data, unbreakable, enchantments, enchantStore, attributeModifier, potionData, fireworkData, bookData, bannerData, shieldData, recipes, nbt
Слот	slot (число, X-Y, диапазон, матрица)
Кулдаун	clickCooldown (миллисекунды)
Условные	bindings (переопределение свойств при срабатывании правил)

Полная документация с примерами: формат предмета.

nameLight/loreLight - это legacy-варианты name/lore, которые игнорируют MiniMessage и обрабатывают только цветовые коды через &. Полезно, когда в имени есть символы <, которые MiniMessage попытается разобрать.

Каталоги - для генерируемых меню

Название	Что выдаёт	Подробнее
iterator	Последовательность целых чисел от start до end	docs
players	Игроков онлайн	docs
entities	Сущности из мира зрителя (или указанного)	docs
worlds	Загруженные миры	docs
bungee_servers	Серверы BungeeCord (требует bungeecord: true)	docs
slice	Разбивает строку на элементы по разделителю	docs

Команды - для оператора и автора меню

Команда	Назначение	Подробнее
/am open <menu> [player]	Открыть меню	docs
/am reload	Перезагрузить все файлы меню	docs
/am serve	Следить и автоперезагружать (для разработки)	docs
/am version	Вывести версию	docs
/am addons list	Список загруженных аддонов	docs
/am addons info <name>	Метаданные аддона	docs
/am addons load <name>	Загрузить аддон	docs
/am addons reload <name>	Hot-reload аддона	docs
/am addons rescan	Подхватить новые jar в addons/	docs
Подкоманды /var	Управление глобальными переменными	docs
Подкоманды /varp	Управление персональными переменными	docs

Всё ограничено одним правом: am.admin.