SmartMenus

⚡ SmartMenus

A powerful and modern GUI system for Minecraft servers — built on SmartInvs.

Create anything from simple server menus to shops, rank upgrades, player browsers, quest interfaces, NPC menus, inventory managers, server selectors, and even full-screen 90-slot GUIs.

SmartMenus combines a powerful YAML configuration system with dynamic server data, advanced conditions, scripting, Bedrock support, and a free online visual editor.

No coding required.

---

🛠️ Free Online GUI Builder

Don't want to manually write YAML?

SmartMenus includes a free browser-based Visual Builder where you can create your menus visually.

• 🖱️ Click slots directly on a Minecraft inventory grid
• ⚡ Configure actions and click types
• 🔐 Add conditions and view requirements
• 🔄 Configure pagination and button types
• 👀 Live YAML preview
• 📥 Import existing SmartMenus configurations
• 💾 Automatic saving
• 📤 Download your finished .yml file
• ✅ No account or installation required

Build the menu visually, export it, put it on your server, and reload SmartMenus.

---

📱 Java + Bedrock Support

SmartMenus supports Geyser and Floodgate players.

Your existing Java GUIs can automatically be converted into Bedrock Forms without creating a second configuration.

Supported forms include:

• Simple Forms
• Modal Forms
• Custom Forms
• Dialogue Forms

You can also create dedicated Bedrock interfaces using:

OPEN_BEDROCK_FORM
OPEN_BEDROCK_DIALOGUE

One configuration. Java and Bedrock.

---

🖥️ Full-Screen 90-Slot GUIs

SmartMenus can use both the chest and player inventory area:

54 GUI slots + 36 bottom inventory slots = 90 interactive slots.

Every slot can use actions, conditions, placeholders, and advanced button types.

Two rendering modes are available:

DEFAULT

Works without additional dependencies and safely restores the player's inventory when the GUI closes.

PACKET_EVENT

Uses PacketEvents to render the bottom inventory entirely client-side.

This means the player's real inventory is never modified, providing crash-safe and flicker-free full-screen interfaces.

---

🔄 Dynamic GUIs

SmartMenus isn't limited to static YAML items.

With DYNAMIC_PAGINATION, menus can automatically generate buttons from live server data.

Built-in sources include:

• 👥 ONLINE_PLAYERS
• 🌍 WORLDS
• 🎒 PLAYER_INVENTORY
• 💎 PLAYER_ENDERCHEST
• 🎖️ PERMISSION_GROUPS

For example, you can create a live player browser where every online player automatically appears as a clickable head showing their:

Name • World • Health • Level • Ping • Gamemode

Players joining or leaving are handled dynamically.

---

🔘 Advanced Button System

SmartMenus provides numerous specialized button types, including:

NONE • INVENTORY • BACK • HOME • NEXT • PREVIOUS • JUMP • PAGINATION • DYNAMIC_PAGINATION • SWITCH • INPUT • CHAT_INPUT

🎒 INPUT

Allow players to physically place items inside a GUI.

Perfect for:

• Custom crafting
• Quest item submissions
• Sacrifice systems
• Upgrade stations
• Item exchanges

💬 CHAT_INPUT

Ask the player for text and capture their response.

Useful for:

• Searches
• Custom names
• Admin interfaces
• Player input
• Configuration menus

🔀 SWITCH

Create dynamic toggle buttons based on PlaceholderAPI values or other states.

Perfect for:

• PvP toggles
• Fly toggles
• Player settings
• Preferences
• Feature switches

---

⚡ Powerful Actions

Buttons can execute multiple actions, such as:

• Console commands
• Player commands
• Messages
• Broadcasts
• Titles
• Action bars
• Sounds
• Teleports
• Server connections
• Opening other menus
• Random commands
• JavaScript
• And more

Different actions can even be assigned to:

Left Click • Right Click • Shift Click • Middle Click • Double Click

This makes it possible to create highly interactive menus without writing custom plugin code.

---

🔐 Advanced Conditions

SmartMenus includes 23 condition types for controlling who can see or use an item.

Check things like:

• 💰 Vault balance
• 💎 OreoEssentials currencies
• ⭐ XP / levels
• 📦 Vanilla items
• 🎨 ItemsAdder / Nexo items
• 🔑 Permissions
• 🎖️ LuckPerms groups
• 🌍 Worlds
• 🌦️ Weather
• 🗺️ WorldGuard regions
• 🧙 ModeledNPC proximity
• 📍 OreoEssentials warps
• 🔢 PlaceholderAPI values
• 🧠 Mathematical expressions
• 📜 JavaScript

Conditions can prevent players from clicking an item or completely hide the item using view-requirements.

You can also create fallback items using else-item, allowing different items to appear depending on whether requirements are met.

else-item configurations can even have their own view-requirements and another else-item, allowing multi-level conditional displays.

For example:

VIP → MVP → Default

This makes it easy to display different buttons depending on permissions, ranks, currencies, or any other supported condition.

---

🎨 Modern Item & Text System

Customize GUI items with:

• Custom materials
• Custom Model Data
• ItemsAdder
• Nexo
• HeadDatabase
• Enchantments
• Glow
• Item flags
• Dynamic lore
• Auto-updating placeholders
• Hex colors
• Gradients
• Rainbow text
• PlaceholderAPI

SmartMenus can continuously refresh menu items, making live statistics and dynamic interfaces easy to create.

---

🌐 Network Support

Create network server selectors using:

SERVER_CONNECT

Compatible with Velocity and BungeeCord networks.

Use SmartMenus to build server selectors, game-mode selectors, lobby navigation, or complete network hubs.

---

🧙 NPC GUIs

SmartMenus integrates directly with ModeledNPCs.

Bind a GUI to an NPC and automatically open it when players interact with them.

Great for:

• Shops
• Quest NPCs
• Bankers
• Teleporters
• Dialogue systems
• Server selectors
• Reward NPCs

---

🔌 Integrations

SmartMenus supports optional integrations with:

• PacketEvents
• PlaceholderAPI
• Vault
• LuckPerms
• WorldGuard
• ItemsAdder
• Nexo
• HeadDatabase
• ModeledNPCs
• OreoEssentials
• Geyser / Floodgate

None of these integrations are required for the core plugin.

Install only the integrations your server needs.

---

💰 OreoEssentials Integration

SmartMenus has deep integration with OreoEssentials.

Use unlimited custom currencies such as:

Tokens • Gems • Crystals • Coins • Shards

You can build shops and interfaces using any configured OreoEssentials currency.

SmartMenus can also restrict menu items based on OreoEssentials warps or require a player to physically be near a specific warp before interacting with an item.

This is useful for:

• Physical server shops
• NPC stores
• Banks
• Region-based menus
• Teleport interfaces
• Quest locations

---

💡 What Can You Build?

🛒 Shops 🌍 Server selectors 🎖️ Rank stores 🧙 NPC shops 📜 Quest boards 👥 Player browsers 🎒 Inventory managers 💎 Ender Chest interfaces ⚔️ PvP menus 🔄 Settings menus 🗡️ Sacrifice systems 🎁 Reward interfaces 🌎 World selectors 🖥️ Full-screen hubs 🎮 Bedrock forms ⚙️ Script-driven interfaces

From a small /menu GUI to a complete interactive server interface, SmartMenus is designed to scale with your server.

---

⚙️ Commands

/smartmenus
/smartmenus open <gui> [player]
/smartmenus reload

GUIs can also have their own custom commands, such as:

/menu
/shop
/server

This allows players to open specific GUIs without needing to use the main SmartMenus command.

---

📦 Installation

1. Download SmartMenus.
2. Put the .jar inside your server's plugins/ folder.
3. Restart your server.
4. Create your GUIs inside plugins/SmartMenus/guis/.
5. Run /smartmenus reload.

Done. ⚡

---

🖥️ Requirements

• Minecraft 1.16+
• Java 16+
• Paper / Purpur / Pufferfish recommended

---

❤️ Completely Free

SmartMenus is free and will stay free.

There is no paid version required to access the core features.

If you enjoy the plugin, consider:

• Leaving a review
• Reporting bugs
• Suggesting features
• Sharing SmartMenus with other server owners
• Supporting the project by providing feedback

---

⚡ SmartMenus

From a simple menu to a complete interactive interface.

Java + Bedrock • Visual Online Builder • Dynamic Data • 90 Slots • Conditions • Actions • Scripting

Created by Oreo Studios

Powered by SmartInvs