CloudMenus v1.0

CloudMenus​

Build stunning server GUIs entirely in-game — with full DeluxeMenus compatibility.​

---

✦ What is CloudMenus?​

CloudMenus is a modern Paper 1.21+ menu plugin built for server owners and developers who want professional chest GUIs without spending hours editing YAML by hand.

Design menus through a clean, spacious in-game editor — set titles, items, lore, click actions, requirements, open commands, and more. Changes auto-save to disk. When you are ready, players open your menus with registered commands or /cm open.

Already on DeluxeMenus? Import your existing menus in one command — including nested folders — and keep building from there.

---

✦ Why CloudMenus Stands Out​

---

✦ CloudMenus vs Other Menu Plugins​

Bottom line: CloudMenus gives you DeluxeMenus-level power with a modern in-game workflow ; ideal if you want to migrate, prototype fast, or let non-technical staff build menus safely.

---

✦ Feature Overview​

🖥 In-Game Editor​

• Menu list — browse, create, preview, and edit all menus from one GUI
• Menu settings — title, size (9–54), auto-refresh interval, open command, command registration, open actions, open requirements
• Layout editor — click empty slots to add items; click items to edit
• Item editor — display name, lore, glow, copy-from-hand, HeadDatabase heads
• Lore editor — add, edit, and delete lines with chat input
• Action editor — visual picker for every supported action type
• Requirement editor — view rules, click rules, and menu open rules
• Auto-save — changes flush to YAML automatically (configurable delay)
• Editor sounds — click, success, deny, delete, back, open (fully configurable)
• HDB Support — use HeadDataBase heads anywhere in the GUIs!

Runtime & Gameplay​

• Dynamic open command registration (e.g. /shop opens your menu)
• Left-click and right-click action lists per item
• View requirements — hide or alter items unless rules pass
• Click requirements — block clicks unless rules pass
• Open requirements — control who can open a menu
• Menu open actions — run actions when a menu opens
• Live refresh — updating placeholders/stats on a tick interval
• Click cooldown — prevent action spam
• Menu arguments — pass args when opening menus
• Bracket actions — DeluxeMenus-style [action] syntax support

DeluxeMenus Migration​

• Import from default path: plugins/DeluxeMenus/gui_menus/
• Import from custom folder: /cm import <path>
• Recursive subfolder support — gui_menus/shop/vip.yml becomes menu id shop/vip
• Optional backup of existing menus before overwrite
• Compatible material formats: hdb-, head-, basehead-, texture-

Interactive Tutorial​

• /cm tutorial — guided tour for staff
• Stages cover: overview, creating menus, settings, layout, items, lore, actions, requirements, commands
• Each stage uses title, subtitle, chat messages, and action-bar countdown
• /cm tutorial stop to exit anytime
• Fully editable via tutorial.yml

Integrations (Soft Dependencies)​

• PlaceholderAPI — placeholders in titles, lore, actions, and requirements
• Vault — economy actions and money requirements
• HeadDatabase — custom heads in items and editor

---

✦ Supported Actions (30+)​

• player — run command as player
• console — run command from console
• commandevent — unregistered player command
• message / minimessage — chat messages
• broadcast / minibroadcast
• placeholder — resolve placeholders
• openguimenu — open another CloudMenus menu
• connect — BungeeCord / Velocity server connect
• close / refresh
• sound / broadcastsound / broadcastsoundworld
• title / actionbar
• json / jsonbroadcast
• chat — chat as player
• givemoney / takemoney (Vault)
• giveexp / takeexp
• givepermission / takepermission
• meta — player persistent meta
• give / take — items

---

✦ Supported Requirements (25+)​

• Has permission / has permissions (minimum count)
• Has money (Vault)
• Has item
• Has meta (persistent data)
• Has EXP (points or levels)
• Is near location
• JavaScript expression
• String equals / equals ignore case / contains / length / regex
• Is object (player, uuid, int, double, etc.)
• Numeric comparisons: == != > >= < <=
• Placeholder comparisons (text and numeric)

---

✦ Commands​

Tip: If a menu has a registered open command, players can also use that command directly (e.g. /shop).

---

✦ Permissions​

---

✦ Configuration​

config.yml highlights​

• settings.prefix — chat prefix (gradients + legacy color codes supported)
• settings.auto-save-delay-ticks — editor auto-save delay
• settings.click-cooldown-ms — anti-spam for menu clicks
• settings.default-menu-size — default for new menus
• settings.enable-javascript-requirements — JS requirement toggle
• storage.menus-folder — where menu YAML files are stored
• storage.backup-on-import — backup before overwriting on import
• editor.session-timeout-minutes — editor session expiry
• integrations.* — toggle PlaceholderAPI, Vault, HeadDatabase
• sounds.* — full editor sound customization

Other files​

• messages.yml — fully translatable plugin messages
• tutorial.yml — customize tutorial stages, timings, and text
• menus/ — one YAML file per menu (supports nested folders)

---

✦ Perfect For​

• Survival / SMP / Skyblock servers needing shops, warps, kits, and rank GUIs
• Networks migrating from DeluxeMenus without rebuilding from scratch
• Teams with staff who are not comfortable with YAML
• Developers who still want YAML on disk for backups, Git, and portability
• Servers that want fast prototyping — clone menus, tweak, ship

---

✦ Requirements & Compatibility​

• Server: Paper 1.21+ (recommended)
• Java: 21
• Optional: PlaceholderAPI, Vault, HeadDatabase

---

✦ Quick Start (60 Seconds)​

1. Drop CloudMenus into plugins/ and restart
2. Run /cm import if migrating from DeluxeMenus
3. Run /cm tutorial for a guided walkthrough
4. Run /cm create shop or /cm editor
5. Build your layout, set an open command, and run /cm reload
6. Open your menu with your command or /cm open shop

---

✦ Support & Updates​

• Built by CloudStudios
• https://discord.gg/VB3M8DBTxE
• Regular updates and support
• CloudMenus Documentation

---