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, ✨. 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 ✨ 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

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. [AFK] 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.

modules:
  chat:
    permission_styles:
      - { name: ✨,     permission: commandsplus.chat.style.✨,     style: "<✨><message></✨>" }
      - { 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:#00ffff:#00aaff:#a855f7><message></gradient></bold>" }

  playerstate:
    nick_max_length: 16
    nick_presets:
      - { name: ✨, permission: commandsplus.nick.preset.✨, style: "<✨><message></✨>" }
      - { name: ocean,   permission: commandsplus.nick.preset.ocean,   style: "<gradient:#0088ff:#00ffff><message></gradient>" }

13 chat presets and 13 matching nick presets ship enabled. Add your own — it's just a YAML row.

---

Branding in two lines

prefix: "<bold><gradient:#00ffd5:#00aaff:#a855f7>[Commands++]</gradient></bold> <gray>"

support:
  discord_invite: "https://discord.gg/your-invite"
  discord_label:  "discord.gg/your-invite"
  show_in_welcome: true

The Discord propagates everywhere — /support command, welcome message CTA, /cmds version, broadcast messages that reference %discord%. One field, every surface.

Need a custom prefix? Replace the MiniMessage above with &8[&bMyServer&8] &7 and the parser falls back to legacy codes.

---

Commands

124 across 23 modules.

Module	Commands
Teleport	/tpa /tpahere /tpaccept /tpdeny /tpcancel /tptoggle /tphere /tpall /tppos /tp /back /jumpto /top
Homes / Warps / Spawn	/home /sethome /delhome /homes /warp /setwarp /delwarp /warps /spawn /setspawn /randomtp
Communication	/msg /r /ignore /unignore /msgtoggle /socialspy /realname /me /mail /helpop
Player state	/heal /feed /fly /god /afk /nick /speed /clearinventory /whois /near /getpos /exp /✨ /ext
Gamemode	/gmc /gms /gma /gmsp /gamemode
Inventory	/enderchest /workbench /anvil /repair /more /skull /i /give /trash /enchant /condense /hat /recipe /invsee
Moderation	/mute /unmute /jail /unjail /setjail /jails /kick /ban /unban /tempban /banhistory /freeze /sudo /clearchat
Vanish	/vanish /vanishlist
Kits	/kit /kits
World	/world /worlds /time /weather /sun /rain /thunder /pweather /ptime
Staff	/staff add|remove|info|list|roles
Economy (Vault)	/pay /payconfirm /balance /baltop /eco
Admin	/burn /lightning /firework /info
Chat / Nick	/chatcolor (list / preset / reset), /nick (list / preset / set / clear)
Plugin	/cmds reload|modules|enable|disable|version|update

Run /help for a paginated, click-to-suggest in-game menu. /cmds help for the admin equivalent.

---

Permissions

Single hierarchy: commandsplus.<module>.<command>[.other|.bypass|.list|.see]. Defaults match intent.

Node	Default	Grants
commandsplus.admin	op	Wildcard — every operator-level node, including all gradient presets
commandsplus.<utility>	true	/home, /spawn, /msg, /help, /randomtp, etc.
commandsplus.<admin>	op	/heal, /mute, /jail, /vanish, /sudo, etc.
commandsplus.<command>.other	op	Target another player
commandsplus.<command>.bypass	op	Skip cooldown / restriction
commandsplus.homes.limit.<n>	false	Tiered home cap — grant commandsplus.homes.limit.10 for ten homes
commandsplus.chat.style.<name>	false	Per-preset chat gradient
commandsplus.nick.preset.<name>	false	Per-preset nickname gradient

Grant commandsplus.admin to your staff LuckPerms group — every operator command works, every gradient preset unlocks.

---

Integrations

Every integration is a soft-depend. Commands++ runs cleanly with all of them missing.

Plugin	Used for
PlaceholderAPI	commandsplus_* placeholders — homes count, AFK, vanish, mute / jail remaining, mail unread, ping, uptime
Vault + economy provider	/pay, /balance, /baltop, /eco, /payconfirm
LuckPerms	Chat-format prefix + suffix injection, group-aware permissions

---

Update notifier

Async Modrinth poll on enable + every 6 hours. When a newer release is detected:

• Console banner with installed → latest version + download URL
• Clickable in-game banner sent to anyone with commandsplus.update.notify on join + every 30 minutes
• /cmds update for a manual check

All cadences and the slug live under modules.update.*.

---

Platform support

Platform	Support	Notes
Paper 1.21+	✅ Full	Native Adventure
Folia	✅ Full	Region-aware throughout, teleportAsync everywhere
Purpur 1.21+	✅ Full
Spigot 1.21+	⚠ Limited

Java 21+ required.

---

Install

1. Download the jar from the Versions page.
2. Drop it into your server's plugins/ folder.
3. Start the server. config.yml and messages.yml generate with sane defaults.
4. Open config.yml, set support.discord_invite: to your community link.
5. /cmds reload.

Optional: install LuckPerms for chat prefix integration, PlaceholderAPI for the placeholder set.

---

Links

• Discord — discord.gg/aJqqs2hYQJ
• MiniMessage docs — docs.advntr.dev/minimessage/format.html
• Hex color picker — htmlcolorcodes.com/color-picker
• Companion plugin — Broadcast++ for full-featured server announcements