TruthfulAC
TruthfulAC 曾是一款付费插件。后来它不再收费了。许可证密钥已消失,混淆代码已移除,完整源代码已公开,因为一个真正好用的免费反作弊对社区的价值,远胜于另一个躲在付费墙后的插件。
使用它。Fork 它。为它做贡献。
⚙️ 安装
- 将 PacketEvents 放入
/plugins/ - 将
TruthfulAC.jar放入/plugins/ - 重启服务器
无需许可证密钥。无需激活。无需账号。就这样。
要求: PacketEvents 2.14.0+ · Java 21+ · Minecraft 1.20.4 至 26.3
?️ 检测项
? 移动
Simulation(模拟) — 插件的核心。一个具有碰撞感知能力的物理引擎,预测玩家每个 tick 应该处于的位置,并将其与实际发送的数据进行对比。通过真实的方块碰撞解析每一个候选结果,在 1.21.2+ 版本中使用客户端的精确输入状态,并且仅从物理不确定性来源应用容差——绝不使用任意填充。
能够检测飞行、疾跑、加速、空走、悬浮、微跳、慢速飞行、鞘翅滥用、液体移动以及各种载具漏洞,几乎涵盖所有移动状态。
| 检测项 | 描述 |
|---|---|
| Simulation | 对整个引擎的统一裁决:经过碰撞解析的候选结果、击退模型、弹跳恢复系数、流体高度、活塞窗口期、柱状跳跃以及持续攀爬模式检测 |
Ground Spoof / NoFall(地面伪装/无摔落伤害) — 六项检测,针对用于抑制摔落伤害的所有已知虚假地面状态数据包变体。
| 检测项 | 描述 |
|---|---|
| GroundSpoof B | 标记那些与任何有效方块表面不对齐的 Y 坐标处的地面声明 |
| GroundSpoof C | 捕获正在主动下落时却声称在地面上的客户端 |
| GroundSpoof D | 阻止在不可能存在的 Y 坐标(包括虚空层)的地面声明 |
| GroundSpoof E | 跟踪服务器端累积的摔落距离,并标记被抑制的摔落伤害 |
| GroundSpoof F | 将客户端的地面声明与实际方块碰撞状态进行交叉引用 |
| GroundSpoof G | 检测无相应移动的地面状态脉冲 |
Velocity(速度) — 通过追踪玩家在通过事务数据包确认速度后是否真正应用了速度,来检测抗击退行为。
| 检测项 | 描述 |
|---|---|
| Velocity A | 标记水平速度非接受情况,同时考虑玩家自身输入对抗击退的影响 |
| Velocity B | 捕获垂直速度抑制,特别是向上的击退 |
| Velocity C | 覆盖延迟抗击退配置的扩展衰减检查 |
| Velocity D | 检测两个轴上几乎为零的速度屈服 |
其他移动检测
| 检测项 | 描述 |
|---|---|
| Timer A | 基于事务的 tick 计时,通过测量客户端自身的确认时钟来检测定时器外挂,不受 TPS 波动影响 |
| Baritone A | 检测由 Baritone 寻路器产生的旋转快照密度模式 |
| Baritone B | 识别锁定相机方块目标的机械化挖掘模式 |
| Baritone C | 标记异常一致的方块破坏间隔 |
| Inventory A | 检测在同时发送移动更新时的背包点击行为 |
⚔️ 战斗
Aim(瞄准) — 三项基于 GCD 灵敏度分析构建的检测。故意保持极简:这是一个免费反作弊,我们不会给作弊开发者提供一份用于调优的规格说明书。
| 检测项 | 描述 |
|---|---|
| Aim A | GCD 分析,验证旋转步骤映射到真实的原版灵敏度 |
| Aim B | 检测有效步骤但偏离网格的旋转(假装灵敏度的辅助瞄准) |
| Aim C | 标记恒定旋转连击——人类无法实现的持续相同增量 |
KillAura(杀戮光环) — 七项检测,针对来自移动、旋转、攻击行为和瞄准模式的杀戮光环。
| 检测项 | 描述 |
|---|---|
| KillAura B | 检测攻击期间与视角向量不一致的奔跑行为(KeepSprint) |
| KillAura C | 快照停止检测:视角迅速锁定目标后立即停止移动 |
| KillAura D | 无声瞄准和俯仰角锁定 |
| KillAura E | 使用补偿世界缓存检测穿墙命中 |
| KillAura F | 包级暴击检测,识别微型跳跃模式 |
| KillAura G | 在极短窗口期内切换多个目标 |
| KillAura H | 攻击间隔方差过于一致,不可能是人类所为 |
AutoClicker(自动点击器) — 五项检测,从独立的统计角度接近点击检测。
| 检测项 | 描述 |
|---|---|
| AutoClicker A | 变异系数分析,标记低方差的点击时间 |
| AutoClicker B | 相同延迟连击,检测连续点击且时间几乎相同的情况 |
| AutoClicker C | 硬性 CPS 上限 |
| AutoClicker D | 小于 8ms 的双击检测 |
| AutoClicker E | GCD 网格锁定的点击延迟 |
Reach & Hitbox(距离与碰撞箱) — 两阶段,对延迟公平。攻击数据包并不携带客户端挥动时的旋转角度——那会在一个数据包之后到达。阶段 A 存储攻击者的位置;阶段 B 使用实际旋转对补偿后的碰撞箱历史进行射线投射,跨越整个往返窗口,尝试所有视角变体和眼睛高度。
| 检测项 | 描述 |
|---|---|
| Reach A | 两阶段补偿距离检测,具有属性感知的范围,无任何任意容差填充 |
| Hitbox A | “甚至没碰到”的裁决——当射线在所有合法视角下都未击中目标时,路由自同一个单次射线投射 |
其他战斗检测
| 检测项 | 描述 |
|---|---|
| Raycast A | 攻击和交互方向与服务器视角向量的对比 |
| Lag A | 回溯模式检测:当前帧超出范围结合历史帧在范围内(延迟数据包滥用) |
| Lag B | 实体不同步插值命中模式 |
| Lag C | 跨 ping 分箱的 ping/违规相关性 |
| CrystalAura A | 末影水晶快速放置-破坏序列 |
| AnchorAura A | 重生锚充能至爆炸的时间间隔 |
? 世界与方块
四种基于物理固定的脚手架检测——每种都受几何限制,而非统计猜测。
| 检测项 | 描述 |
|---|---|
| Scaffold Rotation | 放置视线:视角射线必须实际与放置的方块相交 |
| Scaffold Reach | 放置距离 vs 属性感知的方块交互范围 |
| Scaffold Motion | 塔式节拍器物理机制——跳跃力量缩放阈值,确保 Jump Boost 用户不会误报 |
| Scaffold Face | 幽灵/不同步放置到已占用的实心单元格中 |
| 检测项 | 描述 |
|---|---|
| FastBreak A | 方块破坏时间 vs 服务器计算所需时间 |
| Phase A | 玩家位于实心方块内部 |
? 数据包
BadPacket —— 捕获畸形、不可能或触发漏洞的数据包。涵盖 25 项检测,包括无权限飞行、NaN 坐标、传送洪水、实体动作垃圾信息、无效槽位、自我交互等。
Packet Order —— 验证原版客户端会发送的数据包序列:未挥动时的方块放置、使用物品时攻击、水晶自动化、NoSwing 以及库存光环。
Sprint
| 检测项 | 描述 |
|---|---|
| Sprint A | 失明或饥饿状态下的 OmniSprint |
| Sprint B | OmniSprint 方向标记为从视角向量向后冲刺 |
其他数据包
| 检测项 | 描述 |
|---|---|
| Invalid A | 俯仰角超出 ±90° |
| Crasher A | 插件频道负载溢出 |
? 基岩版
专为 Geyser 翻译的基岩版玩家设计的检测。所有阈值均针对 Geyser 的数据包批处理和翻译开销进行了调整。基岩版玩家不运行 Java 物理检测。检测涵盖用户名前缀、Floodgate UUID 和 Geyser 客户端品牌。
| 检测项 | 描述 |
|---|---|
| BFly (A) | 持续悬停或向上移动超出任何有效的基岩版机制 |
| BSpeed (A) | 通过 Geyser 的基岩版硬速度上限 |
| BReach (A) | 具有宽松阈值的基岩版延迟到达距离 |
? 世界与 26.x 支持
- 26.3 —— 架子蘑菇、稻草床、白杨木套装、羊毛/混凝土楼梯和台阶、硫磺间歇泉
- 26.2 —— 三个新的移动属性(
air_drag_modifier、bounciness、friction_modifier)、高摩擦方块的修订地面加速公式、75% 的床反弹 - 事务括号内的方块更新 —— 只有当客户端确认处理时,方块更改才会应用于每个玩家的视图世界。引擎始终模拟玩家实际看到的世界。
- 动态栅栏和墙壁形状 —— 连接臂由方块状态属性生成,而非静态柱子
- 流体高度模型 ——
(8−level)/9,并正确筛选游泳-跳跃和跳出候选者
? 配置
两个文件,按关注点分离:
- config.yml —— 插件设置:警报、消息、惩罚、滞后回溯配置文件、延迟踢出、客户端阻止、Discord Webhook、封禁波计划
- checks.yml —— 每项检测:单检测开关、滞后回溯继承(
inherit/true/false)、惩罚阈值和命令、按类型调优键
默认情况下,单检测滞后回溯继承全局配置文件,或通过其自身的 VL 强制开启/关闭。游戏内 GUI 循环遍历 Inherit → On → Off 每检查一次。运动热路径上零 YAML 读取。
?️ 调试输出
每个标志都携带完整的诊断状态:输入布尔值、地面状态、活动机制、击退向量、引擎预测的运动向量、方块列以及支撑探针结果。单个标志行准确告诉你引擎触发时的思考过程——无需猜测,无需盲目调试。
? 贡献
移动检测改进是优先事项。每个 PR 都需要清楚解释它检测什么、从什么角度切入,以及为什么现有的检测尚未覆盖它。
不欢迎那些误报多于捕获的检测。
达到 30 次有意义的贡献 后,你将在插件的游戏内 GUI 中获得署名。
❓ 为什么开源?
透明胜于封闭。永远如此。
? 许可证
Truthful & Faithful License v1.1 —— 可免费使用、研究、修改和贡献。不得以不同许可证出售或重新分发。
⚠️ 这是一个测试版发布。 预期会出现奇怪的情况。发现了?请在 GitHub 上使用完整的标志调试行报告。
TruthfulAC
TruthfulAC was a paid plugin. Then it wasn't. The license key is gone, the obfuscation is gone, and the full source is public because a free anti-cheat that's actually good does more for the community than another plugin sitting behind a paywall.
Use it. Fork it. Contribute to it.
⚙️ Installation
- Drop PacketEvents into
/plugins/ - Drop
TruthfulAC.jarinto/plugins/ - Restart
No license key. No activation. No account. That's it.
Requires: PacketEvents 2.14.0+ · Java 21+ · Minecraft 1.20.4 through 26.3
?️ Checks
? Movement
Simulation — The core of the plugin. A collision-aware physics engine that predicts where a player should be every tick and compares it against what was actually sent. Resolves every candidate through real block collision, uses the client's exact input state on 1.21.2+, and applies tolerance only from physical uncertainty sources — never arbitrary padding.
Catches fly, bhop, speed, airwalk, hover, micro-jumps, slow-fly, elytra abuse, liquid movement, and vehicle exploits across virtually every movement state.
| Check | Description |
|---|---|
| Simulation | One unified verdict over the entire engine: collision-resolved candidates, knockback models, bounce restitution, fluid heights, piston windows, geyser columns, and sustained-climb pattern detection |
Ground Spoof / NoFall — Six checks targeting every known variant of fake ground state packets used to suppress fall damage.
| Check | Description |
|---|---|
| GroundSpoof B | Flags ground claims at Y positions that don't align to any valid block surface |
| GroundSpoof C | Catches clients claiming ground while actively falling |
| GroundSpoof D | Blocks ground claims at impossible Y positions including void level |
| GroundSpoof E | Tracks accumulated server-side fall distance and flags suppressed fall damage |
| GroundSpoof F | Cross-references the client's ground claim against actual block collision state |
| GroundSpoof G | Detects ground state pulsing with no corresponding movement |
Velocity — Detects anti-knockback by tracking whether players actually apply velocity after acknowledging it via transaction packets.
| Check | Description |
|---|---|
| Velocity A | Flags horizontal velocity non-acceptance, accounting for the player's own input fighting the knockback |
| Velocity B | Catches vertical velocity suppression, specifically upward knockback |
| Velocity C | Extended decay check covering delayed anti-KB configurations |
| Velocity D | Detects near-zero velocity yield on both axes simultaneously |
Other Movement
| Check | Description |
|---|---|
| Timer A | Transaction-anchored tick timing that detects timer hacks by measuring against the client's own acknowledgement clock, immune to TPS fluctuation |
| Baritone A | Detects the rotation snap density pattern produced by Baritone's pathfinder |
| Baritone B | Identifies robotic mining patterns with locked-camera block targeting |
| Baritone C | Flags suspiciously consistent block break intervals |
| Inventory A | Detects inventory clicks while simultaneously sending movement updates |
⚔️ Combat
Aim — Three checks built on GCD sensitivity analysis. Deliberately minimal: this is a free anti-cheat, and we're not handing cheat developers a spec to tune against.
| Check | Description |
|---|---|
| Aim A | GCD analysis validating rotation steps map to a real vanilla sensitivity |
| Aim B | Detects valid-step but off-grid rotations (aim assist faking sensitivity) |
| Aim C | Flags constant-rotation streaks — humanly impossible sustained identical deltas |
KillAura — Seven checks targeting KillAura from movement, rotation, attack behavior, and targeting patterns.
| Check | Description |
|---|---|
| KillAura B | Detects sprinting inconsistent with the look vector during attacks (KeepSprint) |
| KillAura C | Snap-and-stop detection: aim snaps to target and immediately stops moving |
| KillAura D | Silent aim and pitch lock |
| KillAura E | Wall hit detection using the compensated world cache |
| KillAura F | Packet crit detection identifying the mini-jump pattern |
| KillAura G | Multi-target switching within impossibly short windows |
| KillAura H | Attack interval variance too consistent to be human |
AutoClicker — Five checks approaching click detection from independent statistical angles.
| Check | Description |
|---|---|
| AutoClicker A | Coefficient of variation analysis flagging low-variance click timing |
| AutoClicker B | Identical delay streaks detecting consecutive clicks with near-identical timing |
| AutoClicker C | Hard CPS cap |
| AutoClicker D | Sub-8ms double-click detection |
| AutoClicker E | GCD grid-locked click delays |
Reach & Hitbox — Two-stage, latency-fair. The attack packet doesn't carry the rotation the client swung with — that arrives one packet later. Stage A stores the attacker's position; Stage B ray-casts with the real rotation against the compensated hitbox history across the full round-trip window, trying all look variants and eye heights.
| Check | Description |
|---|---|
| Reach A | Two-stage compensated reach with attribute-aware ranges and no arbitrary tolerance padding |
| Hitbox A | The "didn't even touch it" verdict — routed from the same single raycast when the ray misses every legal view of the target |
Other Combat
| Check | Description |
|---|---|
| Raycast A | Attack and interaction direction against the server's view vector |
| Lag A | Backtrack pattern detection: current-frame out-of-reach combined with historical-frame in-reach (delayed packet abuse) |
| Lag B | Entity desync interpolation hit patterns |
| Lag C | Ping/violation correlation across ping bins |
| CrystalAura A | Rapid end crystal place-to-break sequences |
| AnchorAura A | Respawn anchor charge-to-explode timing |
? World & Blocks
Four physics-anchored scaffold checks — each one geometry-gated, not statistical guessing.
| Check | Description |
|---|---|
| Scaffold Rotation | Placement line-of-sight: the view ray must actually intersect the placed block |
| Scaffold Reach | Placement distance vs the attribute-aware block interaction range |
| Scaffold Motion | Tower metronome physics — jump-strength-scaled threshold so Jump Boost users never false |
| Scaffold Face | Ghost/desync placement into occupied solid cells |
| Check | Description |
|---|---|
| FastBreak A | Block break time vs the server's calculated required time |
| Phase A | Players positioned inside solid blocks |
? Packets
BadPacket — Catches malformed, impossible, or exploit-triggering packets. 25 checks covering flying without permission, NaN positions, teleport floods, entity action spam, invalid slots, self-interaction, and more.
Packet Order — Validates packet sequences a vanilla client would send: block placement without swing, attacking while using items, crystal automation, NoSwing, and inventory aura.
Sprint
| Check | Description |
|---|---|
| Sprint A | OmniSprint under blindness or hunger |
| Sprint B | OmniSprint direction flagging sprinting backwards from the look vector |
Other Packets
| Check | Description |
|---|---|
| Invalid A | Pitch outside ±90° |
| Crasher A | Plugin channel payload overflow |
? Bedrock
Dedicated checks for Geyser-translated Bedrock players. All thresholds tuned for Geyser's packet batching and translation overhead. Bedrock players never run Java physics checks. Detection covers username prefix, Floodgate UUIDs, and Geyser client brands.
| Check | Description |
|---|---|
| BFly (A) | Sustained hover or upward movement beyond any valid Bedrock mechanic |
| BSpeed (A) | Hard speed cap appropriate for Bedrock through Geyser |
| BReach (A) | Reach distance with a lenient threshold for Bedrock latency |
? World & 26.x Support
- 26.3 — shelf mushrooms, straw beds, poplar wood set, wool/concrete stairs and slabs, sulfur geysers
- 26.2 — the three new movement attributes (
air_drag_modifier,bounciness,friction_modifier), the revised ground accel formula for high-friction blocks, bed bounce at 75% - Transaction-bracketed block updates — block changes apply to each player's world view only when their client confirms processing them. The engine always simulates the world the player actually sees.
- Dynamic fence and wall shapes — connection arms generated from block state properties, not a static post
- Fluid height model —
(8−level)/9with proper gating for swim-hop and jump-out candidates
? Configuration
Two files, split by concern:
- config.yml — plugin settings: alerts, messages, punishments, lagback profile, latency kicker, client blocker, Discord webhooks, banwave schedule
- checks.yml — every detection: per-check toggles, lagback inheritance (
inherit/true/false), punishment thresholds and commands, per-type tuning keys
Per-check lagback inherits the global profile by default, or forces on/off with its own VL. The in-game GUI cycles through Inherit → On → Off per check. Zero YAML reads on the movement hot path.
?️ Debug Output
Every flag carries full diagnostic state: input booleans, ground states, active regimes, knockback vector, the engine's predicted motion vector, block column, and the support probe result. A single flag line tells you exactly what the engine was thinking when it fired — no guessing, no blind debugging.
? Contributing
Movement check improvements are the priority. Every PR needs a clear explanation of what it detects, what angle it approaches from, and why existing checks don't already cover it.
Not interested in checks that false flag more than they catch.
Hit 30 meaningful contributions and you get a named credit in the plugin's in-game GUI.
❓ Why open source?
Transparent beats closed. Always.
? License
Truthful & Faithful License v1.1 — free to use, study, modify, and contribute. Cannot be sold or redistributed under a different license.
⚠️ This is a beta release. Expect weird edge cases. Found one? Report it on GitHub with the full flag debug line.
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TruthfulAC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
已修复
- 修复了远距离位置数据包禁用器——过去,一个距离足够远以强制服务器校正的位置数据包会翻转那个使所有检测失效的区块加载门,而每次强制校正都会带来 2 次免费豁免刻、完整移动状态重置以及计时器重新校准。综合起来,这足以几乎完全禁用反作弊。现在,不可能的位声称(非有限值、越界或无法由任何待处理传送解释的传送距离跳跃)将在入口处被丢弃并标记——服务器永远看不到它们,因此永远不会围绕它们构建校正循环。
- 修复了传送确认洗钱问题——确认传送会使下一个位置声称被视为无需位置验证的传送,因此扣留确认相当于免费通行证,可将任何位置称为传送。现在,声称必须落在已确认传送目标 2 个方块内(原版客户端精确落在目标上)。
- 修复了基于声称位置的区块门键控问题——“未加载区块 = 永不评判”规则现在仅适用于从上一个接受位置可达的位置(每个数据包 32 个方块,是原版服务器自身校正阈值的 3 倍)。模拟器的内部区块门也接受了相同处理——它是禁用器链中的最后一个跳过项。
- 修复了实时区块构建从 Netty 线程读取 Bukkit 世界状态(违反 Folia 规范)且无限制地每数据包触发一次的问题。现在请求速率限制为每玩家每 2 秒 4 次;合法遗漏仍会重试。
- 修复了楼梯完全没有碰撞的问题——“STAIRS”包含“AIR”,因此游戏中的每个楼梯方块在形状切换运行之前都进入了非固体列表。楼梯碰撞、踏步和支撑现在按模型正常工作。
- 修复了雪块被建模为 1/8 高的台阶(站在上面读作约 0.87 块的垂直偏移——即时硬标记)以及细雪生长出一个幻影 1/8 碰撞地板并与下沉上下文冲突的问题。
- 修复了幻影全方块问题——作物、矮草(1.20.3+ 的重命名匹配不到任何东西,导致草原变得不可见)、灌木、下界传送门平面、移动活塞和光块都像实心方块一样发生碰撞。穿过麦田会被标记。
- 修复了幻影空气问题——下界疣块、红树林和泥泞红树林根、营火和灵魂营火、桶、泥和泥砖、紫水晶块、链式命令方块和避雷针没有碰撞或形状错误。
- 修复了玻璃板和铁栏杆没有面碰撞的问题——中心只有 2/16 的杆而非细长的全长条。引擎中玻璃板墙是可穿过的,因此接触它们会被标记为穿墙。
- 修复了门被建模为中心平板而不是在与朝向相反的边缘处齐平的 3/16 面板,并且开门时的铰链侧被交换——每次撞门误差高达约 0.44 个方块,偏离了客户端实际停止的位置。
- 修复了墙柱和手臂的问题——无顶柱被建模为 1.5 高(原版为 1.3125),低侧手臂为 1.5 高(原版为 0.9375,正常跳跃可清除)。两个方向均被标记。
- 修复了熔炉被建模为实心全方块而不是空心——跳入其中在读作在每个候选者中下落,而客户端停留在 5/16 的内部地板上。
- 修复了延伸活塞头没有站立表面(它们被路由到头颅形状)。站在活塞门和电梯上会被标记。
- 修复了蕨类植物跑酷问题——大型蕨类植物头部在短暂站立后会倾斜并将玩家滑开。现在有界的倾斜容差现在覆盖了滑动和掉落。
- 修复了地面摩擦采样网格问题——内层循环将 Z 与 X 进行比较,并在玩家的 X/Z 方块偏移不同时采样错误的列。
- 修复了长矛冲刺误报问题——引擎判断冲刺窗口:SPEAR_LUNGE 豁免在模拟器的跳过列表中缺失,而速度检查却尊重它。检测也是基于显示名称的,因此将任何物品重命名为包含“spear”/“lunge”可通过每次右键点击获得 20 刻的速度免疫。现在检测基于材质,并覆盖充能释放冲刺(RELEASE_USE_ITEM)和击中触发的冲刺。
- 修复了液体游泳弹跳候选项在任何深度都允许持续 0.3 上升的问题——现在需要水平运动和表面接近,以匹配原版条件(游泳出时发生水平碰撞)。
- 修复了当没有新鲜击退时 DebugContext 崩溃的问题。
- 修复了来自敌对区块的超出范围的全局 ID 导致方块属性查找崩溃的问题(一种数据包线程 NPE 向量)。
- 修复了惩罚分支在分派任何命令之前强制延迟回溯的问题 (#29)——仅消息惩罚(tell/warn)会在禁用所有延迟回溯的情况下将玩家向后传送。现在,禁止状态仅保留用于实际移除(banwave 队列、ban/kick 家族命令);消息惩罚改为每玩家 10 秒冷却时间,而不是让整个检测管道静音 10 秒。
- 修复了插件消息通道名称因硬编码长度截止而被拒绝的问题 (#30)——即使现代语法有效的命名空间通道超过截止长度也被拒绝,尽管它本身没有问题。现在通道按客户端协议版本进行验证:现代客户端使用带有 64 字符平台限制的命名标识符验证,旧版客户端保持 20 字符限制。有效载荷边界不变。
- 修复了惩罚和延迟回溯开关从未覆盖直接数据包拒绝的问题 (#31)——禁用惩罚和延迟回溯并不会使拒绝检查变为观察性。现在,拒绝检查尊重显式的逐检查取消开关(参见 ADDED)。
- 修复了世界模型和实体跟踪器无论启用哪些检查都以全成本运行的问题 (#32)——这两个流水线现在衍生自启用的检查集,因此仅点击配置文件无需支付区块解码、地面探测、环境扫描或实体跟踪的成本。点击时间戳、事务、传送记账和挖掘状态始终运行。
新增
- 新增 BadPacketI:不可能的位置声明 —— 每次禁用尝试都会以明显严重性进行标记,并在调试行中包含跳跃距离。像其他所有拒绝检查一样,尊重每个检查的取消开关
- 新增位置合理性门控:非有限值和越界拒绝、每数据包 32 个方块的无解释跳跃阈值,以及待处理传送的可解释性(纯逻辑,经过单元测试)
- 在 checks.yml 中为直接拒绝数据包的检查添加了每检查“取消: true/false”选项(Crasher、BadPacket 槽位/旁观模式/不可能移动、BedrockReach)。默认为 true —— 拒绝仍是安全默认值。设置为 false 将使检查仅处于观察模式:仍会触发标记和警报,但数据包会通过。在检查详情菜单中包含 GUI 切换按钮
- 新增检查级别的处理器需求(requiresWorld / requiresEntityTracking)—— 注册表会在启用的检查之间聚合这些需求,并在每次 GUI 切换和重新加载时重新计算
- 新增真实形状以修复近似算法隐藏的漏洞:活塞头按朝向区分(全高平板 + 杆)、动态窗格和铁栏杆连接条、空心熔炉(四个 1/16 墙壁 + 5/16 地板)
- 新增每刻地面摩擦缓存,供所有消费者共享(之前每数据包最多重新采样五次,涉及九个方块)
- 新增 Simulation 候选搜索的快速退出机制 —— 第一个精确匹配立即停止整个输入×候选暴力搜索;常见的合法刻数从数百次碰撞解析减少到首次命中
- 新增碰撞器的每线程暂存缓冲区 —— 地面探测和模拟过程中零每数据包数组分配
- 新增每玩家 16 区块缓存,使跨区块读取不再触及同步的全局 LRU 映射
- 新增基于 NMS 快照的实时区块构建,并跳过空分区(之前每个区块约需调用 ~98,000 次 getBlock())
- 新增有界的滴水叶倾斜允许范围,标注方式与气泡柱相同
- 新增 26 个单元测试:通道验证、碰撞形状表、位置合理性、传送队列行为。形状路由和几何现在均为纯函数,无需运行服务器即可测试
移除
- 移除了死掉的 MovementProcessor 预测阶段 —— 其单路径和多输入暴力搜索自 Simulation 引擎接管后已无任何消费者(这是性能分析报告中指出的“PlayerData 中的预测”部分)
- 移除了 VelocityQueue 遗留 API(getActiveVelocity / applyFriction)
- 移除了 WorldUtils 中未使用的 COMPLEX_BLOCKS 分类集
⚠️ Beta 通知
这是一个 Beta 版本。 可能会出现我们尚未见过的奇怪边缘情况。某些方块、表面或移动模式可能仍以我们未在测试中发现的方式误报。
发现问题? 请在 GitHub 上报告:
请包含标记消息(完整的调试行,包含 pred=、in=、g=、rg=、kb=)、你当时正在执行的操作、你运行的 Minecraft 和 PacketEvents 版本。一条标记行能让我们准确了解引擎的思考过程 —— 这是最快解决问题的方式。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧