Smart Menus | #1 Advanced Custom GUI Menus, Conditions & Dynamic Inventories Folia & Bedrock Support

Smart Menus | #1 Advanced Custom GUI Menus, Conditions & Dynamic Inventories Folia & Bedrock Support -----

ChatGPT Image Jun 5, 2026, 08_09_19 PM (1).png

⚡ SmartMenus
The most powerful, feature-rich GUI plugin ever built for Minecraft.
Built on the legendary SmartInvs API — engineered to do what no other menu plugin can.

Why SmartMenus Destroys Every Other GUI Plugin

You've tried DeluxeMenus. You've tried ChestCommands. You've tried TrMenu. You've tried zMenu. They all hit a wall the moment your ideas get ambitious.

SmartMenus has no wall.

Every other GUI plugin was built for simple shops. SmartMenus was built for everything — shops, quest boards, rank upgrades, server selectors, dynamic player menus, sacrifice altars, full-screen GUIs that take over your entire inventory. If you can imagine it, SmartMenus can build it.

This is not just another menu plugin. This is the last menu plugin you will ever need.

⚙️ Built on SmartInvs — The Gold Standard of GUI APIs

SmartMenus is powered by SmartInvs, the most respected and widely-used GUI framework in the Minecraft ecosystem. SmartInvs gives SmartMenus a rock-solid foundation that lesser plugins simply don't have:

Tick-accurate rendering — items update on a per-tick basis without flicker or desync
Full inventory type support — CHEST, HOPPER, DISPENSER, FURNACE, BREWING STAND, CRAFTING, and more
Thread-safe state management — no inventory corruption under heavy load
Smooth pagination — native page-by-page navigation with zero boilerplate
Event-driven click handling — every click type (LEFT, RIGHT, SHIFT, MIDDLE, DOUBLE) captured cleanly

Every SmartMenus GUI is a SmartInvs-powered inventory under the hood. That means stability, performance, and flexibility that YAML-only GUI plugins simply cannot match.

FULL BEDROCK FORMS SUPPORT

SmartMenus 2.1 brings full native Bedrock/Geyser support the most requested feature since launch , every GUI you've already built can now automatically serve Bedrock players without touching a single config file.

Bedrock Support WITH Zero Extra Work??
YES ! existing Java GUIs can automatically convert into Bedrock forms
No need to rebuild menus
No duplicate configurations
Works seamlessly with Geyser
Floodgate detection supported automatically
Multiple Form Types
SmartMenus now supports:
Simple Forms
Modal Forms
Custom Forms
Dialogue Forms
Giving you complete control over the Bedrock experience.

Bedrock Actions:
Two new action types have been added:
* `OPEN_BEDROCK_FORM`
* `OPEN_BEDROCK_DIALOGUE`

Allowing you to open Bedrock-specific interfaces directly from buttons and actions.
Auto Conversion System
Simply enable auto conversion and SmartMenus will handle the rest.
Your Java GUI → Bedrock Form conversion happens automatically.

14 Button Types — More Than Any Other Plugin

Most GUI plugins give you clickable items. SmartMenus gives you a complete interactive system:

NONE — Standard clickable item with actions & conditions
INVENTORY — Open another GUI (with full navigation history)
BACK — Return to the previous GUI in the navigation stack
HOME / MAIN_MENU — Jump directly to the root menu from anywhere
NEXT / PREVIOUS — Page navigation with optional permanent display
JUMP — Skip directly to any page number
PAGINATION — Display a static list of items across multiple pages automatically
DYNAMIC_PAGINATION — Live server data rendered as clickable items (see below)
SWITCH — Multi-state toggle buttons driven by PlaceholderAPI or static keys
INPUT — Item slots players can drop items into, firing commands on placement
CHAT_INPUT — Prompts the player to type in chat, captures the response as a variable

No other free GUI plugin comes close to this feature depth.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Dynamic Pagination — Live Server Data as GUI Items

This is where SmartMenus truly separates itself. DYNAMIC_PAGINATION sources pull live data from your server and renders it as interactive items — automatically, in real time.

Built-in data sources:

ONLINE_PLAYERS — Render every online player as a skull item. Click to teleport, view stats, open admin menus — anything. Shows name, UUID, world, health, level, ping, gamemode.
WORLDS — All loaded worlds as clickable items. Show player count, time, difficulty. Click to teleport.
PLAYER_INVENTORY — Displays the viewer's own inventory as GUI items. With take-item: true, clicking removes the item. With give-item: true, clicking gives a copy.
PLAYER_ENDERCHEST — Same as above but for the ender chest. Combine take + give to move items from ender chest → main inventory with a click.
PERMISSION_GROUPS — All LuckPerms groups rendered as items. Perfect for rank upgrade menus.

Code (Text):

# Online players list — click a player to open admin actions
online-players:
type: DYNAMIC_PAGINATION
source: ONLINE_PLAYERS
slots: [ 10-16, 19-25, 28-34 ]
material: PLAYER_HEAD
name: "&e%player_name%"
lore:
- "&7World: &f%player_world%"
- "&7Level: &a%player_level%"
- "&7Ping: &b%player_ping%ms"
- ""
- "&eClick to teleport →"
click_actions:
LEFT:
- type: CONSOLE_COMMAND
command: "tp {player} %player_name%"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ Full-Screen GUIs — 90 Interactive Slots

SmartMenus is the only GUI plugin with a use_bottom_inventory feature.

When enabled, SmartMenus saves the player's inventory, replaces those slots with GUI items, and restores everything perfectly on close. This unlocks:

90 total interactive slots — 54 from the chest GUI + 36 from the player's inventory area
Immersive full-screen menus that fill the entire Minecraft inventory screen
All 90 slots support actions, conditions, and every button type
Zero item loss — real inventory is saved and restored on close, quit, and server reload

Code (Text):

full_screen_hub:
title: "&5&l✦ Server Hub"
rows: 6
use_bottom_inventory: true # ← unlock 90 slots

items:
# ... top 54 slots ...

bottom_items: # ← bottom 36 slots (player inventory area)
survival-btn:
slot: 4
material: GRASS_BLOCK
name: "&a&lSurvival Server"
actions:
- type: SERVER_CONNECT
server: "survival-1"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚡ 16 Action Types — Execute Anything On Click

PLAYER_MESSAGE — Send a colored message to the player
BROADCAST — Announce to the entire server
ACTION_BAR — Display text above the hotbar
TITLE — Full screen title with subtitle, fade-in, stay, fade-out control
SOUND — Play a sound for the clicking player (volume + pitch control)
BROADCAST_SOUND — Play a sound for every player online
CONSOLE_COMMAND — Execute any command as console
PLAYER_COMMAND — Execute a command as the player
RANDOM_CONSOLE_COMMAND — Pick a random command from a list (loot tables!)
RANDOM_PLAYER_COMMAND — Same but as the player
TELEPORT — Teleport to any world, X/Y/Z, yaw, pitch
OPEN_INVENTORY — Open another GUI by ID
CLOSE_INVENTORY — Close the current GUI
BACK — Navigate to the previous GUI
SERVER_CONNECT — Send player to a BungeeCord/Velocity server
SCRIPT — Execute inline JavaScript (Nashorn/GraalVM) for unlimited custom logic

Every action supports per-click-type targeting — assign different actions to LEFT, RIGHT, SHIFT_LEFT, SHIFT_RIGHT, MIDDLE, and DOUBLE_CLICK independently:

Code (Text):

rank-upgrade:
type: NONE
slot: 22
material: NETHER_STAR
name: "&d&lRank Upgrade"
click_actions:
LEFT:
- type: PLAYER_MESSAGE
message: "&7Left click to preview, &eshift+left to confirm purchase."
SHIFT_LEFT:
- type: CONSOLE_COMMAND
command: "lp user {player} parent set vip"
- type: SOUND
sound: ENTITY_PLAYER_LEVELUP
- type: TITLE
title: "&d✦ RANK UP ✦"
subtitle: "&7You are now &dVIP&7!"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

23 Condition Types — The Most Comprehensive Gate System

Economy Conditions

VAULT_MONEY — Require & deduct Vault money
OREO_CURRENCY — Require & deduct any OreoEssentials custom currency (tokens, gems, crystals, anything)
XP_LEVEL — Require & deduct XP levels
XP_POINTS — Require & deduct total XP points

Item Conditions

ITEM — Require & consume vanilla Minecraft items
ITEM_CUSTOM_MODEL — Require items with a specific custom model data value
ITEMSADDER — Require & consume ItemsAdder custom items
NEXO — Require & consume Nexo custom items

Permission & Rank Conditions

PERMISSION — Require (or deny) a Bukkit permission node
LUCKPERMS_GROUP — Require membership in a LuckPerms group (with inheritance support)

Location & World Conditions

WORLD — Require player to be in specific world(s), or blacklist worlds
WEATHER — Require specific weather (clear / rain / thunder)
WORLDGUARD_REGION — Require player to be inside a WorldGuard region
OREO_WARPS — Check if an OreoEssentials warp exists or player has permission
OREO_WARPS_LOCATION — Require player to be within N blocks of a warp
MODELED_NPC — Require player to be near a ModeledNPC by ID

Placeholder & Logic Conditions

PLACEHOLDER — Compare any PlaceholderAPI value with ==, !=, >, >=, <, <=
PLACEHOLDER_EQUALS — Check if a placeholder equals a string (case-insensitive)
PLACEHOLDER_CONTAINS — Check if a placeholder contains a substring
PLACEHOLDER_GREATER_THAN — Check if a placeholder number exceeds a value
PLACEHOLDER_LESS_THAN — Check if a placeholder number is below a value
EXPRESSION — Full math/logic expression engine: %player_level% * 2 > 30, %vault_balance% >= 5000 && %player_health% > 10
SCRIPT — Inline JavaScript condition for truly unlimited logic

Conditions work in two modes:

conditions: — Item is always visible, but clicking it checks (and consumes) the condition
view-requirements: — Item is hidden entirely if the condition fails (shows else-item instead)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Every Item Property You Could Ever Need

material: Any Minecraft material
item_type: vanilla / itemsadder / nexo / headdatabase
item_id: Custom item namespace (e.g. iasurvival:ruby)
custom_model_data: Resource pack model override
name: Full color support — legacy &codes, &#hex, gradients, rainbow, PlaceholderAPI
lore: Multi-line, full color + placeholder support on every line
glow: Enchantment glow effect without showing enchant names
item_flags: HIDE_ENCHANTS, HIDE_ATTRIBUTES, HIDE_POTION_EFFECTS, and more
enchantments: Any enchantment at any level
update: true + update-interval: Auto-refresh lore/name with live placeholders
is-permanent: Keep NEXT/PREVIOUS buttons visible even on first/last page
take-item: true — Remove item from player inventory/enderchest on click
give-item: true — Give item to player inventory on click
close: true — Auto-close GUI after click

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Advanced Color & Text System

Legacy color codes — &0-f, &l, &o, &n, &k, &m, &r
Hex colors — &#FFD700, &#00FFFF, any RGB value (1.16+)
Gradients — <gradient:#FF0000:#FFD700>text</gradient>
Rainbow — <rainbow>text</rainbow>
PlaceholderAPI — Any %placeholder% in names, lore, titles, messages
Dynamic variables — Source-provided placeholders like %player_name%, %world_players%, %item_amount%
Command args — %arg_name% from GUI open commands

Code (Text):

name: "<gradient:#00AAFF:#FFD700>&l⭐ %player_name%'s Reward ⭐</gradient>"
lore:
- "&#00FFFF Balance: &#32CD32$%vault_eco_balance%"
- "<rainbow>✦ Ultra Premium Item ✦</rainbow>"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ GUI-Level Power Features

inventory_type: CHEST, HOPPER, DISPENSER, DROPPER, FURNACE, BLAST_FURNACE, SMOKER, BREWING_STAND, CRAFTING
rows: 1–6 for chest GUIs
commands: Multiple commands that open the same GUI
use_bottom_inventory: 90-slot full-screen mode (unique to SmartMenus)
main_menu: Home button target for nested navigation trees
npc_id: Bind GUI to a ModeledNPC — open by right-clicking
fill: Fill all empty slots with a configurable background item
patterns: Reusable slot layouts applied before items load
args: Typed command arguments (%arg_name%) passed when opening the GUI

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NEW TOOL: SmartMenus Visual Builder
Capture d’écran 2026-06-05 203430.png

Introducing the SmartMenus Builder — a 100% free, browser-based visual editor. No downloads. No registration. No YAML syntax errors.

What it does:

Visual slot grid — click any slot to edit it
Full support for all 14 button types
All 23 condition types with guided forms
All 16 action types with per-click-type targeting
Live YAML preview with syntax highlighting
One-click download of the finished .yml file
Auto-save — your work is never lost
Import existing YAML to edit it visually

Before SmartMenus Builder:
Write YAML → Fix indentation errors → Fix syntax errors → Upload → Test → Fix mistakes → Repeat
Time: 30+ minutes

With SmartMenus Builder:
Click slots → Fill forms → Download → Upload → Done
Time: 3 minutes ⚡

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Perfect Combo: SmartMenus + OreoEssentials

SmartMenus integrates deeper with OreoEssentials than any other plugin:

Unlimited custom currencies — tokens, gems, crystals, shards, whatever your server uses
Warp location gates — require players to be physically near a warp to interact
Warp permission checks — gate items behind warp unlock status
Cross-server support — the only true multi-server economy SmartMenus can tap into

Code (Text):

vip-kit:
slot: 22
material: DIAMOND_SWORD
name: "<gradient:#FFD700:#00FFFF>&lLegendary Kit</gradient>"
lore:
- "&7Cost: &e100 Tokens &7+ &650 Gems"
- "&7Must be at the Spawn warp"
conditions:
- type: OREO_CURRENCY
currency: "tokens"
amount: 100
- type: OREO_CURRENCY
currency: "gems"
amount: 50
- type: OREO_WARPS_LOCATION
warp: "spawn"
radius: 15.0

[→ Get OreoEssentials Here ←]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Real-World Examples

Code (Text):

pvp-toggle:
type: SWITCH
slot: 13
key: "%someplugin_pvp_status%"
buttons:
"enabled":
material: LIME_DYE
name: "&a&lPvP: ENABLED"
lore:
- "&7Click to disable PvP"
actions:
- type: CONSOLE_COMMAND
command: "pvp disable {player}"
"disabled":
material: RED_DYE
name: "&c&lPvP: DISABLED"
lore:
- "&7Click to enable PvP"
actions:
- type: CONSOLE_COMMAND
command: "pvp enable {player}"

Code (Text):

online_players:
title: "&b&lOnline Players"
rows: 6
commands: [ "players", "playerlist" ]

items:
border:
slots: [ 0-8, 45-53 ]
material: CYAN_STAINED_GLASS_PANE
name: "&8"

player-list:
type: DYNAMIC_PAGINATION
source: ONLINE_PLAYERS
slots: [ 9-44 ]
material: PLAYER_HEAD
name: "&e%player_name%"
lore:
- "&7World: &f%player_world%"
- "&7Health: &c%player_health%❤"
- "&7Level: &a%player_level%"
- "&7Ping: &b%player_ping%ms"
- ""
- "&eLeft-click &7to teleport"
- "&eRight-click &7to message"
click_actions:
LEFT:
- type: CONSOLE_COMMAND
command: "tp {player} %player_name%"
- type: CLOSE_INVENTORY
RIGHT:
- type: CHAT_INPUT
chat-prompt: "&7Enter your message for &e%player_name%&7:"

prev:
type: PREVIOUS
slot: 48
material: ARROW
name: "&c← Previous"
is-permanent: false

next:
type: NEXT
slot: 50
material: ARROW
name: "&aNext →"
is-permanent: false

Code (Text):

enderchest_viewer:
title: "&5&l Your Ender Chest"
rows: 6
commands: [ "ecview" ]

items:
border:
slots: [ 0-8, 45-53 ]
material: PURPLE_STAINED_GLASS_PANE
name: "&8"

ec-items:
type: DYNAMIC_PAGINATION
source: PLAYER_ENDERCHEST
slots: [ 9-44 ]
material: STONE
name: "&f%item_name%"
lore:
- "&7Amount: &e%item_amount%"
- ""
- "&aClick &7to move to inventory"
give-item: true # adds to main inventory
take-item: true # removes from ender chest

Code (Text):

sacrifice_altar:
title: "&4&l⚔ Sacrifice Altar"
rows: 3
commands: [ "altar" ]

items:
border:
slots: [ 0-8, 18-26 ]
material: RED_STAINED_GLASS_PANE
name: "&8"

sacrifice-slot:
type: INPUT
slot: 13
material: AIR
name: "&7Drop an item here..."
on-place:
- "broadcast &4⚔ &f{player} &7sacrificed &f%input_item_name% &7x%input_item_amount% &7to the altar!"
- "give {player} nether_star 1"
remove-on-place: true

Code (Text):

elite-item:
slot: 22
material: NETHERITE_SWORD
name: "&4&lElite Warrior Blade"
lore:
- "&7For the mightiest warriors only."
conditions:
- type: EXPRESSION
expression: "%player_level% * 2 + %vault_eco_balance_fixed% > 1000"
- type: SCRIPT
script: "player.getHealth() >= 15 && player.isOp() == false"

Code (Text):

main_hub:
title: "&5&l✦ Server Hub"
rows: 6
commands: [ "hub", "menu" ]
use_bottom_inventory: true # ← 90-slot mode!

items:
border:
slots: [ 0-8, 45-53 ]
material: PURPLE_STAINED_GLASS_PANE
name: "&8"
survival:
slot: 22
material: GRASS_BLOCK
name: "&a&lSurvival"
actions:
- type: SERVER_CONNECT
server: "survival-1"

bottom_items: # ← player inventory area (36 slots)
info:
slot: 4
material: PAPER
name: "&fYou are viewing: &dServer Hub"
discord-btn:
slot: 31
material: COMPASS
name: "&9&lDiscord"
actions:
- type: PLAYER_MESSAGE
message: "&9Join our Discord: &fdiscord.gg/example"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Commands & Permissions

Code (Text):

/smartmenus — Show help
/smartmenus open <gui> [player] — Open a GUI for yourself or another player
/smartmenus reload — Reload all GUI configs instantly (no restart!)

Code (Text):

smartmenus.use — Access to /smartmenus (default: true)
smartmenus.open — Open GUIs (default: true)
smartmenus.reload — Reload plugin (default: op)
smartmenus.command.<gui> — Use a GUI's custom command (default: true)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

Download SmartMenus.jar from the button above
Drop it in your server's plugins/ folder
Restart the server — default example GUIs are generated automatically
Edit files in plugins/SmartMenus/guis/
Run /smartmenus reload — changes apply instantly, no restart needed

Optional dependencies (all soft — none required):

Vault — economy conditions
PlaceholderAPI — placeholder support in names, lore, conditions
ItemsAdder — custom item support
Nexo — custom item support
HeadDatabase — custom skull support
WorldGuard — region conditions
LuckPerms — group/rank conditions
ModeledNPCs — NPC-bound GUIs
OreoEssentials — custom currencies + warp conditions (highly recommended)

Server requirements:

Minecraft 1.16+ (hex colors/gradients require 1.16+)
Paper, Purpur, or Pufferfish recommended
Java 16+

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What You Can Build With SmartMenus

Advanced shops — multi-currency, permission-gated, rank-based pricing
⚔️ PvP shops — K/D ratio conditions via PlaceholderAPI
Rank upgrade menus — PERMISSION_GROUPS dynamic source + LuckPerms conditions
Location shops — only accessible near certain warps or in certain regions
️ Quest boards — item INPUT slots + condition gates + NPC binding
NPC dialogues — open GUIs by right-clicking ModeledNPCs
Server selectors — full-screen hub with BungeeCord server connect
Inventory managers — view, sort, and transfer inventory/enderchest items visually
⚡ Toggle systems — SWITCH buttons for PvP, fly, chat, any feature
Sacrifice altars — INPUT slots + broadcast actions
Player browsers — DYNAMIC_PAGINATION ONLINE_PLAYERS with admin actions
World selectors — DYNAMIC_PAGINATION WORLDS with teleport actions
VIP kits — view requirement hides item entirely from non-VIP players
Lore pages — PAGINATION with static element lists
Script-driven menus — inline JavaScript for logic no YAML can express

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SmartMenus vs. The Competition

Feature	SmartMenus	DeluxeMenus	ChestCommands	TrMenu	zMenu
Built on SmartInvs API	✔	✘	✘	✘	✘
Dynamic live data sources	✔ 5 sources	✘	✘	Partial	API only
90-slot full-screen GUI	✔	✘	✘	✘	zMenu+ only API Only
Per-click-type actions	✔ 7 types	Limited	✘	Partial	✔ 7 types
Item INPUT slots	✔	✘	✘	✘	zMenu+ only
Chat INPUT capture	✔	✘	✘	✘	✘
SWITCH toggle buttons	✔	✘	✘	✔	✔
Inline JavaScript scripting	✔	✘	✘	Partial	✘
Math expression conditions	✔	✘	✘	✘	✔
View requirements (hidden items)	✔	✔	✘	✔	✔
Number of condition types	23	~12	~5	~15	~11
Visual GUI builder (free)	✔	✘	✘	✘	✔
NPC-bound GUIs	✔	✘	✘	✘	✘
Price	FREE	FREE	FREE	FREE	FREE

❤️ Support Development

SmartMenus is completely free and will stay that way. If it saves you time or makes your server better, here is how you can give back:

Leave a 5-star review ⭐ — The single most impactful thing you can do. It helps other server owners find this plugin.
Report bugs — Found something broken? Tell us in the Discussion tab. We aim to fix within 24–48 hours.
Suggest features — Have an idea? Post it. Many of SmartMenus' best features came from user suggestions.
Share it — Tell other server owners. Share it in your Discord. Help the community grow.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Created by Oreo Studios · Powered by SmartInvs API

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 112

First Release: Feb 6, 2026

Last Update: Jun 19, 2026

Category: ---------------

All-Time Rating:

2 ratings

Find more info at oreostudios.fr...

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings

Ask Questions / Get Support