命令控制

命令控制

一个让服主完全控制玩家可见和可使用命令的模组。

管理

命令控制

完全掌控玩家可以看到和使用的命令!

命令控制是一个强大的服务器管理模组,允许你根据玩家等级配置命令访问权限——并无缝集成 LuckPerms。


为不同等级和 OP 隐藏、执行和阻止命令。


✨ 功能

🔒 完整的命令控制

  • 隐藏命令,使其不出现在 Tab 补全中——玩家只能看到他们被允许使用的命令
  • 阻止执行未授权的命令
  • 基于等级的权限——为不同玩家组配置不同命令

🔗 LuckPerms 集成

  • 自动从 LuckPerms 检测玩家组
  • 玩家等级变化时立即重新同步命令
  • 一键设置命令:/commandcontrols luckperms-setup

🎮 模组兼容性

  • 支持原版命令和模组命令
  • 兼容使用标准 Minecraft 权限检查(hasPermissionLevel)的模组
  • 示例:Create、WorldEdit、Carpet Mod、Essential Commands 等
  • 对 Xaero's Minimap、Litematica 等模组进行客户端侧过滤

⚠️ 注意: 拥有自己权限系统的模组(如 Impactor)需要直接在 LuckPerms 中设置权限,而不是通过本模组。


📦 安装

服务器(必需)

  1. 安装 Fabric Loader 和 Fabric API
  2. 将模组 JAR 放入你的 mods 文件夹
  3. (推荐)安装 LuckPerms 以实现基于等级的权限

客户端(可选)

在客户端安装后,也可以隐藏客户端侧模组命令。


⚙️ 配置

编辑 config/commandcontrols/commands.json:

{
  "rank_hierarchy": ["default", "premium", "vip", "vip+", "moderator", "admin", "owner"],
  "bypass_commands": ["help"],
  "commands": {
    "all_ranks": ["help", "msg", "me", "seed", "list"],
    "vip": ["nick", "hat", "fly"],
    "moderator": ["kick", "tp", "teleport", "clear", "spectate"],
    "admin": ["ban", "give", "gamemode", "time", "weather", "effect", "summon"],
    "owner": ["stop", "op", "deop", "whitelist", "luckperms", "reload"]
  }
}

工作原理:

  • rank_hierarchy - 从低到高的等级(高等级继承低等级的命令)
  • all_ranks - 所有人都可以使用的命令
  • [rank] - 该特定等级及以上可用的命令

🎯 LuckPerms 设置

自动(推荐)

以 OP 身份运行:

/commandcontrols luckperms-setup

这会自动为你的所有等级配置 LuckPerms!

后备方案(无 LuckPerms)

没有 LuckPerms 时,模组使用原版 OP 等级:

  • OP 4 → owner
  • OP 3 → admin
  • OP 2 → moderator
  • 其他所有人 → default

📋 命令

命令 描述
/commandcontrols OP 等级 4
/commandcontrols reload 重新加载配置
/commandcontrols luckperms-setup 自动设置 LuckPerms
/commandcontrols status 显示你当前的等级和允许的命令
/commandcontrols resync 同步你的等级权限

所有命令需要 OP 等级 4


🔧 技术细节

  • 通过反射覆盖命令权限(类似于 Player Roles)
  • 拦截命令树数据包以进行可见性过滤
  • 跟踪命令执行上下文以进行权限检查
  • 监听 LuckPerms 事件以在等级变化时立即重新同步

📝 要求

可选


❓ 常见问题

问:这对模组命令有效吗?
答:是的,对于使用 Minecraft 标准 hasPermissionLevel() 检查的模组(大多数模组)有效。拥有自定义权限系统的模组(如使用 Cloud Commands 的 Impactor)需要直接在 LuckPerms 中设置其权限。

问:玩家需要安装这个模组吗?
答:不需要,仅服务器端即可正常工作。但在客户端安装后也会隐藏客户端侧模组命令。

问:命令可见但无法执行?
答:确保命令在你的配置文件中,并且玩家拥有正确的 LuckPerms 组。