Quick Mod

Меню-инструментарий для админов. Само меню закрыто на верхнем уровне через rules: ${rulesAdmin} - не-админам, которые ввели /ame_mod, оно вообще не откроется (не нужно навешивать правила на каждый клик отдельно).

средний

Фичи: menu-level-rulessetGamemodebroadcastcommand-actionopenMenu-chain

Открыть: /ame_mod Скопировать

menu.conf

# Quick Mod - меню для админов с частыми модераторскими командами
# Docs: https://abstractmenus.github.io/docs/ru/examples/admin-tools/quick-mod
# Open: /ame_mod  (только для админов)
# Requires: любой плагин с командами /kick /ban /mute /gamemode

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

title: "&cБыстрые инструменты модератора"
size: 3

# Доступ на уровне меню - не-админы вообще не смогут его открыть.
rules: ${rulesAdmin}

activators {
  command: "ame_mod"
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }

  {
    slot: 4
    material: NETHER_STAR
    name: "&c&lБыстрые инструменты модератора"
    lore: ["&7Частые модераторские действия.", "&8Только для админов."]
  }

  # ========== Переключение режимов игры ==========
  {
    slot: 10
    material: GRASS_BLOCK
    name: "&aВыживание"
    lore: ["&7Переключить себя в режим выживания."]
    click {
      actions {
        setGamemode: "SURVIVAL"
        sound: ${clickSound}
        message: "&aРежим: SURVIVAL"
      }
    }
  }
  {
    slot: 11
    material: DIAMOND_PICKAXE
    name: "&aТворчество"
    flags: HIDE_ATTRIBUTES
    lore: ["&7Переключить себя в творческий режим."]
    click {
      actions {
        setGamemode: "CREATIVE"
        sound: ${clickSound}
        message: "&aРежим: CREATIVE"
      }
    }
  }
  {
    slot: 12
    material: ENDER_EYE
    name: "&aНаблюдатель"
    lore: ["&7Переключить себя в режим наблюдателя."]
    click {
      actions {
        setGamemode: "SPECTATOR"
        sound: ${clickSound}
        message: "&aРежим: SPECTATOR"
      }
    }
  }

  # ========== Браузер игроков ==========
  {
    slot: 14
    material: PLAYER_HEAD
    name: "&aСписок онлайн-игроков"
    lore: ["&7Открыть меню онлайн-игроков", "&7для кика и телепорта."]
    click { openMenu: "ame_online" }
  }

  # ========== Серверные действия ==========
  {
    slot: 15
    material: TNT
    name: "&cОбъявление: рестарт сервера"
    lore: ["&7Отправить предупреждение в чат."]
    click {
      actions {
        broadcast: "&c[Админ] &fРестарт сервера через 5 минут. Сохраните прогресс."
        sound: ${successSound}
      }
    }
  }
  {
    slot: 16
    material: COMPASS
    name: "&aТелепорт на спавн"
    lore: ["&7Выполнить /spawn для себя."]
    click {
      actions {
        command {
          player: "spawn"
        }
        sound: ${clickSound}
        closeMenu: true
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# 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 ↓ Бандл (.zip)

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

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

• Правила на уровне меню: верхнеуровневый rules: ... блокирует открытие, а не просто прячет предметы
• Действие setGamemode со стандартными именами режимов
• Действие broadcast для сообщений на весь сервер
• Действие command с player: (от имени игрока) против console: (от имени консоли)
• Цепочка хабов: это админ-меню открывает Онлайн-игроков для более точечной модерации

Правила на меню vs на предмете

Закрыть доступ можно двумя способами:

На уровне меню (этот пример):

rules: ${rulesAdmin}

В начале файла. Если правило не проходит при срабатывании активатора, меню вообще не откроется.

На уровне предмета:

{
  slot: 4
  ...
  click {
    rules { permission: "..." }
    actions { ... }
  }
}

Внутри блока click у конкретного предмета. Меню открывается всем, но отдельные предметы под правилами.

Для админ-инструментария правильный выбор - на уровне меню: не-админам не нужно даже видеть раскладку. Для магазина с VIP-предметами правильный выбор - на уровне предмета: видеть ассортимент должны все.

Действие command

command запускает серверные команды через обработчик действий:

command {
  player: "spawn"           # запускает /spawn от имени игрока
}

Или от консоли:

command {
  console: "kick %ctg_player_name%"   # запускает /kick ... от имени консоли
}

Форма player: уважает права игрока - у него должно быть разрешение на эту команду. Форма console: обходит проверки прав (используйте аккуратно). Для админских команд вроде /ban лучше брать console: из меню, уже закрытого по правам, чтобы не перепроверять авторизацию дважды.

Попробовать

1. Положите бандл в plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Выдайте себе abstractmenus.admin (общий шаблон rulesAdmin ссылается на этот узел).
4. Введите /ame_mod в игре.