FAQ
Common questions, with a pointer to the page that has the full answer. Use the search box (top right) for anything not listed here.
Does AbstractMenus support YAML configs?
Section titled “Does AbstractMenus support YAML configs?”No. Only HOCON. Read HOCON format - if you know JSON, you already know 90% of HOCON.
Where can I use placeholders?
Section titled “Where can I use placeholders?”Almost anywhere: actions, rules, menu titles, item properties. If a parameter expects a number, the placeholder must resolve to a number; otherwise strings work.
My PlaceholderAPI placeholders don’t work
Section titled “My PlaceholderAPI placeholders don’t work”-
/am reload. -
Check that you downloaded the PlaceholderAPI expansion for the placeholders you use. For
%player_*%:/papi ecloud download Player/papi reload
Which plugins does AbstractMenus integrate with?
Section titled “Which plugins does AbstractMenus integrate with?”See the integrations list on the home page. Vault, PlaceholderAPI, LuckPerms, WorldGuard, Citizens, HeadDatabase, MMOItems, SkinsRestorer, ItemsAdder, Oraxen.
Two items in the same slot - which one wins?
Section titled “Two items in the same slot - which one wins?”The last item in the list whose rules the player matches. Use this on purpose for level-gated or permission-gated buttons.
How do I open a menu by command, item interaction, region enter, NPC click?
Section titled “How do I open a menu by command, item interaction, region enter, NPC click?”These are activators - one per file, multiple per menu. See activators.
How do I refuse to open the menu without a permission?
Section titled “How do I refuse to open the menu without a permission?”Put the check in the menu’s root rules, and a message in denyActions:
rules { permission: "i.am.admin" }denyActions { message: "&cNot allowed." }Different item appearance depending on rules?
Section titled “Different item appearance depending on rules?”That’s bindings. See bindings reference.
One item across many slots?
Section titled “One item across many slots?”Slot accepts a number, a range (0-8), or a matrix. See slot formats.
Skull with the viewer’s skin?
Section titled “Skull with the viewer’s skin?”skullOwner: "%player_name%"Items that refresh on a timer?
Section titled “Items that refresh on a timer?”updateInterval on the menu root. See auto-refresh.
AND / OR / NOT combinations of rules?
Section titled “AND / OR / NOT combinations of rules?”Yes - logical wrappers and rule inversion. See logical structures.
Persistent state shared between menus?
Section titled “Persistent state shared between menus?”Variables. Create / edit / delete via variable actions, read back via variable placeholders.
How do I install an addon?
Section titled “How do I install an addon?”Addons come in two flavours. Plugin-as-addons drop into plugins/ like any other Bukkit plugin. AM-loaded addons drop into plugins/AbstractMenus/addons/ and are managed via /am addons. See Addon delivery for the differences.
Multiple economy plugins — which one does AbstractMenus pick?
Section titled “Multiple economy plugins — which one does AbstractMenus pick?”The one you pin in config.conf:
providers { economy = "vault"}Set to "auto" (the default) to let priority decide — addons typically register at priority 100, the bundled Vault provider at 50, so addons win unless you pin Vault explicitly. Per-action overrides (provider: "..." inside HOCON) always beat the config default. See provider handlers.
Click cooldown vs click debounce — what’s the difference?
Section titled “Click cooldown vs click debounce — what’s the difference?”clickCooldown on an item is the menu author’s choice (e.g. “this button has a 2-second cooldown”). The server-wide clickDebounce floors are a safety net against duplicate-click packets the Minecraft client sends — they only kick in when clickCooldown > 0. Set clickCooldown: 0 on an item to bypass both. See installation.