AuthCmd

AuthCmd

多功能Minecraft命令权限编辑器

🔐 AuthCmd

一个基于可配置权限名单,精细化控制玩家指令与游戏模式的 Minecraft 模组。

⚠️ 注意: 可视化编辑功能需要安装 AvalonBase 才能使用。未安装时,只能通过配置文件进行手动编辑。 ⚠️


📖 概述

AuthCmd 是一套双轨制指令权限管理方案,为 OP 与非 OP 玩家分别提供独立的指令访问控制策略。无论是限制普通玩家的可用指令,还是约束 OP 的越权行为,都可以通过一份简单的配置文件轻松实现。

无需重启服务器,配置保存后自动同步至所有在线玩家,Tab 补全即时生效。


✨ 核心功能

👤 非 OP 玩家:指令白名单

  • 仅白名单内的指令可被执行,其余指令全部拦截
  • 支持 Tab 补全,白名单内指令在客户端可正常补全
  • 支持根命令(如 gamemode),命中后其所有子命令一并放行

🛡️ OP 玩家:指令黑名单

  • 黑名单内的指令被拦截,其余指令正常使用
  • 有效防止 OP 误操作或滥用高风险指令

🎮 游戏模式切换控制

  • 可分别限制 OP 与非 OP 玩家的游戏模式切换权限
  • 支持按玩家名单独豁免,灵活适配管理需求

⭐ 豁免玩家机制

  • 被加入豁免名单的玩家完全放行,不受任何上述规则限制

⚙️ 四种生效模式

模式 效果
disabled 完全关闭,模组不干预任何指令
non_op_only 仅启用非 OP 白名单
op_only 仅启用 OP 黑名单
both 双轨同时启用

🔧 配置方式

📄 手动配置文件

配置文件位于 config/authcmd.toml,结构清晰、开箱即用:

  • 生效模式切换
  • 白名单 / 黑名单 / 豁免名单管理
  • 可视化编辑开关与提示开关

配置变更后自动重发命令树,客户端补全无延迟更新。

🖱️ 可视化编辑(可选)

安装前置模组 AvalonBase 后,会在游戏暂停页面额外显示可视化编辑按钮,可在游戏内直接编辑名单,无需手动修改配置文件。

未安装 AvalonBase 时,模组作为纯服务端模组独立运行,核心功能不受任何影响。


🛠️ 适用场景

  • 🏠 小型私人服务器:限制普通玩家只能使用基础指令,防止误操作
  • 🏢 大型公共服务器:规范 OP 行为,避免高风险指令被滥用
  • 🧪 模组测试环境:精细化控制测试人员可用指令范围
  • 🎯 自定义游戏模式:配合白名单打造特色指令体系

📦 下载与支持