DiolezHitRegistry

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 中都有自己的开关。你可以只运行战斗预测、只运行实用预测,或任意组合。

问:这和攻击距离或杀戮光环模组一样吗? 答:绝对不是。本模组不会延长你的攻击距离、自动化攻击或改变碰撞箱。它只改善你自己所执行操作的视觉反馈和不同步恢复。


📦 安装

  1. 为 Minecraft 1.21 安装 Fabric Loader
  2. 安装 Fabric API
  3. 将 DiolezHitregistry-1.0.0.jar 放入你的 .minecraft/mods/ 文件夹
  4. 启动——首次运行时配置会自动创建

⚠️ 已知限制

真正的零延迟 PvP 在网络上物理上不可能。以下是我们模拟的内容以及每项限制存在的原因:

  • 无敌帧(iFrames): 被击中后,实体有服务端侧 10 tick 的无敌窗口。客户端无法得知其他玩家的确切 iFrame 状态,因此该窗口内的一些命中在本地可能显示为幽灵命中,即使它们在服务端是有效的。

  • 弓的拉弓力度: 拉弓状态在服务端追踪。如果弓没有完全拉满,弹射物速度预测可能略有偏差。

  • 护甲与附魔精度: 伤害估算器仅使用可见属性,并施加 10% 的保守削减。实际服务端伤害(考虑护甲韧性、保护附魔后)会略有不同,导致服务端响应时出现小幅视觉校正。

  • 数据包批处理: 某些服务器配置会批量发送血量同步数据包,使回滚触发延迟额外一两个 tick。


🔗 源代码

完整的源代码,包含架构文档和解释每个设计决策的内联注释,都包含在项目中。

构建工具: Fabric API · Fabric Mixins · Java 21 · Minecraft 1.21 Yarn 映射


由 Diolez 制作