aMenus

What is aMenus?

aMenus is a visual, in-game GUI menu creator for Paper servers. Everything — item placement, display names, lore, click actions, requirements, currencies — is configured through in-game GUI editors while you're inside your server.

No documentation needed to get started. No syntax to memorize. No files to manually edit.

Core Features

🖥️ Visual Drag & Drop Editor

Open /amenus edit <menu> and your menu appears in front of you — live and interactive.

• Drag items directly from your inventory into any slot
• Click any slot to open its full options panel
• Set display names, write lore, toggle glowing, configure skull textures
• See your changes reflected instantly — no reload required

🖱️ Per-Click-Type Action Chains

Every slot supports four completely independent action lists — one per click type.

All supported action types:

RUN_COMMAND              Run a command as the player
RUN_COMMAND_CONSOLE      Run a command as the server console
MESSAGE                  Send a formatted chat message
SOUND                    Play a sound effect
OPEN_MENU                Open another aMenus menu
CLOSE_MENU               Close the current menu
SERVER_CONNECT           Connect to a BungeeCord / Velocity server
VAULT_PURCHASE           Deduct Vault money and run a reward command
COINS_ENGINE_PURCHASE    Deduct any CoinsEngine currency
PLAYER_POINTS_PURCHASE   Deduct PlayerPoints

💰 Multi-Currency Support

Charge players using Vault, CoinsEngine (any named currency — gems, tokens, crystals), or PlayerPoints. Each purchase action deducts the configured amount and fires a reward command on success. Players who can't afford it get a clear feedback message. No silent failures.

🔒 Visual Requirement Editor

Gate any action behind conditions — configured entirely inside a GUI, no files needed:

👁️ View Requirements & Fallback Items

Set a visibility condition on any slot. Players who don't meet it see a fallback item — or nothing at all. Perfect for showing locked vs. unlocked content without writing any extra logic.

✨ Slot Animations

Configure any slot to cycle through multiple item frames at a configurable tick interval. Animations are synchronized automatically for every player viewing the menu.

🎨 Layout & Border Presets

One-click geometric patterns — stop clicking 36 slots individually:

🧩 Custom Item Support

Running a custom item plugin? Drag your item directly into any menu slot. aMenus detects the item ID automatically and stores it. Every player who opens the menu sees the correct custom texture — no setup required.

oraxen:item_id  |  nexo:item_id  |  itemsadder:namespace:item_id  |  ia:item_id

⚡ Dynamic Command Aliases

Set /shop, /warp, /hub — or any command — as a menu opener directly from the editor. Aliases register at runtime. No server restart needed.

🔬 Live Simulation Preview

Test your menu as a player before it goes live. Evaluates PlaceholderAPI placeholders with your real values and checks requirements against your actual permissions and balance. Catch issues before your players do.

📦 DeluxeMenus Importer

Already have menus built in DeluxeMenus?

/amenus import <filename>

Materials, slot positions, lore, and click commands carry across automatically.

🛡️ Exploit-Proof by Design

• 250ms click cooldown — prevents GUI spam and item duplication exploits
• Server-side event cancellation — all inventory interactions cancelled before client processing
• PersistentDataContainer tagging — no lore-based item detection that can be faked
• Async saves — zero TPS impact when writing data to disk on busy servers

Commands

Permissions

Compatibility

All integrations are soft-depend — aMenus runs perfectly with none of them installed.