Quick Mod

A toolbox menu for admins. The menu itself is gated at the top level via rules: ${rulesAdmin} - non-admins running /ame_mod are blocked from opening at all (no need to gate every individual click).

intermediate

Features: menu-level-rulessetGamemodebroadcastcommand-actionopenMenu-chain

Open: /ame_mod Copy

menu.conf

# Quick Mod - admin-only menu of common moderation commands
# Docs: https://abstractmenus.github.io/docs/en/examples/admin-tools/quick-mod
# Open: /ame_mod  (admin only)
# Requires: any plugin that provides /kick /ban /mute /gamemode

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

title: "&cQuick Mod Tools"
size: 3

# Menu-level access gate - non-admins can't even open this menu.
rules: ${rulesAdmin}

activators {
  command: "ame_mod"
}

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

  {
    slot: 4
    material: NETHER_STAR
    name: "&c&lQuick Mod Tools"
    lore: ["&7Common moderation actions.", "&8Admin-only."]
  }

  # ========== Game mode shortcuts ==========
  {
    slot: 10
    material: GRASS_BLOCK
    name: "&aSet Survival"
    lore: ["&7Switch yourself to survival mode."]
    click {
      actions {
        setGamemode: "SURVIVAL"
        sound: ${clickSound}
        message: "&aGamemode: SURVIVAL"
      }
    }
  }
  {
    slot: 11
    material: DIAMOND_PICKAXE
    name: "&aSet Creative"
    flags: HIDE_ATTRIBUTES
    lore: ["&7Switch yourself to creative mode."]
    click {
      actions {
        setGamemode: "CREATIVE"
        sound: ${clickSound}
        message: "&aGamemode: CREATIVE"
      }
    }
  }
  {
    slot: 12
    material: ENDER_EYE
    name: "&aSet Spectator"
    lore: ["&7Switch yourself to spectator mode."]
    click {
      actions {
        setGamemode: "SPECTATOR"
        sound: ${clickSound}
        message: "&aGamemode: SPECTATOR"
      }
    }
  }

  # ========== Player browser ==========
  {
    slot: 14
    material: PLAYER_HEAD
    name: "&aBrowse online players"
    lore: ["&7Open the online players menu", "&7for kick / teleport actions."]
    click { openMenu: "ame_online" }
  }

  # ========== Server actions ==========
  {
    slot: 15
    material: TNT
    name: "&cBroadcast: server restart"
    lore: ["&7Send a chat-wide warning."]
    click {
      actions {
        broadcast: "&c[Admin] &fServer restart in 5 minutes. Save your work."
        sound: ${successSound}
      }
    }
  }
  {
    slot: 16
    material: COMPASS
    name: "&aTeleport to spawn"
    lore: ["&7Run /spawn for yourself."]
    click {
      actions {
        command {
          player: "spawn"
        }
        sound: ${clickSound}
        closeMenu: true
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/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: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# 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: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  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&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

Bundle includes _shared/templates.conf and INSTALL.txt.

What it teaches

• Menu-level rules: top-level rules: ... blocks the open instead of just hiding items
• The setGamemode action with vanilla mode names
• The broadcast action for server-wide chat
• The command action with player: (run as the player) vs console: (run as console)
• Chaining hubs: this admin menu opens Online Players for finer-grained moderation

Menu-level vs item-level rules

Two ways to gate access:

Menu-level (this example):

rules: ${rulesAdmin}

At the top of the file. If the rule fails when the activator fires, the menu doesn’t open at all.

Item-level:

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

Inside an item’s click block. The menu opens for everyone, but specific items are gated.

For an admin toolbox, menu-level is right - non-admins shouldn’t see the layout. For a shop with VIP items, item-level is right - everyone should see what’s available.

command action

command runs server commands via the action handler:

command {
  player: "spawn"           # runs /spawn as the player
}

Or as console:

command {
  console: "kick %ctg_player_name%"   # runs /kick ... from console
}

player: form respects the player’s permissions - they need to be allowed to use the command. console: form bypasses permissions (use carefully). For admin commands like /ban, prefer console: from a permission-gated menu to avoid double-checking the same auth twice.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Grant yourself abstractmenus.admin (the rulesAdmin shared template references this node).
4. Type /ame_mod in-game.