Commands++ | Next-Level Command Management Plugin

# Commands++ **The modern essentials replacement for Minecraft servers.** One YAML file controls every utility — homes, warps, teleport requests, vanish, jail, mute, mail, kits, economy, chat formatting — toggleable per-module on Paper, Folia, and Purpur. --- ## What is Commands++ A single primitive — **modules** — runs every feature on the server. Each module is a self-contained feature with its own commands, listeners, config section, and data files. Toggle a module in `config.yml`, hot-flip it with `/cmds enable|disable <module>`, or `/cmds reload` to apply edits. No restart, no listener leaks, no half-Adventure half-legacy output. 23 modules ship by default. 124 commands. Drop the jar in, set your Discord invite, `/cmds reload`, done. --- ## Why server owners pick it - **One toggle per feature.** Don't want homes? `modules.homes.enabled: false`. Don't want chat formatting? Turn off the module. Most plugins force everything on. - **Cross-cutting enforcement.** Mute blocks chat *and* `/msg`, `/r`, `/me`, `/mail`. Jail blocks every teleport command (and re-checks at TPA delay execute). Vanish hides from `/players`, `/lastseen`, `/whois`, `/getpos`, join/quit broadcasts, and lastseen updates. Most plugins half-implement this. - **Reload-safe.** `/cmds reload` actually unregisters listeners. Most plugins quietly leak handlers and double-fire events after reload. - **Folia-native.** Region scheduler, async scheduler, entity scheduler — used appropriately throughout. `teleportAsync` everywhere. No legacy `Bukkit.getScheduler()` anywhere. - **MiniMessage everywhere.** Gradients, hover, click, rainbow. Legacy `&`-codes still work — auto-detected. Zero MiniMessage knowledge required to start. - **Audit-logged.** Every admin action targeting another player appends to `audit.log` with timestamp + actor + target. Most essentials plugins have nothing equivalent. - **Plug-and-play.** Ships with branded gradient prefix, working defaults, animated rainbow welcome title, and a Discord CTA wired through `/support`, the welcome message, and `/cmds version`. Useful on boot with zero edits. --- ## Modules — one primitive for everything ```yaml modules: homes: enabled: true default_max_homes: 3 default_home_name: home teleport: enabled: true request_timeout_seconds: 60 teleport_delay_seconds: 3 cancel_on_movement: true cancel_on_damage: true randomtp: enabled: true cooldown_seconds: 60 max_attempts: 12 worlds: world: { center_x: 0, center_z: 0, radius: 5000, min_y: 64, max_y: 256 } economy: enabled: true confirm_threshold: 1000.0 # /pay above this requires /payconfirm chat: enabled: true format: "<prefix><white><displayname></white><suffix> <dark_gray>»</dark_gray> <message>" luckperms_prefix: true ``` Every module has the same shape: `enabled` plus its own keys. New defaults from plugin upgrades merge in without overwriting your edits. ### Toggle at runtime | Command | Effect | | --- | --- | | `/cmds modules` | List every module + its current state | | `/cmds enable <module>` | Turn it on, run its `onEnable` immediately | | `/cmds disable <module>` | Turn it off, unregister its listeners + cancel its tasks | | `/cmds reload` | Re-read config + messages, re-enable modules | | `/cmds update` | Manual Modrinth check | --- ## Cross-cutting enforcement Where Commands++ goes deeper than per-command Essentials checks. **Mute** — blocks chat, `/msg`, `/r`, `/me`, `/mail send`. Every text path checks `PlayerStatus.isMuted` from a single helper, so adding a new command picks up muting for free. **Jail** — blocks `/spawn`, `/home`, `/warp`, `/tpa`, `/tpahere`, `/back`, `/randomtp`, `/jumpto`, `/top`, `/tphere`, `/tppos`, `/world`. The TPA delay re-checks at execute time, so jailing during the countdown actually stops the teleport. **Vanish** — hides from `/players`, `/list`, `/lastseen`, `/whois`, `/getpos`, `/near`. Suppresses join/quit broadcasts. Skips `lastseen.yml` updates on quit. Cancels item pickups + entity targeting. Persists through rejoins. **AFK** — auto-detected from movement and chat. Optional auto-kick after configurable idle. `` tag prepends to the chat that breaks the idle, not the next one. --- ## Visual presets Per-permission gradient styles for chat AND nicknames. Players run `/chatcolor list` or `/nick list` to see a click-to-apply gallery. ```yaml modules: chat: permission_styles: - { name: rainbow, permission: commandsplus.chat.style.rainbow, style: "<rainbow><message></rainbow>" } - { name: fire, permission: commandsplus.chat.style.fire, style: "<gradient:#ff5555:#ffaa00:#ffff55><message></gradient>" } - { name: vip_gold, permission: commandsplus.chat.style.vip_gold, style: "<bold><gradient:#ffd700:#fff8a0><message></gradient></bold>" } - { name: mvp_diamond, permission: commandsplus.chat.style.mvp_diamond, style: "<bold><gradient:#00f