跳到正文

伤害探针 / Damage Probe

仅用于测试的工具:将一次伤害拆分为“意图伤害”和“实际损失的生命值”,并显示是哪个模组、在哪个环节修改或吞掉了伤害。**请勿用于正常游戏。**

收藏

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

伤害探针 / Damage Probe

## 英文简介

> ⚠️ 仅供测试的工具:拆解单次伤害从“预期伤害”到“实际损失生命值”的全过程,并显示是哪个模组修改了伤害,以及伤害在哪个环节被吞掉。**不要在正常游戏中安装。**

—

## ⚠️ 请先阅读

**这是诊断工具,不是游戏玩法模组。**

它会在服务器上安装大量事件钩子和 Mixin,并持续记录每次伤害、实体效果和属性修饰符。

**实测开销**(`spark`,473 秒采样):

“`
AttributeOwnerRegistry  1620 ms
ModifierProbe           1504 ms
ProbeText               1104 ms
AmountCapture            992 ms
EffectProbe              576 ms
──────────────────────────────
≈1.2% of server CPU, plus continuous log output
“`

| 情况 | 是否建议安装? |
|—|—|
| 排查“伤害数值不对” | ✅ 建议,临时安装 |
| 排查“增益没有生效” | ✅ 建议,临时安装 |
| 排查“某个模组吞掉了伤害” | ✅ 建议,临时安装 |
| **正常游戏 / 长期开服** | ❌ **不建议** |
| **发布整合包** | ❌ **不要打包进去** |

**默认禁用**(`enabled = false`)。使用 `/damageprobe on` 启用。

—

## 它解决的问题

玩家经常会说:“这一下本该打出 5000 点伤害,结果只掉了 12 点生命值。”

普通日志无法解释原因,因为 Forge 的伤害会经过**四个阶段**,每个阶段都可能被不同模组改写:

“`
LivingAttackEvent    →  预期伤害
LivingHurtEvent      →  护甲 / 抗性 / 附魔
LivingDamageEvent    →  伤害吸收(金色心形)
actuallyHurt         →  实际损失的生命值
“`

**这个模组会记录每个阶段,并告诉你是谁改动了伤害。**

—

## 伤害探针

“`
[伤害探针] Player→Dummy | 理论 457.9 | hurt出 2940.0 | damage 2928.0 | 实扣 2928.0
          | 掉血 2928.0 | 血 5000.0→2072.0/5000.0
          | 归属: 事件×6.42(+2482.1) 护甲段×0.996(-12.0) 实扣0.0 结算0.0
          | 线程=Server thread
“`

### 归因

| 区段 | 含义 |
|—|—|
| `事件×` | 预期数值到 `LivingHurtEvent` 结束时数值的倍率 |
| `护甲段×` | `LivingHurtEvent` 结束值到伤害入口值的倍率(**可能大于 1**) |
| `实扣` | 伤害入口值与实际损失生命值之差(负值表示被限制) |
| `结算` | 扣血后写回的数值 |

### 明确处理的三个易错点

1. **伤害溢出**——显示为 `实扣 9863.4(过量击杀,…)`,不会误报成负数的“伤害被吞”。
2. **无效写入**——只记录真正改变数值的 `setAmount` 调用,因此归因会指向真正的问题来源。
3. **错误的异步事件**——跳过客户端事件,避免单人游戏中出现虚假的“Render thread”报告。

### 上下文快照

检测目标类是否重写了 `setHealth`(`血量托管=是(…)`)——这是排查“伤害被吞了”的关键线索。

—

## 效果探针

区分**已应用**和**被拒绝**:

“`
[效果探针] target=Zombie#21 gained minecraft:regeneration 1 200t
           source=Player#20 result=被拒绝 call=xxx.Mod.apply:236
“`

**`result=被拒绝` 是排查“为什么我的增益没生效”的关键信号。**

20 tick 内重复出现的事件会合并显示为 `(×N)`,避免高频模组刷屏。

—

## 修饰符探针

“`
[修饰符探针] target=Player#23 attribute=minecraft:generic.max_health
             modifier=tetra.stats.additioncharm2 amount=2.9 operation=ADDITION
             result=已添加 value=20.0→22.9 call=…
“`

**`value=20.0→22.9` 显示的是实际生效的数值**,不管 tooltip 上写了什么。

—

## 命令

“`
/damageprobe on | off
/damageprobe status
/damageprobe verbose
/damageprobe effects on|off
/damageprobe modifiers on|off
/damageprobe rejected on|off
/damageprobe filter all | players
“`

`filter` 是运行时覆盖设置 — **不会**写回配置文件;重启后会恢复为配置中的默认值。

—

## 运行要求

– Minecraft **1.20.1**,Forge **47.x**
– 服务端工具(客户端侧事件会被跳过)
– 无前置依赖;可与任何模组共存

—

## 一句话总结

> 它是手术刀,不是家具。用完请收起来。

> ⚠️ **仅测试用模组。正常游玩请勿装载。**

—

## 中文摘要(CurseForge Summary)

> ⚠️ 仅测试用:把一次伤害从「意图」到「真实掉血」全过程拆开,定位是哪个模组改了伤害、哪一段把它吞掉。**正常游玩请勿装载。**

—

## ⚠️ 必读:这是什么,以及为什么不该常开

**这是一个诊断工具,不是玩法模组。**

它会在服务端挂设大量事件钩子与 mixin,持续记录每一次伤害、状态效果、属性修饰符。

**实测开销**(`spark` 采样 473 秒):

“`
com.hengx.damageprobe.probe.AttributeOwnerRegistry   1620 ms
com.hengx.damageprobe.probe.ModifierProbe            1504 ms
com.hengx.damageprobe.probe.ProbeText                1104 ms
com.hengx.damageprobe.core.AmountCapture              992 ms
com.hengx.damageprobe.probe.EffectProbe               576 ms
──────────────────────────────────────────────────────────
合计约占服务端 CPU 1.2%,并会持续写入日志
“`

**因此:**

| 场景 | 是否建议装载 |
|—|—|
| 排查「伤害数值不对」 | ✅ 装,临时用 |
| 排查「buff 没生效」 | ✅ 装,临时用 |
| 排查「某个模组把伤害吞了」 | ✅ 装,临时用 |
| **正常游玩 / 长期开服** | ❌ **不要装** |
| 制作整合包并发布 | ❌ **不要打包进去** |

**默认关闭**(`enabled = false`),需要用 `/damageprobe on` 手动开启。

—

## 它能解决什么问题

玩家常说:「我这一刀明明该打 5000,结果只掉了 12 点血。」

普通日志看不出来,因为伤害在 Forge 里会经过**四个阶段**,每个阶段都可能被不同模组改写:

“`
LivingAttackEvent    →  意图伤害
LivingHurtEvent      →  护甲/抗性/附魔介入
LivingDamageEvent    →  吸收(黄心)介入
actuallyHurt         →  真正扣血
“`

**本模组会记录每个阶段的数值,并告诉你「是谁改的」。**

—

## 伤害探针

### 一行摘要

“`
[伤害探针] 玩家→训练人偶 | 理论 457.9 | hurt出 2940.0 | damage 2928.0 | 实扣 2928.0
           | 掉血 2928.0 | 血 5000.0→2072.0/5000.0
           | 归属: 事件×6.42(+2482.1) 护甲段×0.996(-12.0) 实扣0.0 结算0.0
           | 线程=Server thread
“`

### 归属分析(核心)

| 阶段 | 含义 |
|—|—|
| `事件×` | 从理论值到 `LivingHurtEvent` 出口的倍率(有模组提高了伤害) |
| `护甲段×` | 从 hurt 出口到 damage 入口的倍率(**可能大于 1**) |
| `实扣` | 从 damage 入口到实际掉血的差值(负数 = 伤害被 clamp 吞掉) |
| `结算` | 扣血后又被改回去的数值 |

### 专门处理三个容易误判的情况

**① 过量击杀**

“`
实扣 9863.4(过量击杀,超出剩余血量 20222.6)
“`

**不会**显示成 `实扣-20222`(那样看起来像是伤害被吞了)。

**② 无效写入不会抢占归属**

有些模组会在最后无条件调用 `setAmount(当前值)`(数值并未改变)。探针只记录**真正改变数值**的那次操作,因此能准确定位真凶。

**③ 识别伪异步事件**

单人游戏中,客户端也会触发 0 伤害事件;探针会**跳过客户端侧**,避免误报「Render thread 异步伤害」。

### 上下文快照

“`
上下文[攻击者]: 攻击力=3.0 非默认属性=… 效果=…
上下文[目标]:   护甲=0.0 韧性=0.0 血=1024/1024 吸收=0.0 无敌帧=20
                效果=无 血量托管=是(ClampedZombie#m_21153_)
上下文[来源]:   minecraft:mob_attack [穿甲=否 穿附魔=否 … 穿无敌=否]
“`

**`血量托管=是(…)` 是排查「掉血被吞」的关键线索** —— 它会检测目标类是否重写了 `setHealth`。

—

## 效果探针

每次施加或移除状态效果都会记录一条,**并区分「已施加」和「被拒绝」**:

“`
[效果探针] 目标=玩家#20 获得 minecraft:strength 2级 1200t 可见=是 图标=是
           来源=Zombie#1 结果=已施加 调用点=xxx.Mod.apply:88

[效果探针] 目标=Zombie#21 获得 minecraft:regeneration 1级 200t
           来源=Player#20 结果=被拒绝 调用点=xxx.Mod.apply:236
“`

**`结果=被拒绝` 是排查「buff 为什么没生效」的关键** —— 免疫、被更强效果覆盖或条件不满足,都会在这里返回 `false`。

**20 tick 内的相同事件会合并为 `(×N)`**,避免高频刷新的模组刷爆日志:

“`
… 结果=已添加 (×100)
“`

—

## 修饰符探针

每次新增或移除属性修饰符都会记录一条,**并显示数值的实际变化**:

“`
[修饰符探针] 目标=Player#23 属性=minecraft:generic.max_health
             修饰符=tetra.stats.additioncharm2 amount=2.9 operation=ADDITION
             结果=已添加 值=20.0→22.9 调用点=…
“`

**`值=20.0→22.9` 会直接告诉你「实际增加了多少」** —— 不会被 tooltip 上的显示误导。

—

## 命令

“`
/damageprobe on | off              总开关(默认关闭)
/damageprobe status                查看当前状态
/damageprobe verbose              详细模式(逐行输出四个阶段)

/damageprobe effects on|off        状态效果探针
/damageprobe modifiers on|off      属性修饰符探针
/damageprobe rejected on|off       仅查看「被拒绝」的效果

/damageprobe filter all            记录全部事件(含无来源的效果施加)
/damageprobe filter players        仅记录与玩家相关的事件(默认)
“`

**`filter` 是运行时覆盖设置,不会写回配置文件;重启后会恢复为配置中的默认值。**

—

## 输出渠道

| 渠道 | 谁能看到 |
|—|—|
| **聊天栏** | 权限等级 ≥2 的 OP;单人游戏中发送给房主 |
| **日志** | `logs/latest.log`,前缀为 `[伤害探针]` / `[效果探针]` / `[修饰符探针]` |

—

## 前置与兼容性

– Minecraft **1.20.1**
– Forge **47.x**
– **纯服务端工具**(客户端侧事件会被跳过)
– 不依赖其他模组,可与任何模组共存

—

## 一句话总结

> **它是手术刀,不是家具。用完请收起来。**

常见问题

伤害探针 / Damage Probe 支持哪些 Minecraft 版本?

伤害探针 / Damage Probe 支持 Minecraft Java 版 1.20.1,可用的加载器:Forge。下载时注意选择和你游戏版本一致的文件。

伤害探针 / Damage Probe 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Forge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

qianzhiqinghang 的其他作品

查看全部 →