AuthCmd

🔐 AuthCmd

A Minecraft mod that provides fine-grained control over player commands and game modes through configurable permission lists.

⚠️ Note: The visual editor feature requires AvalonBase to be installed. Without it, configuration can only be done manually via the configuration file.

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

📖 Overview

AuthCmd is a dual-track command permission management solution that applies independent command access policies to OP and non-OP players respectively. Whether you want to restrict available commands for regular players or constrain OP privileges, everything can be managed through a simple configuration file.

No server restart required — configuration changes are automatically synchronized to all online players, with Tab completion updating instantly.

✨ Key Features

👤 Non-OP Players: Command Whitelist

• Only whitelisted commands can be executed; all others are blocked
• Full Tab completion support — whitelisted commands autocomplete normally for non-OP players
• Supports root commands (e.g., gamemode) — whitelisting a root command grants access to all its subcommands

🛡️ OP Players: Command Blacklist

• Blacklisted commands are blocked; all others function normally
• Effectively prevents OP misuse or accidental execution of dangerous commands

🎮 Game Mode Switching Control

• Independently restrict game mode switching permissions for OP and non-OP players
• Supports per-player exemption for flexible administration

⭐ Exempt Player Mechanism

• Exempt players are completely bypassed — they are not subject to any of the above restrictions

⚙️ Four Operation Modes

Mode	Effect
disabled	Fully disabled — mod does not intervene
non_op_only	Only non-OP whitelist is active
op_only	Only OP blacklist is active
both	Both tracks active simultaneously

🔧 Configuration

📄 Manual Configuration File

Configuration file located at config/authcmd.toml, clean and ready to use:

• Operation mode switching
• Whitelist / blacklist / exemption list management
• Visual editor toggle and tip display toggle

Configuration changes automatically resend the command tree to clients — Tab completion updates without delay.

🖱️ Visual Editor (Optional)

With the AvalonBase mod installed, an additional visual editor button appears on the pause screen, allowing in-game list editing without manually modifying the configuration file.

Without AvalonBase, AuthCmd runs perfectly as a standalone server-side mod — all core functionality remains intact.

🛠️ Use Cases

• 🏠 Small private servers: Restrict regular players to basic commands only, preventing accidents
• 🏢 Large public servers: Regulate OP behavior and prevent high-risk command abuse
• 🧪 Mod test environments: Fine-tune available commands for testers
• 🎯 Custom game modes: Build a unique command ecosystem with whitelists

---

🔐 AuthCmd

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

📖 概述

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 行为，避免高风险指令被滥用
• 🧪 模组测试环境： 精细化控制测试人员可用指令范围
• 🎯 自定义游戏模式： 配合白名单打造特色指令体系

---