EFFECTSLIST.DAT —— 239 个 TYPE 的数值槽对照表

核心定位：EFFECTSLIST.DAT 是效果系统的类型注册表。 技能与词缀 dat 里每个 [EFFECT] 块的 TYPE 键，写的就是这张表某一行的 NAME； 那一行的行号会成为 CEffect+0x1C，进而决定这个效果做什么、五个数值槽分别叫什么、 缺省时套哪条曲线、tooltip 里怎么排版。本文档把这 239 行完整摊开，并把加载器逐指令拆到底。

分析依据：基于 IDA 对 32 位可执行文件 Torchlight2.exe（基址 0x400000）的逐指令反汇编分析。文中所有 0x…… 均为绝对内存地址。 用量数据来自实机样本统计：原版 E:/Torchlight 2/MEDIA 的 16084 个 .DAT 文件共 9984 个可解析 [EFFECT] 块， MOD 库 D:/WizardProject/TL2 的 157950 个 .DAT 文件共 200352 个。 MOD 库是会变的——本系列三篇的用量数字已统一到同一次全量扫描； 原版侧（16084 个文件 / 9984 个块）在整个分析期间保持不变。 EFFECTSLIST.DAT 自身的 239 行属类型注册、不计入效果块，已排除。

关联文档：效果对象本身参见 CEffect 参考手册，词缀容器参见 CAffix 参考手册， 挂载调度参见 CEffectManager 参考手册，状态栏显示参见 CEffectDisplayMgr 参考手册。 本文档不重复那四篇的内容，只负责「239 行本身」这一层。 每个类型实际做什么（走哪条执行路径、DURATION 该怎么填、写错会不会静默失效）见 239 个 TYPE 的行为解释； 每个类型的真实数据样例见 239 个 TYPE 的实例速查。

1. 这张表怎么进内存 ​

加载器是 EffectsList_dat_load_239，起始 0x401000，读取路径硬编码为字符串 "media/EffectsList.dat"（0x401068）。 它把文件解析成一串 [EFFECT] 子节点，然后按行号顺序把 19 个键分别灌进 13 张平行的全局数组。

EFFECT 键（值形如 KEFFECT_TYPE_MELEEDAMAGEBONUS）在整个加载器里没有对应的写入指令—— 它是给人看的枚举名注记，引擎从不解析。真正决定行为的是行号。

1.1 239 这个数字是怎么把自己锁死的 ​

加载完成后有一道校验（0x40109E）：

0040109E  cmp  [esp+0D4h+var_74], 0EFh   ; 0xEF = 239，子节点数量
004010A6  jz   short loc_4010E6          ; 正好 239 → 静默通过
004010A8  push offset aTheEffectFileM    ; 否则打一条日志

日志原文是 The effect file( media/effectslist.dat ) appears to no longer match up with the internal effect list. Please revert this file.

0040187D  add  [esp+0D8h+var_AC], 1Ch   ; 描述串行指针 += 28
00401882  inc  esi                      ; 行号
00401883  add  ebp, 8Ch                 ; 槽数组行偏移 += 140
00401889  cmp  esi, [esp+0D8h+var_74]   ; ← 文件实际块数
0040188D  jb   loc_401100

2. 五个数值槽是怎么对上名字的 ​

槽名表的行偏移由 ebp 携带，每行递增 0x8C = 140 = 5 × 28（wstring 在这个二进制里是 28 字节）。 加载器先算出该行的槽 1 地址，再用相对位移填其余四个：

004012F1  lea  edi, g_EffectParamNames_slot2[ebp]  ; edi = 基址 + 0x1C + 行偏移
004012FD  lea  ecx, [edi-1Ch]                      ; VALUE1 → 槽 0
              (VALUE2 直接用 edi)                   ; VALUE2 → 槽 1
004013A8  lea  ecx, [edi+1Ch]                      ; VALUE3 → 槽 2
004013FE  lea  ecx, [edi+38h]                      ; VALUE4 → 槽 3
00401454  lea  ecx, [edi+54h]                      ; VALUE5 → 槽 4

映射是直白的 VALUEn → 槽 n-1，没有重排。数组总跨度 239 × 140 = 33460 字节，与实测的符号间距一致。 读取侧只有一个函数：CEffect__readValueSlot（0x7A5F46）， 它按 CEffect+0x1C（类型号）与槽号取出别名字符串，再拿这个别名去 [EFFECT] 块里查键。

2.1 NA 的含义 ​

NA 是「这个槽没有别名」的占位写法，在 239 × 5 = 1195 个槽位里占了 676 个。 剩下 519 个槽位上共出现 62 个不同的别名。 下表按使用频次列出全部别名，以及它们各自出现在哪个槽位、哪些行：

MIN／MAX 这一对占了绝对多数（各 202 行的槽 0／槽 1）， 这也是「效果数值写成一个区间」成为默认写法的原因——但区间的含义因场景而异： 装备词缀里它是品质插值的两端（见 CAffix）， 技能效果里它是随机滚动的两端，而只有在该行注册了默认曲线时才需要 NOGRAPH:true 才能拿到真随机（见下节与 CEffect §6.1）。

3. 曲线槽：表里有五个位置，只有两个填得上 ​

g_EffectGraphNames_239x5（0x28B2E58）与槽名表同构——同样 239 行、同样 0x8C 行距、同样 5 个 28 字节的 wstring。 但加载器只写前两个：

004014AA  lea  ecx, g_EffectGraphNames_239x5[ebp]  ; GRAPH1 → 曲线槽 0
00401503  lea  ecx, unk_28B2E74[ebp]               ; GRAPH2 → 曲线槽 1（+0x1C）

而 EFFECTSLIST.DAT 里根本不存在 GRAPH3／GRAPH4／GRAPH5 这三个键（全表 19 个键，已在第 1 节列全）。

全表 239 行里只有 36 行注册了默认曲线。 另一个实测结论：这 36 行的 GRAPH1 与 GRAPH2 完全相同，无一例外， 所以两列的区分在原版数据里从未体现过。

4. MINVAL 与 MAXVAL：一列是死数据，一列只贡献符号 ​

这两列长期被理解成「数值的合法范围」或「UI 钳位」。逐指令核对的结果是两者都不成立。

按立即数字节扫描 0x401000–0x2200000（不依赖 IDA 的交叉引用，避免漏掉 SIB 寻址形式）：

• g_EffectMinVal_239（0x28A2500）全程出现 1 次，就是加载器 0x4017FD 的那次写入。 没有任何读取点。MINVAL 是一列纯粹的死数据。
• g_EffectMaxVal_239（0x28A2140）出现 2 次：写入 0x401857，读取 0x7A71FD。 而那唯一的读取长这样：

007A71FD  fild  g_EffectMaxVal_239[ebx*4]   ; 整数载入
007A7204  fstp  dword ptr [esp+164h+X+4]
007A7207  call  ds:?Sign@Math@Ogre@@SAMM@Z  ; Ogre::Math::Sign —— 只留符号

量级被 Ogre::Math::Sign 丢弃了。 这一列实际编码的是「这个属性往哪个方向变算好事」。

4.1 好／坏描述串的完整选择链 ​

读取点位于 CEffect__build_tooltip_desc（函数起始 0x7A70B0）。两个栈变量控制最终取哪个串：

007A71A9  mov   [esp+160h+var_10C], 1       ; var_10C = 1 → 默认「好」
007A71AE  mov   byte ptr [...var_14A], 0    ; var_14A = 0 → 默认非「持续」措辞

; ── var_14A：是否用 OT（over time）措辞 ──
007A719C  fld   dword ptr [esi+24h]         ; CEffect+0x24 = DURATION
007A719F  fld   ds:flt_219A6E0              ; = -900.0
007A71B8  jnp   loc_7A71D1                  ; 相等 → 保持 0
007A71BA  fld   dword ptr [esi+24h]
007A71BD  fld   ds:flt_219A6E4              ; = -1000.0
007A71CA  jnp   loc_7A71D1                  ; 相等 → 保持 0
007A71CC  mov   byte ptr [...var_14A], 1    ; 两个哨兵都不是 → 用 OT 措辞

; ── var_10C：好还是坏 ──
007A71D1  mov   ebx, [esi+1Ch]              ; 类型号
007A71D4  cmp   g_EffectDisplayKind_239[ebx*4], 2
007A71DC  jz    short loc_7A7226            ; TYPE:None → 整段跳过，保持「好」
007A71E4  fucom st(1)                       ; 数值 vs 0.0
007A71ED  jnp   short loc_7A7224            ; 数值为 0 → 跳过，保持「好」
          s1 = Sign(数值)
          s2 = Sign((float)MAXVAL[类型号])
007A7214  fucompp
007A721B  jnp   short loc_7A7226            ; 符号相同 → 保持「好」
007A721D  mov   [esp+160h+var_10C], 0       ; 符号不同 → 改判「坏」

（test ah, 44h ＋ jnp 是 MSVC 的浮点相等判定惯用式：fucom 相等时置 C3，ah & 0x44 == 0x40， 奇校验使 PF = 0，于是 jnp 在相等时跳转。）

四路选择在 0x7A7371–0x7A73D8：

索引算法是 ecx = 类型号 * 8 - 类型号（即 ×7）后取 [基址 + ecx*4]，等价于 基址 + 类型号 * 28，与 wstring 步长吻合。

4.2 MAXVAL 符号为负的行 ​

全表 220 行是标准的 MINVAL:-100 ／ MAXVAL:100。剩下 19 行如下， 其中 4 行的 MAXVAL 为负——这正是「数值越低越好」的属性，符号翻转后 Sign 判定才正确：

MINVAL 一列在这 19 行里也出现了与 MAXVAL 倒挂的写法（如第 11 行 MINVAL:20 ／ MAXVAL:-20）， 但既然它没有读取点，这种倒挂纯属数据侧的书写惯例，不产生任何行为。

5. 显示形态与精度 ​

5.1 TYPE 列：只有 None 有意义 ​

加载器把这一列归一化成一个整数（0x401748 起，缺省实参是字面量 "VALUE"，随后 toUpperW）：

00401792  mov  g_EffectDisplayKind_239[esi*4], 1   ; == "PERCENT"
;  否则：
004017AB  movzx edx, al                            ; al = (值 == "NONE")
004017AE  neg   edx
004017B3  sbb   edx, edx                           ; edx = 相等 ? -1 : 0
004017B5  and   edx, ebx                           ; ebx = 2（0x40104F 处 mov ebx, 2）
004017B7  mov  g_EffectDisplayKind_239[esi*4], edx ; NONE → 2，其余 → 0

5.2 精度两列 ​

DISPLAYPRECISION（0x28A19C0，int）与 DISPLAYPRECISIONMAXVAL（0x28A1600，float） 成对传给同一个格式化函数 sub_7A6760，在 build_tooltip_desc 里被调用四次 （0x7A7269、0x7A72C3、0x7A7303，以及 0x7A733F 之后一处）， 分别对应「数值」「上限数值」「时长」「区间上界」四个待排版的数字。

DISPLAYPRECISION 全表 222 行为 0，14 行为 1，3 行为 2：

DISPLAYPRECISIONMAXVAL 的取值只有三种：0（226 行）、19（10 行）、9（3 行）。

6. 完整对照表 ​

列的读法

• # —— 行号，也就是 CEffect+0x1C 里存的类型号，以及存档里落盘的那个整数。
• TYPE 名 —— [EFFECT] 块的 TYPE 键要写的字面值，比较前会被大写化。
• 槽 0–4 —— 该行 VALUE1–VALUE5 注册的键名；· 表示该槽写的是占位值 NA，无可用键名。
• 形 —— g_EffectDisplayKind_239 的值：值 = 0，% = 1（与 0 等价），无 = 2。
• 默认曲线 —— GRAPH1（该行 GRAPH2 与之相同）。留空表示无默认曲线，NOGRAPH 对该行无意义。
• 特判 —— 引擎里针对该类型号硬编码的分支，代号见第 7 节。
• 原版／MOD —— [EFFECT] 块里 TYPE 命中该行的次数；· 为 0。

7. 引擎里按类型号硬编码的分支 ​

上表「特判」列的代号在此展开。这些判定不看数据，只看类型号，改 EFFECTSLIST.DAT 无法迁移它们。

7.1 品质插值的完整门禁 ​

CAffix__applyQualityPercentToEffects 里，一个效果要想被品质插值改写数值，得连过五道：

007A4217  fld   dword ptr [ecx+0DCh]        ; MIN
007A421D  fcomp dword ptr [ecx+0E0h]        ; vs MAX
007A4228  jnp   loc_7A42AE                  ; ① MIN == MAX → 无区间，跳过
007A422E  xor   eax, eax
007A4230  lea   edx, [ecx+0F0h]
007A4236  cmp   dword ptr [edx], 0
007A4239  jnz   short loc_7A42AE            ; ② 五个槽任一被显式写过 → 跳过
007A423F  cmp   eax, 5
007A4242  jb    short loc_7A4236
007A4244  mov   eax, [ecx+1Ch]              ; 类型号
007A4247  cmp   g_EffectAffixModifies_239[eax], 0
007A424E  jz    short loc_7A42AE            ; ③ AFFIX_MODIFIES:false → 跳过
007A4250  cmp   eax, 3Bh
007A4253  jz    short loc_7A42AE            ; ④ 59  SCALE               → 跳过
007A4255  cmp   eax, 0A3h
007A425A  jz    short loc_7A42AE            ; ⑤ 163 DESTRUCTABLE SHIELD → 跳过
          ; 通过：值 = MIN + (MAX - MIN) × 品质百分比
007A4290  call  CEffect__setSlotAndReroll

第③道走数据（AFFIX_MODIFIES 列，共 4 行为 false），第④⑤道是写死的两个类型号。 所以一共 6 个类型的词缀数值不做品质插值，但成因分属两套机制，改数据只能影响其中 4 个。

8. 从未被使用的 16 行 ​

原版用到 185／239 个类型，MOD 库用到 222／239，并集 223／239。 两边用量都为 0 的有 16 行：

其中 JAUNTINESS（轻快）、SOCKS（袜子）、LOGIC RESISTANCE（逻辑抗性）、EMOTIONAL DAMAGE（情感伤害）、CHEATED 明显是开发期的占位或玩笑行；TO HIT BONUS、PERCENT ITEM REQUIREMENTS、SPAWN UNIT 一类 则是有名有实、只是最终没进正式数据的功能。

9. 排错 ​

9.1 TYPE 拼错会怎样：静默降级为第 193 行 ​

匹配循环在 CEffect__ctorFromDat（函数起始 0x7AAA30）：

007AAB9E  call toUpperW                     ; dat 里的值先大写化
007AABBB  xor  ebx, ebx                     ; 候选行号 = 0
007AABBD  mov  ebp, offset g_EffectTypeNames_239
007AABC2  ...
007AABCB  call std::operator==<wchar_t>     ; 逐行比较
007AABD6  jnz  short loc_7AABE9             ; 命中
007AABD8  add  edi, 1Ch                     ; 下一行（wstring 步长 28）
007AABDB  inc  ebx
007AABDC  add  ebp, 1Ch
007AABDF  cmp  edi, 1A24h                   ; 0x1A24 = 239 × 28
007AABE5  jb   short loc_7AABC2
007AABE7  jmp  short loc_7AABEC             ; ← 全表未命中：直接跳过赋值
007AABE9  mov  [esi+1Ch], ebx               ; 命中才写类型号
007AABEC  mov  eax, [esi+1Ch]               ; 无论如何都要读它

未命中时 [esi+0x1C] 保持构造初值，而初值在同一函数开头就已定下：

007AAA7E  mov  dword ptr [esi+1Ch], 0C1h    ; 0xC1 = 193

第 193 行是 NONE——TYPE:None、四个描述串全空、槽名全为 NA 的空操作行。

9.2 MOD 库里实测到的失效 TYPE ​

在 MOD 库的 200352 个效果块中，有 206 个块的 TYPE 对不上任何一行， 涉及 20 个不同的错误值。它们全部静默降级为 NONE：

SUMMONIU 与 DESUMMONIU 这两个错法值得单说：它们是把 MON 误替换成 IU 的批量查找替换事故， 两处成对出现，说明出自同一次操作。

9.3 其他常见误判 ​

「我在 [EFFECT] 里写了 CHANCE，但没生效。」 查第 6 节该行的槽 0–4。CHANCE 只在 17 行上注册过，其余行写它等于写注释。

「NOGRAPH:true 加了，MIN～MAX 还是不随机。」 只有第 3 节那 36 行有默认曲线，NOGRAPH 对它们之外的 203 行无作用； 数值不随机是别的原因（词缀场景下是品质插值，见 7.1 节）。

「改了 MINVAL／MAXVAL，游戏里数值没被限制住。」MINVAL 没有读取点，MAXVAL 只贡献符号。这两列限制不了任何东西（第 4 节）。 真想限制数值范围，得在写数据时自己控制。

「把某行的 TYPE 列从 Value 改成 Percent，显示没变。」 这两个值对引擎等价（5.1 节）。百分号在 GOODDES 等描述串里。

「往 EFFECTSLIST.DAT 末尾加了一行新类型。」 文件块数不再等于 239，加载器会打一条日志然后继续越界写（1.1 节）。 这不是「新类型不可用」，是内存损坏。

10. 速查 ​