SMP Menus v1.0.2

What is SMP Menus?

SMP Menus is a production-ready Minecraft menu plugin built for server owners who want clean, configurable, professional inventory GUIs without needing to write code.

It lets you create menu files in a DeluxeMenus-style YAML format, register commands for each menu, configure rows, slots, materials, names, lore, player heads, sounds, requirements, permissions, click actions, open actions, and cooldowns.

The plugin includes a complete default help menu, rules menu, and staff menu so your server can ship with useful menus immediately, then customize everything later.

Default Included Menus

• /help — opens the main server guide menu.
• /guide — alternate command for the main help menu.
• /rules — opens a full server rules menu.
• /staffmenu — opens the staff tools menu.
• Main help hub — routes players to shop, kits, RTP, Discord, rules, homes, crates, stats, teams, lifesteal, media, auctions, orders, sell, coinflip, and more.
• Rules menu — organized rules categories with clean tooltip formatting.
• Staff menu — permission-protected 3-row menu for common administrator commands.

DeluxeMenus-Style YAML Menus

Menus are stored as separate YAML files inside the menu folder.

• One file per menu — create clean menu files such as help.yml, rules.yml, staff.yml, shop.yml, kits.yml, and more.
• Command aliases per menu — configure open_command directly inside each menu file.
• Enable or disable menus — use enabled: true/false without deleting files.
• Custom menu title — configure menu_title with colors and placeholders.
• Custom size or rows — configure size or rows for multi-row inventories.
• Register commands — allow each menu to expose its own command aliases.
• Open actions — run sounds, messages, or other actions when a menu opens.
• Update interval — refresh dynamic placeholder items on a configured tick interval.
• Click cooldown — protect menu actions from spam with per-menu cooldowns in milliseconds.

Item Customization

Every menu item can be configured from YAML.

• Material — modern material names, legacy material names, player heads, base64 heads, and texture heads.
• Legacy material fallback — useful for 1.8–1.12 compatibility.
• Data and damage — supports legacy item data and durability-style values.
• Amount — configure visible item stack amount.
• Display name — full colored item names.
• Lore — multi-line lore with color codes and placeholders.
• Slots — single slot or multiple slots.
• Slot ranges — fill backgrounds using ranges such as 0-44.
• Priority — multiple items can target the same slot and resolve through priority plus view requirements.
• Glow — optional enchantment-style glow.
• Unbreakable — optional item meta flag.
• Hide attributes — hide vanilla attack damage and armor text where supported.
• Close-on-click — control whether a clicked item closes the menu.

Player Heads and Custom Textures

SMP Menus supports custom head items for premium-looking menus.

• Named player heads — use head-PlayerName style material tokens.
• Base64 heads — use basehead-<base64> for Minecraft-Heads style custom textures.
• Texture ID heads — use texture-<id> where the ID is the texture hash from textures.minecraft.net.
• Placeholder heads — PlaceholderAPI and built-in variables can be resolved inside supported head tokens.
• Modern profile support — uses modern profile APIs reflectively where available.
• Legacy GameProfile fallback — falls back for older Bukkit/Spigot versions.
• Head caching — configured head textures are cached and cloned for better menu performance.

Click Actions

Click actions are executed in order, from top to bottom.

• [player] — run a command as the player.
• [console] — run a command as console.
• [op] — temporarily run a command with operator permission, then restore OP state.
• [message] — send a message to the clicking player.
• [broadcast] — send a message to online players.
• [sound] — play a configured or named sound.
• [close] — close the current inventory.
• [refresh] — refresh the current menu.
• [menu] — open another SMP Menus menu directly.
• [open] — alias for opening another menu.

Player command actions can also route to SMP Menus menu aliases internally, so menu-to-menu navigation works even when another plugin owns the same command name.

Click Types

Configure different behavior for different click types.

• click_commands — default action for any click.
• left_click_commands — left-click action.
• right_click_commands — right-click action.
• shift_left_click_commands — shift-left-click action.
• shift_right_click_commands — shift-right-click action.
• click_requirement — default click requirement.
• left_click_requirement — left-click requirement.
• right_click_requirement — right-click requirement.
• shift_left_click_requirement — shift-left-click requirement.
• shift_right_click_requirement — shift-right-click requirement.

Requirements and Permissions

SMP Menus includes menu-level and item-level access control.

• Menu open permission — protect an entire menu with permission or open_permission.
• Item click permission — protect individual item clicks with click_permission.
• View requirements — only show an item when the player passes configured requirements.
• Click requirements — only execute click actions when requirements pass.
• Deny commands — send messages, play sounds, or run actions when requirements fail.
• Has permission requirement — show or execute items based on permissions.
• String comparison requirement — compare placeholder output or static values.
• Numeric comparison requirement — support >=, >, <=, <, ==, and !=.
• Has item requirement — require a material and amount in the player inventory.
• Fail-closed behavior — unknown requirement types fail safely instead of silently allowing access.

PlaceholderAPI Support

PlaceholderAPI is optional. If PlaceholderAPI is installed and enabled, SMP Menus automatically hooks into it.

• Menu titles — use PlaceholderAPI placeholders in inventory titles.
• Item names — use placeholders in display names.
• Item lore — use placeholders in lore lines.
• Actions — use placeholders inside messages and commands.
• Requirements — compare placeholder values in string and numeric requirements.
• Head tokens — resolve placeholders inside supported player-head material tokens.
• Soft dependency — the plugin still works when PlaceholderAPI is not installed.

Built-In Variables

SMP Menus also resolves built-in variables before PlaceholderAPI processing.

• %player% — player name.
• %player_name% — player name.
• %uuid% — player UUID.
• %menu% — current menu ID.
• {target} — command argument target when opening a menu with arguments.
• {arg0}, {arg1}, {arg2}... — command arguments passed into the menu context.

Menu Anti-Spam Protection

Inventory menus can be abused by fast click macros. SMP Menus includes a per-menu click cooldown system.

• Per-menu cooldown — configure click_cooldown in milliseconds.
• Default 500ms cooldown — default help and rules menus include a 500ms click cooldown.
• Player-specific tracking — cooldowns are tracked per player and menu.
• Cleanup on quit — cooldown state is cleared when players leave.
• No command spam — blocked clicks do not execute menu actions.

Sound and Material Compatibility

SMP Menus is designed around cross-version Bukkit-family compatibility.

• Material resolver — modern material names can fall back to legacy material aliases.
• Legacy data support — useful for stained glass, dyes, skulls, and old item variants.
• Sound resolver — configured sounds can resolve through modern and legacy aliases.
• Cached sound lookup — resolved sound names are cached after lookup.
• Graceful fallback — invalid or unavailable sounds do not crash the plugin.
• Centralized utilities — compatibility logic stays inside utility bridges instead of being scattered through menu code.

Folia-Ready Scheduling

SMP Menus is not just marked as Folia-supported. It routes player-owned work through the scheduler bridge.

• folia-supported: true in plugin.yml.
• Entity-owned execution — player inventory opens, closes, and command execution run through player-owned scheduling.
• Global execution — console command dispatch is routed through the global scheduler path.
• Classic Bukkit fallback — works on non-Folia Bukkit-family servers.
• Reflection-based compatibility — avoids direct modern-only scheduler imports in legacy paths.
• No raw thread model — uses plugin scheduler bridge instead of unsafe ad hoc threads.

Default Main Help Menu

The included help menu is designed as a central server guide.

• World Info — difficulty, borders, lifesteal, mace PvP, overworld/nether/end limits.
• Store — route players to /store.
• Discord — route players to /discord.
• Auction House — route players to /ah.
• Orders — route players to /orders.
• Sell — route players to /sell.
• Shop — route players to /shop.
• Random Teleport — route players to /rtp.
• Leaderboards — route players to /leaderboards.
• Stats — route players to /stats.
• Coinflip — route players to /coinflip.
• Lifesteal — route players to lifesteal recipe and withdraw info.
• Kits — route players to /kit.
• AFK Shards — route players to /afk.
• TPA — explain /tpa, /tpaccept, and /tpdeny.
• Rules — open the internal rules menu.
• Homes — explain and open /home.
• Team — route players to /team.
• Crate Chances — route players to /crate chances.
• Media — route players to /media.
• Close button — centered close button on the bottom row.

Default Rules Menu

The included rules menu is ready for SMP-style servers.

• Threats — doxing, DDoS threats, personal information, malicious links.
• Refunds — no refunds, no rank extensions after bans, all sales final.
• Farms — large farm policy.
• Scamming — store item scams, Minecraft item scams, trading risk, IRL trading.
• Discrimination — racism, sexism, homophobia, and harassment policy.
• Unfair Advantages — hacks, mods, macros, bug abuse, exploits, punishment bypassing.
• Advertising — server ads, YouTube link policy, stream command policy.
• Content Rules — offensive topics, sexual/political content, builds, names, skins, cosmetics.
• Chat Rules — abusive language, spam, caps, filter bypassing, toxicity, threats.

Default Staff Menu

The included staff menu is protected by smpmenus.staff by default and can be changed in staff.yml.

• /god — toggle god mode.
• /fly — toggle flight.
• /gamemode 1 — switch to creative mode.
• /gamemode 0 — switch back to survival mode.
• /staff — enter staff mode.
• /vanish — toggle vanish.
• /heal — restore health.

The commands are normal configurable menu actions. You can replace them with your own staff plugin commands if your server uses different command names.

Admin Commands

• /smpmenus reload — reload menus from disk.
• /smpmenus open <menu> [player] — open a menu for yourself or another online player.
• /smpmenus list — list loaded menus.
• /help — open the main help menu.
• /guide — open the main help menu.
• /rules — open the rules menu.
• /staffmenu — open the staff menu.

Permissions

• smpmenus.use — default player menu usage permission.
• smpmenus.admin — admin command permission.
• smpmenus.staff — default staff menu permission.
• Custom menu permissions — configure permission or open_permission in any menu YAML.
• Custom item permissions — configure click_permission on individual menu items.

Performance and Stability

SMP Menus is built for live servers, not just screenshots.

• Menu definitions cached on reload — YAML is loaded into configured menu objects.
• Items grouped by slot — item lookup uses prebuilt slot mappings.
• Head caches — base64, texture, and named heads are cached.
• Sound caches — resolved sounds are cached.
• Reflection caches — reflective lookups use cached utility methods.
• No menu file scanning on every click — clicks use loaded menu state.
• Safe listener split — click, drag, close, quit, and command interception are separate listener concerns.
• Reload cleanup — open sessions and update tasks are handled safely.

Configuration Example


Configuration Philosophy

Everything important should be controlled from YAML.

• Menu title.
• Menu command aliases.
• Menu size and rows.
• Menu enabled state.
• Menu open permission.
• Menu click cooldown.
• Open actions.
• Item material.
• Legacy material fallback.
• Item data and damage.
• Display name.
• Lore.
• Slots and slot ranges.
• Priority.
• Glow and meta flags.
• View requirements.
• Click requirements.
• Deny commands.
• Click actions.
• Click permissions.
• Sounds.
• Messages.
• Main menu selection.
• Help command interception.

Why Choose SMP Menus?

• Designed for SMP servers — ships with practical help, rules, and staff menus.
• No extra menu plugin required — create and open menus directly through SMP Menus.
• DeluxeMenus-style config — familiar YAML structure for server owners.
• Built for compatibility — Java 8 target, Bukkit 1.8 API target, and compatibility bridges.
• Folia-ready — player-owned work is routed through scheduler utilities.
• Supports premium-looking icons — base64 heads, texture heads, and named player heads.
• Supports PlaceholderAPI — optional placeholders in titles, names, lore, actions, and requirements.
• Supports permission-gated menus — protect staff or donor menus cleanly.
• Supports anti-spam cooldowns — prevent rapid menu click abuse.
• Clean admin workflow — reload, open, and list menus in-game.

FAQ

What kind of server is this for?
SMP, Survival, LifeSteal SMP, PvP survival, Donut-like servers, Factions-lite servers, community networks, and any server that needs clean command menus.

Does it replace DeluxeMenus?
It provides its own configurable menu system with a DeluxeMenus-style YAML format. It is designed to be simpler, focused, and ready for SMP command hubs.

Does it require PlaceholderAPI?
No. PlaceholderAPI is optional. If PlaceholderAPI is installed, SMP Menus uses it automatically.

Does it support player heads?
Yes. It supports named heads, base64 heads, and texture ID heads.

Can I create multiple menus?
Yes. Add menu YAML files inside the menus folder and configure open_command for each one.

Can I protect staff menus?
Yes. Use permission or open_permission at menu level, and click_permission at item level.

Can I make items only appear for certain players?
Yes. Use view_requirement with permission, string, numeric, or has-item requirements.

Can I make items run different commands on left/right click?
Yes. Left, right, shift-left, and shift-right click commands and requirements are supported.

Does it support Folia?
Yes. The plugin declares Folia support and routes player-owned work through the scheduler bridge.

Does it support legacy servers?
Yes. The project targets Java 8 and Bukkit 1.8.8 API compatibility, with material, sound, head, and scheduler compatibility utilities.


SEO keywords: SMP Menus, SMPMenus, Minecraft menu plugin, Bukkit menu plugin, Spigot menu plugin, Paper menu plugin, Folia menu plugin, configurable GUI menu, DeluxeMenus alternative, DeluxeMenus style menu, Minecraft help menu, Minecraft rules menu, Minecraft staff menu, Minecraft GUI plugin, player head menu, base64 head menu, PlaceholderAPI menu, SMP help menu, survival menu plugin, Donut SMP menu, server guide plugin, command menu plugin, inventory menu plugin, Bukkit 1.8 menu plugin, all versions menu plugin.