CommandWorld

# 🌍 CommandWorld > **Per-world command control and chat isolation for Paper, Purpur, Spigot, and Bukkit servers.** Granular whitelist/blacklist rules per world, world group, and LuckPerms group — with a fully-featured staff communication suite. Built for networks, SMPs, minigame servers, and any multi-world setup. --- ## 🔍 Why CommandWorld? Most Minecraft servers with multiple worlds suffer from the same problem — players can run any command from anywhere, chat bleeds across worlds, and staff have no clean way to communicate privately. CommandWorld solves all of it in one lean, zero-database plugin. - 🔒 Granular command control — whitelist or blacklist any command per scope: global, world, world group, or LuckPerms group - 🌐 World-isolated chat — players only see messages from their own world or world group - 📢 Global chat override — prefix a message with ! to broadcast across all worlds instantly - 👮 Staff chat — a dedicated private channel for your staff team, toggleable per session - 🕵️ Chat spy — staff can silently monitor chat across every world at once - ⚙️ Live config editing via commands — add/remove/list command rules without ever touching a file - 🏅 LuckPerms integration — apply command rules directly to LP permission groups with highest priority - 🔄 Hot reload — all changes apply live with /cw reload --- ## 🛡️ Command Control System > Block or allow any command anywhere on your server, down to the individual player rank. ### 🎯 Scope Priority (Highest → Lowest) 1. LuckPerms Group — per-rank rules (e.g. admin, mod, vip, default) 2. World Group — shared rules across linked worlds (e.g. survival, lobby, minigame) 3. Individual World — override rules for a specific world 4. Global Default — fallback rules applied everywhere else ### ✅ Whitelist / Blacklist Modes - Whitelist — only listed commands are allowed and visible - Blacklist — all commands are allowed except listed ones - Each scope has its own independent mode, configurable at any time ### 🔕 Tab-Complete Suppression - Command rules apply to both execution and tab-complete separately - Players in restricted worlds won't even see blocked commands when pressing Tab ### 🚫 Default-Deny by Default - Out of the box, the default LuckPerms group is set to whitelist with an empty list — players can use zero commands until you open them up - Admins are set to blacklist with an empty list — full access to everything by default --- ## 💬 Chat System > Per-world chat isolation, cooldowns, filtered words, join/leave messages, and full MiniMessage formatting. ### 🌏 World-Isolated Chat - Players only receive messages from their own world or world group - Configurable join/leave messages scoped to each world group - Optional chat clear on world switch ### 📢 Global Chat - Any player can prefix a message with ! to send it across all worlds - Requires the commandworld.globalchat permission (toggled on/off per server) - Fully configurable format with MiniMessage support ### ⏱️ Chat Cooldowns - Per-world-group cooldown in seconds (e.g. Survival: 2s, Lobby: 1s, Minigame: off) - Custom cooldown message with %remaining% placeholder ### 🚫 Word Filter - Server-wide blocked words list (case-insensitive) - Custom blocked word message ### 🎨 Chat Formatting - Full MiniMessage colour and style support - Placeholders: %player%, %message%, %world%, %prefix%, %suffix% - Per-world-group format — each zone has its own chat style --- ## 👮 Staff Tools ### 💬 Staff Chat (/staffchat, /sc) - Toggle staff-only chat mode — all messages go to staff instead of public chat - Or send a one-off staff message without toggling - Optional sound on receipt - Requires commandworld.staff to receive, commandworld.staffchat to send ### 🕵️ Chat Spy (/chatspy) - Monitor all world chats simultaneously in real time - Configurable whether spy includes staff chat, global chat, or the spy's own context - Optional sound on receipt - Requires commandworld.chatspy --- ## 🔌 Dependencies ### Required - Paper, Purpur, Spigot, or Bukkit 1.21 or a compatible fork ### Recommended - LuckPerms — for per-group command rule tiers - Multiverse-Core — for world group detection and routing --- ## ⚙️ Configuration > 100% configurable. World groups, command rules, chat formats, cooldowns, staff tools, and all messages live in config.yml. world-groups: survival: - world - world_nether - world_the_end lobby: - lobby minigame: - minigame1 - minigame2 groups: admin: mode: blacklist execution: tab-complete: mod: mode: blacklist execution: - /stop - /op default: mode: whitelist execution: tab-complete: chat: enabled: true format: survival: '<gray> <white>%prefix%%player%%suffix%<dark_gray>: <white>%message%' cooldown: survival: 2 lobby: 1 ### 🎨 What You Can Customize - 🌍 World groups — link any worlds to share command rules and chat - 🔒 Per-