Онлайн-игроки

Главный сценарий для GeneratedMenu: постраничный браузер онлайн-игроков. Каждая голова собирается автоматически из каталога PLAYERS, в lore - здоровье и мир. ЛКМ телепортирует админа к игроку, Shift+ЛКМ кикает. Доступ ограничен админами через общий сниппет rulesAdmin.

Чему учит пример

Сборка генерируемого меню из каталога + матрицы + шаблонов
Использование плейсхолдеров каталога (%ctg_player_name%, %ctg_player_health%, %ctg_player_world%)
Различение типов кликов: click { left { ... } shift_left { ... } }
Действие command с console: для запуска команд от имени консоли
Встроенная пагинация через pageNext / pagePrev (общие ${buttonNext} и ${buttonPrev})
Плейсхолдеры пагинации: %page%, %pages_count%, %pages_total%
Ограничение доступа на уровне меню: верхнеуровневое rules: ${rulesAdmin}

menu.conf
_shared/templates.conf

# Онлайн-игроки - сгенерированное меню-каталог онлайн-игроков с админскими действиями
# Docs: https://abstractmenus.github.io/docs/ru/examples/admin-tools/online-players
# Open: /ame_online
# Requires: -

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Онлайн-игроки (страница %page% / %pages_count%)"
size: 6

# Ограничиваем доступ - только для админов.
rules: ${rulesAdmin}

activators {
  command: "ame_online"
}

# Подтягиваем онлайн-игроков как записи каталога. Каждая запись даёт плейсхолдеры %ctg_player_*%.
catalog {
  type: PLAYERS
}

# Сетка 7 в ширину из голов игроков с рамкой. 4 ряда по 7 = 28 голов на странице.
matrix {
  cells: [
    "_________"
    "_xxxxxxx_"
    "_xxxxxxx_"
    "_xxxxxxx_"
    "_xxxxxxx_"
    "_________"
  ]

  templates {
    "x" {
      material: PLAYER_HEAD
      skullOwner: "%ctg_player_name%"
      name: "&e%ctg_player_name%"
      lore: [
        "&7Здоровье: &c%ctg_player_health%"
        "&7Мир: &b%ctg_player_world%"
        ""
        "&aЛКМ        - телепорт к игроку"
        "&cShift+ЛКМ  - кикнуть игрока"
      ]
      click {
        left {
          actions {
            command {
              console: "tp %player_name% %ctg_player_name%"
            }
            sound: ${clickSound}
            closeMenu: true
          }
        }
        shift_left {
          actions {
            command {
              console: "kick %ctg_player_name% &cКикнут админом"
            }
            sound: ${successSound}
            refreshMenu: true
            message: "&aКикнут &e%ctg_player_name%"
          }
        }
      }
    }
  }
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "45-53" }

  # Кнопки пагинации - показываются только когда страниц больше одной.
  ${buttonPrev} { slot: 48 }
  ${buttonNext} { slot: 50 }

  # Счётчик страниц (только для информации)
  {
    slot: 49
    material: PAPER
    name: "&eСтраница %page% / %pages_count%"
    lore: ["&7Всего онлайн: &e%pages_total%"]
  }

  ${buttonClose} { slot: 53 }
]

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf

Бандл включает _shared/templates.conf и INSTALL.txt.

Как устроен GeneratedMenu

Генерируемое меню собирается из трёх блоков:

catalog { type: PLAYERS }                  # источник динамического содержимого

matrix {                                   # как разложить элементы
  cells: [ "_________", "_xxxxxxx_", ... ]
  templates {
    "x" { ... шаблон предмета ... }
  }
}

items: [                                   # статичные предметы (рамки, кнопки, счётчик)
  ...
]

Каталог выдаёт поток объектов. Матрица решает, куда какой объект каталога попадёт (ячейки x поочерёдно занимают записи из каталога). Статичные предметы из items: рендерятся на каждой странице на одних и тех же местах.

Плейсхолдеры каталога

Внутри шаблонов матрицы текущий объект каталога доступен через %ctg_<key>%. У каталога PLAYERS объект игрока имеет ключи name, health, food_level, world, gamemode и ещё несколько. У разных типов каталогов - разные ключи, полную таблицу смотрите в документации по генерации.

Типы кликов

Блок click позволяет задать обработчики на конкретный тип нажатия:

left { ... } - только ЛКМ
right { ... } - только ПКМ
shift_left { ... } - Shift + ЛКМ
shift_right { ... } - Shift + ПКМ
drop { ... } - клавиша дропа (Q)

Если описан только один вариант клика, остальные клики ничего не делают. В этом меню left отвечает за телепорт, а shift_left - за кик. Так обычный shift+ЛКМ не приведёт случайно к телепорту.

Пагинация

Генерируемые меню автоматически разбиваются на страницы, если в каталоге больше записей, чем влезает в матрицу. Действия pageNext и pagePrev переключают страницы. Общие шаблоны ${buttonNext} и ${buttonPrev} уже навешивают эти действия на стрелки.

Если меню умещается на одну страницу (записей в каталоге меньше, чем слотов в матрице), кнопки next/prev всё равно отрисуются, но их действия станут no-op.

Плейсхолдеры %page%, %pages_count% и %pages_total% показывают состояние пагинации - удобно для заголовков вида “Страница 2 / 5” или счётчика в футере.

Кастомизация

Чтобы оставить только часть игроков, добавьте фильтры в каталог:

catalog {
  type: PLAYERS
  filters {
    permission: "myserver.online_visible"
    notWorld: ["staff_world"]
  }
}

Чтобы добавить ещё админских действий, расширьте блок click хендлерами right, shift_right и т.д. - каждый со своей командой через действие command.

Чтобы полностью поменять источник данных (просматривать миры, регионы, BungeeCord-серверы), замените catalog { type: ... } на WORLDS, BUNGEE_SERVERS или любой другой зарегистрированный тип каталога.

Попробовать

После установки набора примеров:

Положите бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Убедитесь, что у вашей учётки есть право abstractmenus.admin.
Введите /ame_online в игре.
ЛКМ по голове игрока - телепорт. Shift+ЛКМ - кик.