
DiolezHitRegistry
一种消除幽灵命中及修复PvP同步问题的方案。
查看大图🎯 DiolezHitregistry — 幽灵命中消除与 PvP 延迟不同步修复
让每一次挥击都真实命中。不再有幽灵命中。不再有回弹死亡。 适用于 Minecraft 1.21(Fabric)的客户端战斗预测——零服务端依赖。
❓ 这个模组解决了什么问题?
你曾经感受过。你对玩家挥出一击,命中动画播放,粒子飞散——然后什么都没发生。对方的血量没有变化。你没有造成伤害。服务端不认可。
这就是幽灵命中——由客户端所见与服务端所处理之间的差距造成。你的延迟越高,情况就越糟。
DiolezHitregistry 彻底消除了这种感受。
✨ 特性
⚔️ 幽灵命中消除
每次挥击都会立即对目标施加视觉血量减少。如果服务端确认了命中——完美,画面已经正确。如果服务端因延迟或 tick 不同步而拒绝——血条会平滑地淡回真实值。没有突兀的跳变。没有困惑。
🧠 战斗预测与校正
模组在你挥击的瞬间为每次攻击打上时间戳,并根据你当前的延迟追踪实时往返时间(RTT)估算。它用这个来校准一个容忍窗口——给服务端足够的时间在判定为幽灵命中之前做出响应。在 150ms 以上的连接中,该窗口会自动扩大以吸收延迟尖峰。
🔧 实用功能不同步修复
以下所有操作都会被立即预测,并在服务端不认可时优雅回滚:
- 🟣 末影珍珠——投掷时弧线与轨迹立即显示
- 🏹 弓与弩——释放时立即预测弹射物
- 🍗 食物与药水——消耗动画无需等待服务端即播放
- 🧱 方块放置——方块在服务端确认前即出现在世界中
- 🎒 快捷栏切换——槽位切换即时生效,服务端拒绝时回滚
📊 实时 RTT 校准
模组持续测量你的实际延迟,并据此动态调整预测窗口——无需手动配置。在 20ms 下运行良好,在 300ms 以上依然表现出色。
🐛 调试覆盖层(可选)
启用开发者 HUD,实时显示:
- 估算 RTT 与 tick 边界跨越风险
- 当前目标的视觉血量与实际血量
- 预测状态(待定 / 已确认 / 已回滚)
- 实体位置误差(服务端目标与你所见之间的距离)
⚙️ 配置
配置文件自动创建于:.minecraft/config/hitregistry.json
| 选项 | 默认值 | 描述 |
|---|---|---|
enabled |
true |
总开关 |
combatPredictionEnabled |
true |
切换命中预测 |
utilityPredictionEnabled |
true |
切换实用功能不同步修复 |
hitExpiryTicks |
20 |
等待服务端确认多久后视为幽灵命中 |
latencyCompensationTicks |
2 |
为高延迟服务器额外增加的 tick 数 |
predictionStrength |
0.85 |
视觉伤害预测的激进程度(0.0–1.0) |
rollbackLerpSpeed |
0.3 |
回滚时视觉血量回弹的速度 |
pearlPredictionEnabled |
true |
末影珍珠不同步修复 |
projectilePredictionEnabled |
true |
弓/弩不同步修复 |
itemUsePredictionEnabled |
true |
食物/药水不同步修复 |
blockPlacementPredictionEnabled |
true |
方块放置不同步修复 |
utilityRollbackDelayMs |
400 |
未确认的实用操作回滚前等待的毫秒数 |
debugLogging |
false |
详细控制台日志 |
debugOverlay |
false |
启用 HUD 调试面板 |
🔴 高延迟(150ms+)推荐设置
{
"hitExpiryTicks": 30,
"latencyCompensationTicks": 5,
"predictionStrength": 0.90,
"utilityRollbackDelayMs": 600
}
🟢 严格服务器 / 反作弊敏感设置
{
"hitExpiryTicks": 12,
"latencyCompensationTicks": 1,
"predictionStrength": 0.70,
"utilityRollbackDelayMs": 300
}
🛡️ 反作弊兼容性
本模组从底层设计上就是对反作弊系统不可见的。
| 本模组的行为 | 安全? |
|---|---|
| 在服务端确认前施加视觉血量减少 | ✅ 纯视觉效果——绝不触碰实体的真实血量值 |
| 回滚时对视觉血量进行插值 | ✅ 仅客户端渲染 |
| 为待定操作打时间戳并追踪 | ✅ 无网络交互 |
| 注入原版方法 | ✅ 只读、执行后——绝不取消任何操作 |
| 发送额外攻击数据包 | ❌ 从不——会触发攻击频率限制器 |
| 修改发出数据包的时间 | ❌ 从不——服务端操纵 = 封禁 |
| 改变实体位置 | ❌ 从不——位置欺骗 = Grim 立即封禁 |
| 取消收到的服务端数据包 | ❌ 从不——会导致客户端不同步 |
兼容:Grim Anticheat、Vulcan、NoCheatPlus、Matrix 以及所有标准服务器反作弊。 所有预测逻辑均为纯视觉。服务端始终是权威。
❓ 常见问题
问:这在我不是服主的服务器上能用吗? 答:可以。100% 客户端侧。无需服务端模组或插件。
问:这会导致我被封禁吗? 答:不会。模组从不发送额外数据包,从不修改发出的攻击数据包,也从不改变任何权威服务端状态。所有更改都仅在你自己的客户端上以视觉形式呈现。
问:在单人游戏中能用吗? 答:可以,不过在 0ms 本地延迟下幽灵命中不会自然发生——所以你在那里不会看到太大差别。
问:为什么血条有时会在校正前稍微跳变一下?
答:那是回滚插值。当服务端否定预测时,视觉血量会平滑地返回真实值。你可以在配置中调整 rollbackLerpSpeed 来让它更快或更慢。
问:我可以禁用特定功能吗?
答:可以。每个功能在 hitregistry.json 中都有自己的开关。你可以只运行战斗预测、只运行实用预测,或任意组合。
问:这和攻击距离或杀戮光环模组一样吗? 答:绝对不是。本模组不会延长你的攻击距离、自动化攻击或改变碰撞箱。它只改善你自己所执行操作的视觉反馈和不同步恢复。
📦 安装
- 为 Minecraft 1.21 安装 Fabric Loader
- 安装 Fabric API
- 将
DiolezHitregistry-1.0.0.jar放入你的.minecraft/mods/文件夹 - 启动——首次运行时配置会自动创建
⚠️ 已知限制
真正的零延迟 PvP 在网络上物理上不可能。以下是我们模拟的内容以及每项限制存在的原因:
无敌帧(iFrames): 被击中后,实体有服务端侧 10 tick 的无敌窗口。客户端无法得知其他玩家的确切 iFrame 状态,因此该窗口内的一些命中在本地可能显示为幽灵命中,即使它们在服务端是有效的。
弓的拉弓力度: 拉弓状态在服务端追踪。如果弓没有完全拉满,弹射物速度预测可能略有偏差。
护甲与附魔精度: 伤害估算器仅使用可见属性,并施加 10% 的保守削减。实际服务端伤害(考虑护甲韧性、保护附魔后)会略有不同,导致服务端响应时出现小幅视觉校正。
数据包批处理: 某些服务器配置会批量发送血量同步数据包,使回滚触发延迟额外一两个 tick。
🔗 源代码
完整的源代码,包含架构文档和解释每个设计决策的内联注释,都包含在项目中。
构建工具: Fabric API · Fabric Mixins · Java 21 · Minecraft 1.21 Yarn 映射
由 Diolez 制作
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。