GwAntiCheat - BDS基岩版反作弊插件
简介
GwAntiCheat (GAC) 是一款多功能的Minecraft基岩版BDS服务端反作弊插件,基于LeviLamina Script Engine (LSE) 开发。插件提供了全方位的反作弊保护,有效维护服务器的公平游戏环境。
功能特性
核心反作弊模块
移动检测
- 移动速度检测:监控玩家移动速度,防止加速作弊
- 飞行检测:检测非法飞行行为和悬空时间
- NoFall检测:检测摔落伤害异常,防止无摔伤作弊
- 智能豁免:传送、死亡、维度切换后自动豁免检测
战斗检测
- 攻击频率限制:防止连点器和杀戮光环
- 长臂猿检测:检测超出正常范围的攻击/交互距离
- NoFall检测:检测无摔落伤害作弊
物品检测
- 堆叠数量检测:防止异常物品堆叠
- 32k武器检测:检测并移除超高攻击力武器
- 禁用物品检测:自动移除被禁止的物品
- NBT异常检测:检测非法NBT标签和属性
- 潜影盒内容检测:深度扫描潜影盒内物品
- 附魔等级检测:限制过高等级附魔
防卡物品系统(新增)
- 防卡背包:自动刷新物品栏防止卡顿
- 移动限制:禁止移动时打开容器
- 状态检测:防止特殊状态下的物品操作
- 加载中拾取物品
- 传送门内拾取物品
- 交易时拾取物品
聊天保护
- 反刷屏检测:防止消息轰炸
- 消息长度限制:防止超长消息
- 自动禁言:违规自动临时禁言
- 智能频率控制:基于时间窗口的消息频率检测
系统保护
- 反假OP:检测并移除非法OP权限
- 经验异常检测:防止经验刷取
- 命令选择器过滤:限制危险命令使用
客户端检测
- 设备信息验证:检测客户端类型
- 丢包率监控:异常网络行为检测
- 玩家身份认证:防止身份伪造
管理功能
白名单系统
- 添加/移除白名单玩家
- 白名单玩家豁免所有检测
封禁系统
- 自动封禁违规次数过多的玩家
- 手动解封功能
- 封禁记录持久化存储
违规反馈
- 控制台日志输出
- 游戏内广播(可选)
- 模式表单警告(可选)
- 违规容忍度系统
安装方法
- 确保服务器已安装 LeviLamina
- 下载 GwAntiCheat.js 文件
- 将文件放置到 plugins/GwAntiCheat/ 目录
- 重启服务器或使用命令重载插件
配置说明
配置文件位于 plugins/GwAntiCheat/config/config.json
JSON:
{
// 移动速度检测
movement: {
enabled: true,
maxBlocksPerSecond: 15, // 正常移动速度
maxBlocksPerSecondFlying: 30, // 飞行时的移动速度
checkFlyingSpeed: false, // 是否检测飞行速度(false时飞行不检测)
checkInterval: 1000,
exemptAfterTeleport: 5000, // 增加到5秒
exemptAfterDeath: 10000 // 增加到10秒
},
// 附魔检测
enchantment: {
enabled: true,
maxLevel: 32, // 提高到32级
checkInterval: 1000
},
// 反假OP
antiOp: {
enabled: true,
checkInterval: 2000
},
// 攻击频率检测
combat: {
enabled: true,
maxAttacksPerSecond: 30, // 提高到30
checkWindow: 1000
},
// 经验检测
experience: {
enabled: true,
maxExperiencePerGain: 5000 // 提高到5000
},
// 反非法客户端
antiIllegalClient: {
enabled: false, // 默认关闭,可能误判
kickUnknownOS: false
},
// 防长臂猿
reach: {
enabled: true,
maxReachDistance: 8, // 提高到8格
maxPlaceDistance: 10 // 提高到10格
},
// 反刷屏
antiSpam: {
enabled: true,
maxMessagesPerSecond: 5, // 提高到5条
checkWindow: 5000,
muteTime: 3000
},
// 消息长度限制
messageLength: {
enabled: true,
maxLength: 500 // 提高到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
},
// 物品名称检测
itemName: {
enabled: true,
maxLength: 50 // 物品名称最大长度
},
// 命令选择器过滤
commandFilter: {
enabled: true,
blockedSelectors: ["@e"] // 只禁用@e
},
// 玩家认证
authentication: {
enabled: false, // 默认关闭
checkName: true,
checkXuid: true,
checkUuid: true
},
// 丢包检测
packetLoss: {
enabled: false, // 默认关闭
maxPacketLoss: 50,
checkInterval: 1000
},
// 防拾取刷物品配置
antiItemSpam: {
enabled: true,
checkWindow: 1000, // 检测时间内(毫秒)
maxItemsPerWindow: 300, // 检测时间内最大拾取物品数量
maxUniqueItemsPerWindow: 30, // 检测时间最大不同物品种类数量
alertThreshold: 500 // 警告阈值
},
// 防卡物品配置
antiItemGlitch: {
enabled: true,
preventMovingOpenContainer: true, // 防止移动时打开容器
preventLoadingPickup: true, // 防止加载时拾取物品
preventPortalPickup: true, // 防止在传送门中拾取物品
preventTradingPickup: true, // 防止交易时拾取物品
autoRefreshItems: true // 自动刷新物品栏
},
// 反作弊反馈
feedback: {
logToConsole: true,
broadcastInGame: false, // 默认不广播
maxViolations: 20, // 触发惩罚措施阀值
useBan: false, // 默认不封禁(不建议开启,封禁后如果解封需要手动删除data配置文件数据)
showModalWarning: true
}
}
数据存储
插件数据存储在 plugins/GwAntiCheat/data/ 目录:日志文件存储在 logs/GwAntiCheat.log
使用建议
首次使用
- 观察模式:建议先将 feedback.broadcastInGame 和 feedback.useBan 设为 false
- 调整阈值:根据服务器情况调整各项检测阈值
- 查看日志:通过日志文件了解检测情况
- 逐步启用:确认无误判后再启用更严格的措施
性能优化
- 可以禁用不需要的检测模块以提高性能
- 调整检测间隔(checkInterval)以平衡性能和安全性
- 大型服务器建议适当提高各项阈值
兼容性说明
- 支持所有标准的Minecraft基岩版
- 兼容大部分其他LSE插件
- 假种子功能需要额外安装GMLIB等LRCA之类前置
- 如无需假种子则可不安装GMLIB
注意事项
插件当前属于测试阶段,请勿应用于正式环境,应用正式环境出现问题请自行承担- 误判处理:如发现误判,请先将该玩家加入白名单,然后调整相关阈值
- 物品修复:插件会自动修复违规物品的NBT,而不是直接删除
- 数据备份:建议定期备份 data 目录下的文件
更新历史
v1.1.0 (2025年6月7日)
新增防刷物品系统
新增防卡物品功能
移除假种子功能
删除命令系统(暂时移除)
配置自动补全
优化检测逻辑
v1.0.0 (2025-03-31)
- 初始重构版本发布
- 完整的反作弊检测系统
- 智能的物品NBT修复功能
- 白名单和封禁系统
- 详细的配置选项
支持与反馈
如遇到问题或有功能建议,请通过以下方式联系:- 加入QQ群:582138529