授权转载 开源 [MAC] 模组准入控制 Mod Access Control 1.0.3

简介​

注意：客户端也需要安装本模组才能完成握手校验；未安装的客户端加入服务器时会被拦截（可通过配置项 requireClientMod 关闭该强制要求）。

点击展开...

特性​

• 两阶段握手：登录阶段仅交换协议、加载器等基础信息；进入世界前复核完整模组列表，之后按时间间隔定期复检（无需重复传输数据）。
• 必需模组校验：支持三种校验模式：存在性校验（presence）、版本范围校验（version_range）、严格版本匹配（strict）。
• 策略系统：白名单 / 黑名单 /switch 双模式，可随时切换生效策略，并按间隔自动复检。
• 游戏内规则管理：使用 /mac 命令实时查看、增删、重载、保存白 / 黑名单与必需模组清单，全部支持 Tab 补全；支持 /mac learn，根据任意在线玩家的模组列表一键生成名单。
• 服务端多语言：踢出界面、管理员通知、命令返回提示等文案由服务端配置控制，支持简体中文、繁体中文、英语、日语、俄语，可使用 /mac lang <语言> 切换；语言文件为 JSON，方便自行扩展新增语言。
• 清晰玩家提示：被拦截玩家的断开弹窗会明确列出缺失的必需模组、版本不匹配详情、命中黑名单或不在白名单内的模组，底部提示区域支持自定义文案。
• 豁免机制：可按玩家名或 UUID 豁免指定玩家，也可一键豁免全部 OP。
• 试运行模式：仅记录违规信息并发送通知，不会踢出玩家，适合上线前测试规则，避免误踢。
• 模组历史与审计：每位玩家的客户端模组清单持久化存储（JSONL 格式），支持 /mac audit 审计记录、/mac recent 查看近期违规记录。
• 管理员提醒：发生玩家拦截事件时，在线管理员会收到聊天栏消息 + ActionBar 提示 + 音效三重提醒。
• 高稳定性：配置文件损坏时自动备份并重置；全流程异常捕获与日志记录，不会造成服务器崩溃。

配置说明​

常用配置项​

白 / 黑名单与必需模组均支持 * 通配符以及版本约束（=、!=、>、>=、<、<=，多条约束为「且」关系）

点击展开...

指令列表​