Главное меню /help

/help и /menu открывают одно и то же меню. /menu — команда HelgaShop, /help — алиас на неё в commands.yml в корне сервера. Меню целиком задаётся файлом plugins/HelgaShop/menu.yml.

Что в меню

Кнопка	Действие
Новичку	подменю: первые шаги, гайд, шпаргалка команд, голосовой чат, экономика, могилы, правила
Работы и экономика	подменю: /job, документация JobSystem, /job daily, bank, ah, marketplace, mayor, stats, /money, /baltop, подсказка про /pay
Дом и телепорты	подменю: /spawn, /rtp, /homes, подсказки про /sethome, /tpa и блок телепортов в бою
Приват и PvP	подменю: ссылка на гайд, /claimslist, подсказки про trust, abandonclaim, где работает PvP
Мини-игры	подменю: /hg list, /hg free, подсказки про /hg и /duel, описания игр
Развлечения	подменю: /sit, /lay, /crawl, /pet gui, /case, подсказки про /skin и Emotecraft
Магазин	/shop
Гайд, голосовой чат, правила	ссылки на helgawind.ru
Discord, Telegram, Twitch	ссылки

Ссылки на сайт ведут на якоря разделов guide.html: #voice, #claim, #cmds, #economy, #homes, #pvp, #graves, #games, #fun. Если переименовываете раздел на сайте — поправьте и меню.

Как устроен menu.yml

title: "&d&lHELGAWIND"
rows: 4                          # 1–6 рядов
filler: GRAY_STAINED_GLASS_PANE  # чем заполнить пустые слоты, необязательно
buttons:
  jobs:
    slot: 11                     # 0 — левый верхний, 9 — начало второго ряда
    display: { name: "&6Работы", icon: IRON_PICKAXE, lore: ["&7строка"] }
    menu: jobs                   # действие
submenus:
  jobs:
    title: "&6&lРаботы"
    rows: 4
    buttons:
      back: { slot: 31, display: { name: "&eНазад", icon: OAK_DOOR }, menu: main }

У каждой кнопки ровно одно действие:

Ключ	Что делает
command: job daily	выполняет команду от имени игрока (без /), меню закрывается
url: "https://..."	присылает в чат кликабельную ссылку
menu: jobs	открывает подменю из submenus; main — главное меню
message: [...]	присылает строки в чат — для команд с аргументами (/tpa ник), которые кнопкой не выполнить

Цвета — &-коды. Подменю внутри подменю не поддерживаются: все страницы лежат в одном разделе submenus, но кнопки любой страницы могут вести на любую другую.

Правка и проверка

1. Поправить plugins/HelgaShop/menu.yml на хостинге (раздел «Файлы»).
2. В игре: /shopadmin reload.
3. Если в ответе есть строки menu.yml: ... — это ошибки. Кнопка с ошибкой не появится, остальное меню работает. Если ошибка фатальная (сломан YAML, неверный rows главного меню), остаётся старое меню.
4. Открыть /help обычным игроком (не OP) и прокликать новые кнопки. Кнопка с командой, на которую у группы default нет прав, выдаст игроку «нет прав» — проверяйте под обычным аккаунтом.

Типичные ошибки:

• «слот N уже занят» — две кнопки на одном слоте одной страницы;
• «slot должен быть от 0 до …» — слот больше, чем rows × 9 − 1;
• «нет подменю X» — menu: ссылается на страницу, которой нет в submenus;
• «нужно ровно одно из command, url, menu или message» — у кнопки нет действия или их два;
• «url должен начинаться с http:// или https://», «пустая команда», «пустое сообщение» — кнопка не появится;
• «filler: …» — неизвестный предмет-заполнитель, страница загрузится без заполнения;
• «Подменю X: rows должен быть от 1 до 6» — подменю целиком не загружено. Кнопки, которые в него вели, тоже убираются («кнопка Y: подменю X не загружено»), остальное меню работает;
• «Подменю main: имя занято главным меню» — подменю нельзя назвать main.

Обновление плагина

Плагин создаёт menu.yml только если файла нет. После обновления HelgaShop-1.0.0.jar старый файл на хостинге остаётся как был — новую версию нужно загрузить вручную. Исходник — plugins-src/helgashop/src/main/resources/menu.yml, сборка — mvn package в plugins-src/helgashop.

Подменю, кнопки menu/message и filler появились в версии из коммита 1368559 (октябрь 2026). Проверенная сборка вместе с событием покупок для аналитики лежит в plugins-src/HelgaAnalytics/dist/HelgaShop-1.0.0.jar — см. «Аналитика игроков». Старый jar новое меню не прочитает: кнопки с menu/message будут ошибками «нужно ровно одно из command или url». Поэтому jar и menu.yml выкладываются вместе.