- 版权类型
- 原创
- 语言支持
- 中文(简体)
- 前置组件
- 【均为可选】
GMLIB - https://github.com/GroupMountain/GMLIB
GMLIB-LegacyRemoteCallApi - https://github.com/GroupMountain/GMLIB-LegacyRemoteCallApi
- 适配版本(基岩)
- 全版本
GwAntiCheat - BDS基岩版反作弊插件
简介
GwAntiCheat (GAC) 是一款多功能的Minecraft基岩版BDS服务端反作弊插件,基于LeviLamina Script Engine (LSE) 开发。插件提供了全方位的反作弊保护,有效维护服务器的公平游戏环境。
功能特性
核心反作弊模块
移动检测
- 移动速度检测:智能检测异常移动速度
- 飞行检测:检测非创造模式下的飞行行为
- 支持飞行速度配置:可单独设置飞行状态下的速度限制
- 智能豁免:自动豁免传送、死亡重生等情况
战斗检测
- 攻击频率限制:防止连点器和杀戮光环
- 长臂猿检测:检测超出正常范围的攻击/交互距离
- NoFall检测:检测无摔落伤害作弊
物品检测
- 非法堆叠检测:根据物品类型检测异常堆叠
- 32k武器检测:检测攻击力异常的武器
- 附魔等级检测:限制过高的附魔等级
- 修复成本检测
- 物品锁定检测
- 死亡不掉落检测
- 自定义名称和描述长度限制
- 潜影盒内容检测:检查潜影盒内的非法物品
- 烟花火箭(飞行时间、爆炸效果)
- 成书(页数、内容长度)
- 附魔书(附魔数量)
- 禁用物品:可配置的禁用物品列表
- 自动修复:自动修正违规物品的NBT数据
聊天保护
- 反刷屏:限制消息发送频率
- 消息长度限制:防止超长消息
- 命令选择器过滤:防止滥用@e等选择器
系统保护
- 反假OP:自动检测和移除非法获得的OP权限
- 玩家身份认证:验证玩家XUID、UUID等信息
- 反非法客户端:检测未知客户端
- 经验限制:限制单次获得的经验数量
- 丢包检测:检测异常的网络丢包率
管理功能
白名单系统
- 添加/移除白名单玩家
- 白名单玩家豁免所有检测
封禁系统
- 自动封禁违规次数过多的玩家
- 手动解封功能
- 封禁记录持久化存储
违规反馈
- 控制台日志输出
- 游戏内广播(可选)
- 模式表单警告(可选)
- 违规容忍度系统
安装方法
- 确保服务器已安装 LeviLamina
- 下载 GwAntiCheat.js 文件
- 将文件放置到 plugins/GwAntiCheat/ 目录
- (可选)如需使用假种子功能,请安装 GMLIB-LegacyRemoteCallApi
- 重启服务器或使用命令重载插件
配置说明
配置文件位于 plugins/GwAntiCheat/config/config.json
JSON:
// 移动速度检测
movement: {
enabled: true,
maxBlocksPerSecond: 15, // 正常移动速度
maxBlocksPerSecondFlying: 30, // 飞行时的移动速度
checkFlyingSpeed: false, // 是否检测飞行速度(false时飞行不检测)
checkInterval: 1000,
exemptAfterTeleport: 5000, // 增加到5秒
exemptAfterDeath: 10000 // 增加到10秒
},
// 假种子
fakeSeed: {
enabled: false, // 默认关闭,需要GMLIB
seed: 1145141919810
},
// 附魔检测
enchantment: {
enabled: true,
maxLevel: 32, // 提高到32级
checkInterval: 1000 // 增加到5秒
},
// 反假OP
antiOp: {
enabled: true,
checkInterval: 2000
},
// 攻击频率检测
combat: {
enabled: true,
maxAttacksPerSecond: 30, // 提高到30
checkWindow: 1000
},
// 经验检测
experience: {
enabled: true,
maxExperiencePerGain: 5000 // 提高到5000
},
// 反非法客户端
antiIllegalClient: {
enabled: false, // 默认关闭,可能误判
kickUnknownOS: true
},
// 防长臂猿
reach: {
enabled: true,
maxReachDistance: 8, // 提高到8格
maxPlaceDistance: 10 // 提高到10格
},
// 反刷屏
antiSpam: {
enabled: true,
maxMessagesPerSecond: 5, // 提高到5条
checkWindow: 5000,
muteTime: 3000
},
// 消息长度限制
messageLength: {
enabled: true,
maxLength: 50 // 提高到500
},
// 物品检测
itemCheck: {
enabled: true,
maxStackSize: 64, // 最大堆叠数量(某些物品应该是1或16)
checkStackSize: true, // 检查堆叠数量
checkIllegalNBT: true, // 检查非法NBT
checkShulkerBox: true, // 检查潜影盒内容
maxRepairCost: 40, // 最大修复成本
max32kDamage: 100, // 最大攻击伤害(防止32k武器)
bannedItems: [ // 被禁止的物品列表
"minecraft:bedrock",
"minecraft:barrier",
"minecraft:command_block",
"minecraft:chain_command_block",
"minecraft:repeating_command_block",
"minecraft:structure_block",
"minecraft:jigsaw",
"minecraft:light_block",
"minecraft:border_block",
"minecraft:allow",
"minecraft:deny"
],
checkInterval: 1000
},
// 命令选择器过滤
commandFilter: {
enabled: true,
blockedSelectors: ["@e"] // 只禁用@e
},
// 玩家认证
authentication: {
enabled: false, // 默认关闭
checkName: true,
checkXuid: true,
checkUuid: true
},
// 丢包检测
packetLoss: {
enabled: false, // 默认关闭
maxPacketLoss: 50,
checkInterval: 5000
},
// 反作弊反馈
feedback: {
logToConsole: true,
broadcastInGame: false, // 默认不广播
maxViolations: 20, // 提高到20次
useBan: false, // 默认不封禁
showModalWarning: true
}
命令列表
所有命令需要管理员权限(OP)/gac whitelist add <玩家名>添加玩家到白名单
/gac whitelist remove <玩家名>从白名单移除玩家
/gac whitelist list[/td][td]查看白名单列表
/gac reload[/td][td]重新加载配置文件
/gac status查看插件状态和模块启用情况
/gac unban <玩家名/XUID>解封指定玩家
/gac check <玩家名>检查玩家状态和物品
数据存储
插件数据存储在 plugins/GwAntiCheat/data/ 目录:日志文件存储在 logs/GwAntiCheat.log
使用建议
首次使用
- 观察模式:建议先将 feedback.broadcastInGame 和 feedback.useBan 设为 false
- 调整阈值:根据服务器情况调整各项检测阈值
- 查看日志:通过日志文件了解检测情况
- 逐步启用:确认无误判后再启用更严格的措施
性能优化
- 可以禁用不需要的检测模块以提高性能
- 调整检测间隔(checkInterval)以平衡性能和安全性
- 大型服务器建议适当提高各项阈值
兼容性说明
- 支持所有标准的Minecraft基岩版
- 兼容大部分其他LSE插件
- 假种子功能需要额外安装GMLIB等LRCA之类前置
- 如无需假种子则可不安装GMLIB
注意事项
插件当前属于测试阶段,请勿应用于正式环境,应用正式环境出现问题请自行承担- 误判处理:如发现误判,请先将该玩家加入白名单,然后调整相关阈值
- 物品修复:插件会自动修复违规物品的NBT,而不是直接删除
- 数据备份:建议定期备份 data 目录下的文件
- 权限管理:确保只有可信任的管理员拥有GAC命令权限
更新日志
v1.0.0 (2025-03-31)
- 初始重构版本发布
- 完整的反作弊检测系统
- 智能的物品NBT修复功能
- 白名单和封禁系统
- 详细的配置选项
支持与反馈
如遇到问题或有功能建议,请通过以下方式联系:- 加入QQ群:582138529