mCommand
适用于 Paper、Purpur 和 Folia 的轻量级模块化管理命令。
mCommand 专为只需要专注管理工具集的服务器而设计。每个命令都通过 Brigadier 注册,并且可以禁用整个模块以避免与 EssentialsX 或其他命令套件发生冲突。
功能
- 状态工具:飞行、上帝模式、治疗、喂食、修复、速度、灭火和游戏模式
- Moderation(管理):权限感知的员工 GUI、物品栏和末影箱检查、持久冻结和隐身、审计 sudo、广播和聊天清理
- 传送:返回、顶端、玩家传送、传送到此处、坐标以及确认全服传送
- 信息:延迟、最后上线、游戏时长、附近玩家以及隐私敏感的 whois
- 便携式工作台:工作台、铁砧、砂轮台、制图台、织布机和锻造台
- 安全的物品名称和描述文本,除非授予高级格式化权限,否则限制 MiniMessage 标签
- 持久化的
/back 位置记录在服务器刻之外写入
/serverinfo TPS、MSPT、玩家、世界和内存诊断
- 可配置的输入限制,用于广播、sudo 命令、物品名称和描述文本
要求
- Java 25
- Paper、Purpur 或 Folia 26.3 (Minecraft 1.21.11)
不需要 Velocity,也不包含代理端工件。
安装
- 将
mCommand-1.1.1.jar 放入服务器的 plugins 目录。
- 启动服务器一次。
- 编辑
plugins/mCommand/config.yml,更改命令模块后重启服务器。
默认语言为英语。设置 language.default: ru_RU 可使用内置的俄语翻译。
配置
state、utils、moderation、world 和 info 模块可以独立切换。禁用的模块不会注册其命令,因此这些字面量和建议会消失,其他插件可以接管它们。单个命令还有第二个开关 commands.<name>.enabled。
limits.near-max-radius 限制 /near;limits.max-teleport-coordinate 验证 /tppos。长度限制保护广播、sudo、物品名称和描述文本的输入。moderation.freeze.allowed-commands 确保被冻结的玩家仍可获得帮助和报告功能。/mcommand reload 安全地重新加载消息和限制,但命令注册的更改需要重启。
命令
- state:
/fly, /god, /heal, /feed, /repair, /speed, /ext, /gm
- moderation:
/staff <player>, /invsee, /endersee, /freeze, /unfreeze, /vanish, /sudo, /broadcast, /clearchat
- teleport and utilities:
/tp, /tphere, /tppos, /tpall confirm, /back, /top, /hat, /clear, /skull, /itemname, /lore
- workstations:
/wb, /anvil, /grindstone, /cartography, /loom, /smithing
- information:
/ping, /seen, /playtime, /near [radius], /whois <player>, /serverinfo
- optional world module:
/day, /night, /sun, /rain
- administration:
/mcommand reload
Brigadier 提供命令语法和在线玩家建议。不接受玩家参数的命令仅限玩家使用,除非其行为从控制台执行有意义。
权限
mcommand.commands 授予基础命令集,mcommand.admin 添加敏感功能。请谨慎授予高级节点:
mcommand.command.sudo.self, .other, .console; mcommand.exempt.sudo
mcommand.command.invsee.modify, .offline; mcommand.exempt.invsee
mcommand.command.gm.other, mcommand.command.clear.other, mcommand.command.tp.other
mcommand.command.fly.other, .god.other, .heal.other, .feed.other, .ext.other
mcommand.command.vanish.other, mcommand.vanish.see
mcommand.command.whois.ip 用于完整 IP 地址
mcommand.command.speed.max.<1-10> 用于速度上限
mcommand.format.unsafe 用于交互式 MiniMessage 标签
mcommand.exempt.bypass 以覆盖受保护玩家的节点
基础命令权限使用 mcommand.command.<command>。豁免默认关闭;管理权限默认对操作员开放。
遥测和更新
mCommand 使用 bStats 插件 ID 33356 进行匿名使用统计。通过 metrics.enabled: false 禁用它。
更新设置与遥测分开。通过 updates.enabled: false 禁用更新发现;不会自动下载或替换 JAR 文件。
构建
./gradlew clean build
发布版 JAR 文件写入到 build/libs/mCommand-1.1.1.jar。该项目采用 MIT License 许可。
mCommand
Lightweight modular administration commands for Paper, Purpur, and Folia.
mCommand is designed for servers that only need a focused administration toolkit. Every command is registered through Brigadier, and whole modules can be disabled to avoid conflicts with EssentialsX or another command suite.
What it does
- state tools: flight, god mode, heal, feed, repair, speed, extinguish, and game mode
- moderation: permission-aware staff GUI, inventory and ender chest inspection, persistent freeze and vanish, audited sudo, broadcast, and chat clearing
- teleportation: back, top, player teleport, teleport-here, coordinates, and confirmed teleport-all
- information: ping, last seen, playtime, nearby players, and privacy-aware whois
- portable workstations: crafting table, anvil, grindstone, cartography table, loom, and smithing table
- safe item names and lore with restricted MiniMessage tags unless an elevated formatting permission is granted
- persistent
/back locations written outside the server tick
/serverinfo TPS, MSPT, player, world, and memory diagnostics
- configurable input limits for broadcasts, sudo commands, item names, and lore
Requirements
- Java 25
- Paper, Purpur, or Folia 26.3 (Minecraft 1.21.11)
Velocity is not required and no proxy artifact is included.
Install
- Put
mCommand-1.1.1.jar in the server's plugins directory.
- Start the server once.
- Edit
plugins/mCommand/config.yml and restart when changing command modules.
English is the default language. Set language.default: ru_RU for the bundled Russian translation.
Configuration
The state, utils, moderation, world, and info modules can be toggled independently. A disabled module does not register its commands, so those literals and suggestions disappear and another plugin can own them. Individual commands have a second commands.<name>.enabled switch.
limits.near-max-radius caps /near; limits.max-teleport-coordinate validates /tppos. Length limits protect broadcast, sudo, item-name, and lore input. moderation.freeze.allowed-commands keeps help and reporting available to frozen players. /mcommand reload safely reloads messages and limits, but command registration changes require a restart.
Commands
- state:
/fly, /god, /heal, /feed, /repair, /speed, /ext, /gm
- moderation:
/staff <player>, /invsee, /endersee, /freeze, /unfreeze, /vanish, /sudo, /broadcast, /clearchat
- teleport and utilities:
/tp, /tphere, /tppos, /tpall confirm, /back, /top, /hat, /clear, /skull, /itemname, /lore
- workstations:
/wb, /anvil, /grindstone, /cartography, /loom, /smithing
- information:
/ping, /seen, /playtime, /near [radius], /whois <player>, /serverinfo
- optional world module:
/day, /night, /sun, /rain
- administration:
/mcommand reload
Brigadier supplies command syntax and online-player suggestions. Commands that accept no player are player-only unless their behavior is meaningful from the console.
Permissions
mcommand.commands grants the base command set and mcommand.admin adds sensitive capabilities. Give elevated nodes deliberately:
mcommand.command.sudo.self, .other, .console; mcommand.exempt.sudo
mcommand.command.invsee.modify, .offline; mcommand.exempt.invsee
mcommand.command.gm.other, mcommand.command.clear.other, mcommand.command.tp.other
mcommand.command.fly.other, .god.other, .heal.other, .feed.other, .ext.other
mcommand.command.vanish.other, mcommand.vanish.see
mcommand.command.whois.ip for full IP addresses
mcommand.command.speed.max.<1-10> for speed ceilings
mcommand.format.unsafe for interactive MiniMessage tags
mcommand.exempt.bypass to override protected-player nodes
Base command permissions use mcommand.command.<command>. Exemptions default to false; administrative permissions default to operators.
Telemetry and updates
mCommand uses bStats plugin ID 33356 for anonymous usage statistics. Disable it with metrics.enabled: false.
The update setting is separate from telemetry. Disable update discovery with updates.enabled: false; no JAR is downloaded or replaced automatically.
Build
./gradlew clean build
The release JAR is written to build/libs/mCommand-1.1.1.jar. The project is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧