Commands++
Minecraft 服务器的现代基础工具替代方案。 一个 YAML 文件即可控制所有实用功能——家园、传送点、传送请求、隐身、监禁、静音、邮件、工具箱、经济系统、聊天格式化——可在 Paper、Folia 和 Purpur 上按模块切换。
什么是 Commands++
一个原语概念——模块(modules)——驱动服务器上的所有功能。每个模块都是一个自包含的功能单元,拥有独立的命令、监听器、配置部分和数据文件。在 config.yml 中切换模块,使用 /cmds enable|disable <module> 热切换,或执行 /cmds reload 应用编辑。无需重启,无监听器泄漏,不会出现一半 Adventure API 一半旧版风格的输出。
默认自带 23 个模块。124 个命令。将 jar 包放入插件目录,设置你的 Discord 邀请链接,执行 /cmds reload,完成。
为什么服务器管理员选择它
- 每个功能独立开关。 不想要家园功能?设置
modules.homes.enabled: false。不想要聊天格式化?关闭该模块即可。大多数插件强制开启所有功能。
- 跨领域强制执行。 静音不仅屏蔽聊天,还屏蔽
/msg、/r、/me、/mail。监禁会阻止所有传送命令(并在 TPA 延迟执行时重新检查)。隐身状态对 /players、/lastseen、/whois、/getpos、加入/离开广播以及最后在线更新不可见。大多数插件只能半实现这些功能。
- 重载安全。
/cmds reload 真正注销了监听器。大多数插件会在重载后悄悄泄漏处理器并重复触发事件。
- 原生支持 Folia。 区域调度器、异步调度器、实体调度器——均在适当位置使用。全面使用
teleportAsync。完全不使用旧版的 Bukkit.getScheduler()。
- 全面使用 MiniMessage。 支持渐变、悬停、点击、彩虹效果。旧的
& 代码仍然有效——自动检测。无需任何 MiniMessage 知识即可开始使用。
- 审计日志记录。 每项针对其他玩家的管理员操作都会追加到
audit.log 中,包含时间戳、操作者和目标。大多数 Essentials 类插件没有等效功能。
- 即插即用。 自带品牌化渐变前缀、工作正常的默认值、动态彩虹欢迎标题,并通过
/support、欢迎消息和 /cmds version 连接 Discord CTA。启动时零编辑即可使用。
模块——用于一切的原语
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 超过此值需要 /payconfirm
chat:
enabled: true
format: "<prefix><white><displayname></white><suffix> <dark_gray>»</dark_gray> <message>"
luckperms_prefix: true
每个模块具有相同的结构:enabled 加上其专属的键。插件升级带来的新默认值会合并进来,而不会覆盖你的编辑内容。
运行时切换
| 命令 |
效果 |
/cmds modules |
列出所有模块及其当前状态 |
/cmds enable <module> |
开启模块,立即运行其 onEnable |
/cmds disable <module> |
关闭模块,注销其监听器 + 取消其任务 |
/cmds reload |
重新读取配置和消息,重新启用模块 |
/cmds update |
手动检查 Modrinth |
跨领域强制执行
Commands++ 在此处深入超越了仅基于命令的 Essentials 检查。
静音(Mute) — 屏蔽聊天、/msg、/r、/me、/mail send。每条文本路径都通过单个辅助函数检查 PlayerStatus.isMuted,因此新增命令会自动获得静音效果。
监禁(Jail) — 屏蔽 /spawn、/home、/warp、/tpa、/tpahere、/back、/randomtp、/jumpto、/top、/tphere、/tppos、/world。TPA 延迟会在执行时重新检查,因此在倒计时期间进行监禁实际上会阻止传送。
隐身(Vanish) — 对 /players、/list、/lastseen、/whois、/getpos、/near 隐藏。抑制加入/离开广播。退出时跳过 lastseen.yml 更新。取消物品拾取 + 实体锁定。重连后保持状态。
AFK(空闲) — 根据移动和聊天自动检测。可选地配置空闲超时后自动踢出。打破空闲状态的聊天会前置 [AFK] 标签,而不是下一条消息。
视觉预设
基于权限的聊天和昵称渐变样式。玩家运行 /chatcolor list 或 /nick list 即可查看可点击应用的画廊。
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 种聊天预设和 13 种匹配的昵称预设。添加你自己的——只需添加一行 YAML。
两行实现品牌化
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
Discord 链接遍布各处——/support 命令、欢迎消息 CTA、/cmds version、引用 %discord% 的广播消息。一个字段,覆盖所有界面。
需要自定义前缀?用 &8[&bMyServer&8] &7 替换上面的 MiniMessage,解析器将回退到旧版代码。
命令
覆盖 23 个模块,共 124 条命令。
| 模块 |
命令 |
| 传送 |
/tpa /tpahere /tpaccept /tpdeny /tpcancel /tptoggle /tphere /tpall /tppos /tp /back /jumpto /top |
| 家 / warp点 / 出生点 |
/home /sethome /delhome /homes /warp /setwarp /delwarp /warps /spawn /setspawn /randomtp |
| 通讯 |
/msg /r /ignore /unignore /msgtoggle /socialspy /realname /me /mail /helpop |
| 玩家状态 |
/heal /feed /fly /god /afk /nick /speed /clearinventory /whois /near /getpos /exp /suicide /ext |
| 游戏模式 |
/gmc /gms /gma /gmsp /gamemode |
| 物品栏 |
/enderchest /workbench /anvil /repair /more /skull /i /give /trash /enchant /condense /hat /recipe /invsee |
| 管理 |
/mute /unmute /jail /unjail /setjail /jails /kick /ban /unban /tempban /banhistory /freeze /sudo /clearchat |
| 隐身 |
/vanish /vanishlist |
| 套装 |
/kit /kits |
| 世界 |
/world /worlds /time /weather /sun /rain /thunder /pweather /ptime |
| 工作人员 |
/staff add|remove|info|list|roles |
| 经济 (Vault) |
/pay /payconfirm /balance /baltop /eco |
| 管理员 |
/burn /lightning /firework /info |
| 聊天 / 昵称 |
/chatcolor (列表 / 预设 / 重置), /nick (列表 / 预设 / 设置 / 清除) |
| 插件 |
/cmds reload|modules|enable|disable|version|update |
运行 /help 可获取分页式、点击即建议的游戏中菜单。运行 /cmds help 可查看对应的管理员版本。
权限
单一层级结构:commandsplus.<module>.<command>[.other|.bypass|.list|.see]。默认值符合预期意图。
| 节点 |
默认值 |
授予 |
commandsplus.admin |
op |
通配符 — 所有操作员级别节点,包括所有渐变预设 |
commandsplus.<utility> |
true |
/home, /spawn, /msg, /help, /randomtp 等 |
commandsplus.<admin> |
op |
/heal, /mute, /jail, /vanish, /sudo 等 |
commandsplus.<command>.other |
op |
目标指向另一名玩家 |
commandsplus.<command>.bypass |
op |
跳过冷却时间 / 限制 |
commandsplus.homes.limit.<n> |
false |
分级家数量上限 — 授予 commandsplus.homes.limit.10 可获得十个家的上限 |
commandsplus.chat.style.<name> |
false |
特定预设的聊天渐变效果 |
commandsplus.nick.preset.<name> |
false |
特定预设的昵称渐变效果 |
将 commandsplus.admin 授予你的工作人员 LuckPerms 组 — 所有管理员命令均可用,所有渐变预设解锁。
集成
所有集成为软依赖。缺少所有这些插件时,Commands++ 也能正常运行。
| 插件 |
用途 |
| PlaceholderAPI |
commandsplus_* 占位符 — 家数量、AFK 状态、隐身状态、禁言/监禁剩余时间、未读邮件、延迟、在线时长 |
| Vault + 经济提供商 |
/pay, /balance, /baltop, /eco, /payconfirm |
| LuckPerms |
聊天格式前缀与后缀注入、基于组的权限管理 |
更新通知
启用时及每 6 小时异步轮询 Modrinth。当检测到新版本时:
- 控制台横幅显示已安装版本 → 最新版本 + 下载链接
- 任何拥有
commandsplus.update.notify 权限的玩家在加入服务器及每 30 分钟收到一次可点击的游戏内横幅
- 运行
/cmds update 进行手动检查
所有频率和 slug 均位于 modules.update.* 下。
平台支持
| 平台 |
支持情况 |
备注 |
| Paper 1.21+ |
✅ 完全支持 |
原生 Adventure API |
| Folia |
✅ 完全支持 |
全区域感知,处处使用 teleportAsync |
| Purpur 1.21+ |
✅ 完全支持 |
|
| Spigot 1.21+ |
⚠️ 有限支持 |
|
需要 Java 21+。
安装
- 从 Versions 页面下载 jar 文件。
- 将其放入服务器的
plugins/ 文件夹中。
- 启动服务器。
config.yml 和 messages.yml 将以合理的默认值生成。
- 打开
config.yml,将 support.discord_invite: 设置为你社区的链接。
- 运行
/cmds reload。
可选:安装 LuckPerms 以集成聊天前缀,安装 PlaceholderAPI 以使用占位符集。
链接
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
| 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: 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.
| 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 /suicide /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
- Download the jar from the Versions page.
- Drop it into your server's
plugins/ folder.
- Start the server.
config.yml and messages.yml generate with sane defaults.
- Open
config.yml, set support.discord_invite: to your community link.
/cmds reload.
Optional: install LuckPerms for chat prefix integration, PlaceholderAPI for the placeholder set.
Links
评论 0
登录后参与评分
还没有评论,来抢沙发吧