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

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

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: 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:#00ffff:#00aaff:#a855f7><message></gradient></bold>" }

  playerstate:
    nick_max_length: 16
    nick_presets:
      - { name: rainbow, permission: commandsplus.nick.preset.rainbow, style: "<rainbow><message></rainbow>" }
      - { 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.

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.

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.

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

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