CEffect —— 效果对象的完整参考

核心定位：CEffect 是游戏运行期间「一条正在生效的效果实例」在内存中的对象表达。 在 DAT 文件中每声明一个 [EFFECT] 数据块，在资源加载或技能施放时便会对应构造出一个 CEffect 对象。本文档为该底层类的权威技术参考手册，涵盖字段结构、配置键表、数值计算及存档序列化格式。

分析依据：基于 IDA 对 32 位可执行文件 Torchlight2.exe（基址 0x400000）的逐指令反汇编分析。文中所有 0x…… 均为绝对内存地址。 配置用量数据来自实机样本统计：覆盖原版 E:/Torchlight 2/MEDIA 中 16084 个 .DAT 文件，以及 MOD 库 D:/WizardProject/TL2 中 165753 个 .DAT 文件，按「包含该键的 [EFFECT] 块数量」进行统计（EFFECTSLIST.DAT 中的 239 行类型注册不计入效果块，已排除）。

关联文档：TL2 技能设计指南 从技能开发的视角串联了 [EVENT_*] / [LEVELn] / [EFFECT] / [AFFIXES] 的层级关系。本文档不重复设计方法论，专精于 CEffect 单一类的底层解剖。词缀容器侧的机制参见 CAffix 参考手册，挂载与调度侧参见 CEffectManager 参考手册，状态栏显示侧参见 CEffectDisplayMgr 参考手册。

0. 配置样例速览 ​

在展开底层解剖之前，先给出三个取自原版数据的真实 [EFFECT] 块（内容原文照录，仅将缩进统一为 4 个空格），以及两份可直接套用的骨架。三个样例分别覆盖了光环、持续伤害与属性缩放这三类最典型的配置形态。

0.1 光环型：MEDIA/AFFIXES/SKILLS/EMBERMAGE_FLAMEAURA_DEF.DAT ​

[EFFECT]
    <STRING>NAME:FLAMEAURA_DEF
    <STRING>ACTIVATION:DYNAMIC
    <STRING>TYPE:PERCENT DAMAGE TAKEN
    <STRING>DAMAGE_TYPE:ALL
    <BOOL>NOGRAPH:true
    <STRING>UNITTHEME:flameaura
    <BOOL>SAVE:true
    <BOOL>EXCLUSIVE:true
    <STRING>ICON:skillicon_flameaura
    <BOOL>MODIFIERISBONUS:true
    <FLOAT>MIN:-5
    <FLOAT>MAX:-5
[/EFFECT]

逐条解读：

• 未声明 DURATION —— 字符串为空，被替换为 ALWAYS 并写入 -1000.0；同时标志位 0x1 不会置位。这是「永久生效」的标准写法。
• TYPE:PERCENT DAMAGE TAKEN 对应 EFFECTSLIST.DAT 的第 26 行。该行的 GRAPH1 / GRAPH2 两列均为空，因此即使不写 NOGRAPH:true 也不会绑定任何曲线（原理见第 6 节）。此处的 NOGRAPH:true 属于冗余但无害的保险写法。
• MIN 与 MAX 同为 -5，区间随机退化为定值 -5，数值完全可控。
• EXCLUSIVE:true 配合非空的 NAME，构成 NAME + TYPE 的去重键：同一单位上重复施放只刷新、不叠加。
• SAVE:true 使该效果进入存档；UNITTHEME / ICON / MODIFIERISBONUS 分别负责单位主题贴图、状态栏图标与 UI 加成归类。

0.2 持续伤害（DoT）型：MEDIA/AFFIXES/SKILLS/SPELL_POISONCLOUD.DAT ​

[EFFECT]
    <STRING>ACTIVATION:PASSIVE
    <STRING>DURATION:6
    <STRING>TYPE:DAMAGE
    <STRING>DAMAGE_TYPE:POISON
    <BOOL>SAVE:true
    <FLOAT>MIN:25
    <FLOAT>MAX:25
    <FLOAT>MINFORCE:0
    <FLOAT>MAXFORCE:0
[/EFFECT]

逐条解读：

• TYPE:DAMAGE 对应 EFFECTSLIST.DAT 的第 52 行（即 0x34）。配合有限时长 DURATION:6，恰好命中 0x7AB94A 的预置条件，EXCLUSIVE 的默认值被抬升为 true。该 DoT 天然独占，重复施加只刷新时长。若需要可叠加，必须显式补写 <BOOL>EXCLUSIVE:false。
• 第 52 行的 GRAPH1 / GRAPH2 均为 DAMAGE_MONSTER，因此槽 0 与槽 1 会被绑定曲线。计算走分支一：先在 MIN~MAX 之间掷值（此处两端同为 25，结果恒为 25），再当作百分比去乘曲线求值结果——即「曲线值的 25%」，而不是「每跳 25 点伤害」。
• MINFORCE / MAXFORCE 是槽 2 / 槽 3 的别名，来自第 52 行的 VALUE3 / VALUE4 两列（别名机制见第 5 节）。槽 2–4 在全部 239 个类型中都不存在默认曲线，故恒走区间随机分支。
• 未声明 NAME —— 名称为空串。所有空名效果在去重判定中会被视为彼此同名，这一点在与 EXCLUSIVE 联用时需格外留意。
• ACTIVATION:PASSIVE 使 +0x20 为 0，进而触发 STAT_SOURCE_TYPE 的兜底逻辑，将 +0x12C 置为 3（ON UPDATE SELF）。

0.3 属性缩放型：MEDIA/AFFIXES/SKILLS/PHALANX.DAT ​

[EFFECT]
    <BOOL>SAVE:true
    <STRING>NAME:PHALANX PERCENT SPEED
    <STRING>ACTIVATION:PASSIVE
    <STRING>TYPE:PERCENT SPEED
    <STRING>STATMODIFYNAME:DEFENSE,MELEE
    <STRING>STATMODIFYPERCENT:50,50
    <STRING>DURATION:0
    <FLOAT>MIN:50
    <FLOAT>MAX:50
[/EFFECT]

逐条解读：

• STATMODIFYNAME 与 STATMODIFYPERCENT 以英文逗号分列，按下标一一配对，最终形成 DEFENSE × 0.5 与 MELEE × 0.5 两组属性倍率。
• DURATION:0 是一处容易误读的写法：字符串非空，故标志位 0x1 会置位；但解析出的数值 0 不满足「大于 0」的条件，最终仍落回 -1000.0（ALWAYS）。也就是说，其生效结果与不写 DURATION 相同，唯独标志位 0x1 的状态相反——而该位正是词缀系统推导自身时长的依据。
• TYPE:PERCENT SPEED 为第 21 行，无默认曲线，走区间随机分支；MIN 与 MAX 同为 50，结果恒为 50。

0.4 可直接套用的骨架 ​

最小可用骨架（仅保留必要键）：

[EFFECT]
    <STRING>TYPE:PERCENT SPEED
    <STRING>NAME:MY_EFFECT_SPEED
    <STRING>ACTIVATION:PASSIVE
    <STRING>DURATION:ALWAYS
    <FLOAT>MIN:10
    <FLOAT>MAX:10
[/EFFECT]

完整骨架（涵盖各功能分区，右侧 ← 为注解，并非 DAT 语法，实际使用时请删除）：

[EFFECT]
    # ---- 身份：决定「这是什么效果」----
    <STRING>TYPE:DAMAGE                    ← 必填。拼错静默变 193 (NONE)，整条效果失效
    <STRING>NAME:MYMOD_BURN                ← 去重键的一半，建议加 MOD 前缀避免撞名
    <STRING>ACTIVATION:DYNAMIC             ← PASSIVE / DYNAMIC / TRANSFER，拼错静默变 DYNAMIC
    <STRING>DAMAGE_TYPE:FIRE               ← 缺省 Physical；拼错则变 Magical，两者结果不同

    # ---- 时长：最高频的失效原因 ----
    <STRING>DURATION:6                     ← INSTANT / ALWAYS / 正数秒；必须大于 0 才被视为限时

    # ---- 数值 ----
    <BOOL>NOGRAPH:true                     ← 类型自带默认曲线时，需显式声明才能启用区间随机
    <FLOAT>MIN:20                          ← 槽 0，别名查 EFFECTSLIST 对应行的 VALUE1 列
    <FLOAT>MAX:40                          ← 槽 1，别名查 VALUE2 列
    # <STRING>GRAPHOVERRIDE:MY_CURVE       ← 一旦声明，将覆盖全部 5 个槽的曲线

    # ---- 叠加与持久化 ----
    <BOOL>EXCLUSIVE:true                   ← 有限时长的 DAMAGE 默认即为 true，其余类型默认 false
    <BOOL>SAVE:true                        ← 未声明则该效果不写入存档

    # ---- 表现 ----
    <STRING>ICON:myicon_burn
    <STRING>PARTICLE_FX:MY_BURN_FX
    <STRING>UNITTHEME:burning
[/EFFECT]

1. 运行架构与生命周期 ​

一个 CEffect 对象在孤立状态下不执行任何逻辑。它本质上是一组属性数据外加一个已缓存的计算数值，必须被挂载至某个 CEffectManager（效果管理器）中，才会接收每帧的 tick 更新、显示在 UI 状态增益栏中，并被持久化序列化至存档。未完成挂载的 CEffect 仅仅是一块静态内存数据。

.DAT 中的 [EFFECT] 数据块
   └─ CEffect__ctorFromDat (0x7AAA30)        读取 24 个配置键与 5 个数值槽，计算并缓存最终数值
        └─ CEffectManager::linkEffect (0x7B1D70)   根据 ACTIVATION 属性分流挂入三张管理表之一
             ├─ 逐帧更新 (tick): 比较 DURATION 与已流逝时间 elapsed (+0x18) 判定生命周期
             ├─ 过期销毁: CEffect__expire (0x7A645E) 标记墓碑标志位 0x20
             └─ 存档持久化: 与 CEffect__save_read (0x7AA300) 构成序列化对偶

CEffectManager 并非全局单例。每个物品（CItem）和每个角色单位（CCharacter）各持有一个独立实例，通过虚函数表第 99 槽获取（CItem__getEffectMgr_vt99 0x514520、CCharacter__getEffectMgr_vt99 0x51C960），并在首次使用时按需创建 (0x513E90)。本文档重点阐明其对 CEffect 的管理契约（详见第 7 节）。

在逆向分析中，用于交叉核实字段与生命周期的三条核心构造路径如下：

2. 内存数据结构 (CEffect Memory Layout) ​

CEffect 的 RTTI 继承关系为 CEffect : CRunicCore，虚函数表位于 0x219A888，单个对象在内存中占用 304 字节 (0x130)。

2.1 C++ 结构体声明 ​

下列声明由上表逐字段还原而来，偏移量与 sizeof 均已通过 static_assert 自校验，可直接用于编写内存补丁或 Hook 代码。

// ---- 辅助类型 ----

// 引擎自有的动态数组容器，四个字段一组，共 16 字节
template <class T>
struct core_vector {
    T*           data;        // +0x00
    unsigned int size;        // +0x04
    unsigned int capacity;    // +0x08
    unsigned int growth;      // +0x0C  扩容步长
};

// 本 exe 使用的 MSVC std::wstring 实测为 28 字节（含 8 字符 SSO 缓冲区）
struct wstring28 { unsigned char raw[28]; };

// RTTI 继承链的根，共 8 字节
struct CRunicCore {
    void** vftable;           // +0x00
    int    field_04;          // +0x04  构造时置 0
};

// ---- 枚举 ----

enum EActivation {            // +0x20，表 g_EffectActivationNames @0x3B9E930
    ACTIVATION_PASSIVE  = 0,
    ACTIVATION_DYNAMIC  = 1,  // 构造默认值
    ACTIVATION_TRANSFER = 2,
};

enum EDamageType {            // +0x14，表 @0x3B9CAB0
    DAMAGE_PHYSICAL = 0, DAMAGE_MAGICAL = 1, DAMAGE_FIRE  = 2, DAMAGE_ICE = 3,
    DAMAGE_ELECTRIC = 4, DAMAGE_POISON  = 5, DAMAGE_ALL   = 6,
};

enum EStatSourceType {        // +0x12C，表 @0x3B9E988
    STATSRC_ON_CAST_CASTER   = 0, STATSRC_ON_CAST_RECEIVER = 1,
    STATSRC_ON_UPDATE_CASTER = 2, STATSRC_ON_UPDATE_SELF   = 3,
};

enum EEffectFlags {           // +0x28，详见第 3 节
    EFF_DURATION_WRITTEN = 0x000001,  // DURATION 字符串非空
    EFF_DISPLAYPOSITIVE  = 0x000002,
    EFF_EXCLUSIVE        = 0x000004,
    EFF_NONMAGICAL       = 0x000008,
    EFF_SAVE             = 0x000010,
    EFF_EXPIRED          = 0x000020,  // 运行时墓碑位
    EFF_DESC_CACHED      = 0x000040,  // 由 reset 置位，供 Tooltip 使用
    EFF_USEOWNERLEVEL    = 0x000080,
    EFF_GRAPHS_BOUND     = 0x000100,  // NOGRAPH 为假即置位，与 GRAPHOVERRIDE 无关
    EFF_MODIFIERISBONUS  = 0x000200,
    EFF_LINK_NAME        = 0x000800,
    EFF_PARTICLE_FX      = 0x001000,
    EFF_UNITTHEME        = 0x002000,
    EFF_REF_GUID_VALID   = 0x004000,  // +0x30/+0x34 有效
    EFF_GUID2_VALID      = 0x008000,  // +0x38/+0x3C 有效
    EFF_REMOVEONOWNERDIE = 0x010000,
    EFF_ICON             = 0x020000,
    EFF_DISPLAYMAXMOD    = 0x040000,
    EFF_APPLIES_WEAPON   = 0x080000,  // CSocketable__tagEffectsByHostItemType
    EFF_APPLIES_ARMOR    = 0x100000,
    EFF_IN_BYPASS_TABLE  = 0x200000,
};

// ---- 主体 ----
// RTTI: CEffect : CRunicCore   vtable @ 0x219A888   sizeof == 0x130 (304)

struct CEffect : CRunicCore {
    /* +0x08 */ int              level;              // LEVEL —— 曲线求值唯一的 X 轴输入
    /* +0x0C */ float            soakScale;          // SOAKSCALE / 暴击率乘数，缺省 9999989.0f
    /* +0x10 */ float            vestigial_10;       // 词缀级覆写量：无读取点
    /* +0x14 */ int              damageType;         // DAMAGE_TYPE (EDamageType)
    /* +0x18 */ float            elapsed;            // 已持续时间
    /* +0x1C */ int              typeId;             // TYPE，0..238，缺省 193 = NONE
    /* +0x20 */ int              activation;         // ACTIVATION (EActivation)
    /* +0x24 */ float            duration;           // DURATION，-900 = INSTANT，-1000 = ALWAYS
    /* +0x28 */ unsigned int     flags;              // EEffectFlags 位组合
    /* +0x2C */ int              iconStringId;       // ICON 的 intern id，-1 表示无
    /* +0x30 */ unsigned __int64 referencedGuid;     // 由 NAME 解析出的目标 GUID
    /* +0x38 */ unsigned __int64 sourceGuid;         // GUID2：来源技能或来源单位的 UNIQUE_GUID
    /* +0x40 */ CBaseUnit*       sourceUnit;
    /* +0x44 */ int              sourceUnitCookie;   // 弱引用注册号，初值 -1
    /* +0x48 */ CSkill*          ownerSkill;
    /* +0x4C */ int              ownerSkillCookie;   // 弱引用注册号，初值 -1
    /* +0x50 */ wstring28        name;               // NAME，经两次 toUpperW
    /* +0x6C */ wstring28        linkName;           // LINK_NAME
    /* +0x88 */ wstring28        graphOverride;      // GRAPHOVERRIDE
    /* +0xA4 */ Ogre::Vector3    vestigial_A4;       // 残留字段：无读取点，恒为零向量
    /* +0xB0 */ void*            particleInstance;   // 自身持有，析构时虚析构并释放
    /* +0xB4 */ wstring28        particleFx;         // PARTICLE_FX
    /* +0xD0 */ CAffix*          ownerAffix;         // 所属词缀，析构时反向摘除
    /* +0xD4 */ float            rolledValue;        // 已计算并缓存的最终数值
    /* +0xD8 */ float            rolledValueCeil;    // 上一字段的 ceil
    /* +0xDC */ float            slot[5];            // 五个基础数值槽
    /* +0xF0 */ CGraph*          graph[5];           // 五条曲线，与数值槽一一对应
    /* +0x104*/ core_vector<float>     statModifyPercent;  // STATMODIFYPERCENT，已除以 100
    /* +0x114*/ core_vector<CStatDef*> statModifyDef;      // STATMODIFYNAME 解析结果
    /* +0x124*/ void*            vestigial_124;      // 残留字段：无读取点，取自 CSkill+0x08 或单位 +0x1C4
    /* +0x128*/ void*            unitTheme;          // UNITTHEME 解析结果
    /* +0x12C*/ int              statSourceType;     // STAT_SOURCE_TYPE (EStatSourceType)
};

static_assert(sizeof(CRunicCore) == 0x08, "CRunicCore layout");
static_assert(sizeof(CEffect)    == 0x130, "CEffect layout");
static_assert(offsetof(CEffect, flags)      == 0x28, "");
static_assert(offsetof(CEffect, name)       == 0x50, "");
static_assert(offsetof(CEffect, slot)       == 0xDC, "");
static_assert(offsetof(CEffect, graph)      == 0xF0, "");
static_assert(offsetof(CEffect, unitTheme)  == 0x128, "");

3. 偏移 +0x28 的 22 个标志位详解 ​

+0x28 处的 32 位整型（Flags）用于控制效果的各种行为模式与状态标记。

3.1 由 DAT 配置键直接控制的标志位 ​

以下标志位在 ctorFromDat 中均成对处理（配置 true 置位，配置 false 显式清除）：

3.2 根据 DAT 属性间接计算的标志位 ​

（非布尔开关，根据对应字符串是否非空或解析是否成功动态判定）：

3.3 运行时动态设置的状态标志位 ​

4. 24 个配置键深度解析 ​

各数据读取函数的缺省行为高度一致：若指定的配置键不存在，则直接返回传入的默认实参。下表中的默认值即为汇编调用点处压栈的默认参数。

注：用量统计分别对应原版 9989 个与 MOD 库 202191 个独立 [EFFECT] 数据块中的有效配置数量。

4.1 效果定义与类型主键 ​

TYPE (<STRING>) ​

ACTIVATION (<STRING>) ​

查表未匹配时直接跳转至 0x7AAC98，+0x20 保持构造初始值。而在构造函数中初始值被显式置为 1 (0x7AAA6A mov ebx, 1 + 0x7AAA88 mov [esi+20h], ebx)。因此，拼写错误与完全不配置该键产生完全相同的结果。

DAMAGE_TYPE (<STRING>) ​

NAME (<STRING>) ​

LEVEL (<INTEGER>) ​

+0x08 是唯一直接输入 CGraph__evaluate 进行曲线求值的等级参数。角色自身等级（CBaseUnit+0x110）、技能点投入等级（CSkill+0xCC）、需求等级（LEVEL_REQUIRED）与词缀等级（CAffix+0x90）是彼此独立的变量，切勿混淆。

4.2 持续时间与时效控制 ​

DURATION (<STRING>) ​

4.3 七大通用布尔开关 ​

以下 7 个开关均通过 CDataGroup__getBool (0x677F30) 读取，默认实参一律为 0 (false)，且均采用「真置位 / 假清位」的双向赋值逻辑，因此显式配置 false 与完全不写在底层完全等价。

EXCLUSIVE (<BOOL>) —— 唯一默认值具备动态条件的布尔键 ​

4.4 数值、曲线与属性修正 ​

NOGRAPH (<BOOL>) ​

GRAPHOVERRIDE (<STRING>) ​

SOAKSCALE (<FLOAT>) ​

STATMODIFYNAME / STATMODIFYPERCENT (均为 <STRING>) ​

这两个键成对配合使用，支持以英文逗号分隔的列表格式声明多项属性修正。

4.5 视觉表现与关联属性 ​

ICON (<STRING>) ​

PARTICLE_FX (<STRING>) ​

UNITTHEME (<STRING>) ​

注意：UNITTHEME 会被序列化进存档，且是以 GUID 形式持久化存储的（详见第 8 节）。

LINK_NAME (<STRING>) ​

STAT_SOURCE_TYPE (<STRING>) ​

5. 五个基础数值槽与别名映射机制 ​

CEffect 拥有 5 个基础浮点数值槽（+0xDC…+0xEC）。在 DAT 文件中通过何种键名写入各个数值槽，由 CEffect__readValueSlot (0x7A5F00) 分两步解析判定：

第一步：按效果类型专属别名读取 ​

别名表 g_EffectParamNames_239x5 位于 0x28AABA0，维护了 239 行 × 5 列的 std::wstring 矩阵（每项 28 字节，行步长 140 字节）。行号对应效果类型 ID，列号对应数值槽 0–4。其内容完全对应于 EFFECTSLIST.DAT 中各行的 VALUE1 到 VALUE5 列。 常用的 MIN、MAX、CHANCE、MINFORCE 等键名均源自此处的别名注册，它们并非引擎内部的全局固定关键字。

第二步：未命中别名时回退至通用槽位名 ​

若别名不存在（对应列为 NA）或在当前数据块中未读取到，解析器将在 0x7A5F96 分支回退至通用名称：

核心结论与工程准则 ​

1. 通用名全局有效：VALUE、VALUE2、VALUE3、VALUE4、VALUE5 对全部 239 种效果类型均有效。在无法确认某类型的专属别名时，可直接使用通用名。
2. 优先级规则：专属别名 > 通用名。若两者同时存在，专属别名具有更高优先级。
3. 未读到的槽位保持 0.0：数值写入逻辑位于 0x7AB41C–0x7AB477，只有当读取到有效数值时才会覆写目标槽位（if (flt_289A6C8 != v37) *(float*)v35 = v37;）。
4. 禁止填写 -999：-999 在底层被用作浮点读取失败的哨兵值，填入该数值将导致解析逻辑产生不可预期的行为。

6. 核心数值计算与曲线求值公式 ​

最终效果数值的计算由 CEffect__rollAndCacheValue (0x7A85C0) 负责，其核心分流逻辑如下：

lo = 槽0数值 (通常为 MIN), hi = 槽1数值 (通常为 MAX)
if (hi == 0) hi = lo;         // 若 MAX 未配置或为 0，自动取 MIN
自动排序保证: lo <= hi        // 若 MIN 与 MAX 填反，底层自动纠正顺序

// ★ 无论走哪条分支，都先掷一次随机数，且两条 RNG 路径都把结果同时写回 lo 与 hi 两个局部
roll = random(lo, hi)         // 0x7A8697 全局 RNG / 0x7A86DC 种子 RNG
                              // 0x7A869C fst [var_4] + 0x7A86A3 fstp [var_8]：两个槽被同一结果覆盖
statMul = CEffect__evalStatModifier_resolveUnit(...)   // 计算属性加成倍率

分支一: 存在已绑定的曲线 (+0xF0 != NULL)
    最终数值 = CGraph__evaluate(graph, LEVEL) × (roll × 0.01) × statMul
    // 0x7A87AD fld [var_8] → 0x7A87B1 fmul 0.01 → 0x7A87B7 fmulp（乘曲线）→ 0x7A87B9 fmul statMul

分支二: 未绑定曲线 (无曲线指针)
    最终数值 = roll × statMul

计算结果存入 +0xD4，向上取整结果存入 +0xD8。 整个计算过程不存在数值截断或钳位（Clamp） —— EFFECTSLIST.DAT 中的 MINVAL/MAXVAL 不参与实际逻辑计算。 需要进一步纠正的是：这两列也不是「UI 用的钳位范围」。按立即数字节扫描 0x401000–0x2200000， g_EffectMinVal_239 (0x28A2500) 全程只出现 1 次，就是加载器的那次写入，没有任何读取点； g_EffectMaxVal_239 (0x28A2140) 只被读 1 次（0x7A71FD），且立刻套进 Ogre::Math::Sign—— 只取符号，量级被丢弃。该符号的用途是判定「数值往哪个方向变算好事」， 从而在 GOODDES 与 BADDES 两套描述串之间选择。详见 239 个 TYPE 的数值槽对照表。

6.1 曲线到底会不会被绑上 ​

分支一与分支二的分野完全取决于 +0xF0（槽 0 的曲线指针）是否为 NULL，而它由 CEffect__bindGraphs (0x7A6040) 决定。该函数的逻辑仅三步：

name = g_EffectGraphNames_239x5[typeId][slotIdx]     // 239 行 × 5 列，行距 140 字节，项距 28 字节
if (GRAPHOVERRIDE 非空) name = GRAPHOVERRIDE          // 覆盖名对 5 个槽一律生效
if (name 为空) return NULL                            // 与 NOGRAPH 无关，直接不绑
return GraphMgr__findGraphByName(name)

g_EffectGraphNames_239x5 位于 0x28B2E58，是与数值槽别名表 (0x28AABA0) 同构的第二张 239×5 表，内容来自 EFFECTSLIST.DAT 各行的 GRAPH1–GRAPH5 列。对原版该文件的实测结果：

即：239 个效果类型中只有 36 个登记了默认曲线，且只覆盖槽 0 与槽 1。全部 12 条被引用的曲线为 BASE_WEAPON_DAMAGE、ATTRIBUTE_BONUS、ARMOR_PLAYER_BYLEVEL_FORSET、ARMOR_MONSTER_BYLEVEL、HEALTH_PLAYER_GENERIC、HEALTH_MONSTER_BYLEVEL、MANA_PLAYER_GENERIC、DAMAGE_MONSTER、STEAL_MANA、STEAL_HEALTH_AND_MANA、ITEM_DEFENSE_REQUIREMENTS、SUMMONDURATION。

随机数生成机制：当存在来源技能时，系统采用带独立种子的 RNG 流（CSkill+0x1C8，确保同一次技能施放内的所有效果共用同一随机序列，这是多人联机同步的基础）；仅在无来源技能时才采用全局随机数生成器。

7. CEffectManager 的生命周期与管理契约 ​

CEffectManager 通过以下核心契约管理其下挂的所有 CEffect 对象：

1. 多队列分流入表： CEffectMgr__linkEffect (0x7B1D70) 根据效果的 +0x20 (ACTIVATION) 属性将指针放入不同的管理列表（入表指令在 0x7B1F13）：
   • 0 (PASSIVE) → 挂入 mgr+0x18
   • 1 (DYNAMIC) → 挂入 mgr+0x28
   • 2 (TRANSFER) → 挂入 mgr+0x38
2. 存活判定与生命周期： 存活判据是「DURATION 为 -900/-1000 哨兵、或 ACTIVATION == 2 (TRANSFER)、或 DURATION > 已持续时间」，且未被打上墓碑位 0x20。 需注意 0x7B1E20–0x7B1E5F 这段判定位于 CEffectMgr__linkEffect 内部，用途是 EXCLUSIVE 去重时判断旧效果是否仍存活，并非每帧 tick 的生命周期检查；后者在 CEffectMgr_expireEffects_perframe (0x7AF2A0) 里，用的是同一套判据。
3. 同名去重与独占替换： EXCLUSIVE（标志位 0x4）只检查新挂入的这一条，旧效果带不带该位无关紧要。命中时的行为是让已存在的同名同类型效果全部过期，新效果照常入表 —— 是替换而非「拒绝新的」或「原地刷新旧的」。判定标准为 NAME 与 TYPE 联合完全匹配。若多个效果的 NAME 均为空字符串，在底层会被视为「同名」而发生互相排斥。
4. 延迟销毁与墓碑机制： 调用 CEffect__expire (0x7A645E) 时，仅将效果标记为墓碑状态（置位 0x20），内存对象的实际回收由 CEffectMgr_expireEffects_perframe 在当前帧末尾统一执行。若标记了 REMOVEONOWNERDIE (0x10000)，当来源单位死亡时该效果将自动触发过期。
5. 按名称精准移除： 运行时的按名移除由 CEffectMgr__removeEffectsByName (0x7AECA0) 完成，匹配 +0x50 处经过大写规范化的效果名称，遍历三张表。

8. 存档结构与序列化机制 ​

8.1 逐字段二进制布局 ​

效果对象的反序列化入口为 CEffect__save_read (0x7AA300)，函数签名为 (this, stream, saveVersion, readGuid2)。其通过流对象的虚表槽 +8 (定长数据读取) 与 +12 (字符串读取) 执行反序列化。读取顺序即为二进制流中的实际存储顺序：

8.2 存档反序列化调用链 ​

CEffect__save_read 在游戏引擎中共有 4 处读取调用点：

在物品存档读取路径中，调用方传入的 readGuid2 参数固定为 0，因此保存在装备上的效果不会持久化 GUID2 来源信息。

8.3 序列化写入与存档安全保护 ​

读写两侧靠同一个流对象的不同虚表槽配对：

字段顺序逐项一致，签名也对称（this、流对象、writeGuid2 标志）。两个只在写侧才看得出来的细节：

• 数值槽的 count 是写侧裁出来的。 0x7A9539–0x7A9557 的循环是 for (i = 0; i < 5; i++) if (slot[i] != 0) count = i + 1;，即取「最后一个非零槽的下标 + 1」。 尾部为 0 的槽不写入存档——这就是读侧第 9 步那个 count 为何是变长的。 副作用：一条效果如果只用了槽 0 和槽 4，中间三个 0 也会被写进去；但只用槽 0 时只写 1 个。
• flags & 0x2000 那个 u64 是 UNITTHEME 对象的 +0x90/+0x94（0x7A94D1）， 对象为空则写 -1/-1。所以读侧拿到的是一个 GUID、需要重新解析回对象指针——两侧对得上。
• 图标（flags & 0x20000）写侧没有版本分支，一律写 u8 长度 + UTF-16， 把 +0x2C 的 intern id 反查回字符串（红黑树查找，查不到用默认串）。 对应读侧 saveVersion 不是 32/33 的那条分支。

层级上读写完全镜像：

CEquipment__saveToRecord (0x590DC0) 做的是另一件事：用 CEffect_CopyCtor 把活动效果克隆进 CItemSaveState（0x59118C、0x5911A2、0x591348）。它是「把状态搬进存档结构」， 真正的字节序列化在 CEffect__save_write。 SAVE 配置项对应的标志位 0x10 是决定效果是否允许持久化的唯一过滤闸门。

8.4 修改 DAT 配置对已有存档的实际影响 ​

1. TYPE 以索引形式存入存档（极高危险性） 第 11 步持久化保存的是 0–238 的整型行号索引而非类型名称。如果 MOD 修改了 EFFECTSLIST.DAT 的总行数或排列顺序，旧存档中所有物品与角色的效果类型将发生整体错位（例如「移动速度提升」错误映射为「流血伤害」）。因此该文件严禁调整行序。

2. 已存在的效果数值不会重新计算 5 个基础数值槽（第 9 步）、已计算数值 +0xD4（第 17 步）、LEVEL 与 DURATION 均已完整固化在存档中。载入时不会重新抽取随机数，因此在 MOD 中修改 MIN/MAX，旧存档中已有装备的属性数值纹丝不动，仅对新生成的掉落物生效。

   但「不重新绑定曲线」这一说法不成立：CEffect__save_read 读流结束后，若 flags & 0x100 置位（判定在 0x7AA6F5），会调用 sub_7A61A0——该函数对 5 个槽逐一 CEffect__bindGraphs (0x7A61EA) 重新绑定曲线，并按实际绑定结果重写 0x100 位。所以改 GRAPHOVERRIDE 会影响旧存档里的曲线指针（但不会重算已缓存的 +0xD4）。

   另有一条旧版本补偿路径：saveVersion ≤ 0x1C（28）且槽 0、槽 1 均大于 10 时（判定在 0x7AA745），会重新求值并覆写 +0xD4/+0xD8。现行版本走不到这条分支。

3. 状态标志位被完整还原EXCLUSIVE、SAVE、USEOWNERLEVEL 等 22 个标志位以整体 u32 形式存入存档（第 1 步），载入后完全还原保存时的状态。

4. 未持久化的动态字段SOAKSCALE (+0x0C)、来源单位/技能指针、所属词缀指针、5 条曲线指针均不进入存档，在载入后保持构造初始值或在挂载流程中动态重建。

9. 配置速查表 ​

[EFFECT] 24 个核心配置键               数据类型    缺省或错误处理说明
──────────────────────────────────────────────────────────────────────────
TYPE                                字符串      缺省/错误 → 193 NONE (完全失效，必填项)
ACTIVATION                          字符串      缺省/错误 → 1 DYNAMIC (可选: PASSIVE|DYNAMIC|TRANSFER)
DURATION                            字符串      缺省 → ALWAYS; 解析<=0 → ALWAYS (可选: INSTANT|ALWAYS|秒数)
NAME                                字符串      缺省 → 空名称 (去重失效); 内存中存两次大写结果
LEVEL                               整型        缺省 → 0; 负数或>1000 → 0 (USEOWNERLEVEL+有来源时不读)
DAMAGE_TYPE                         字符串      缺省 → Physical; 写错 → Magical (7 项枚举，不区分大小写)
STAT_SOURCE_TYPE                    字符串      缺省+PASSIVE → 3 (ON UPDATE SELF); 写错 → 0 (空表回退)
SOAKSCALE                           浮点        缺省/错误 → 9999989.0 (无吸收上限)
UNITTHEME                           字符串      缺省/错误 → 无单位主题
ICON                                字符串      缺省 → 无图标; 写错 → 注册新的空 intern 条目
PARTICLE_FX                         字符串      缺省 → 不播放; 写错 → 资源未找到静默跳过
LINK_NAME                           字符串      缺省 → 空字符串
GRAPHOVERRIDE                       字符串      缺省 → 用类型自带曲线(仅 36 类有); 写错 → 曲线置空
                                                一旦声明即覆盖全部 5 个槽
NOGRAPH                             布尔        默认 false; 仅对登记了默认曲线的 36 个类型有意义
EXCLUSIVE                           布尔        有限时长的 DAMAGE/DAMAGE CHANCE 自动为 true，其余为 false
SAVE                                布尔        默认 false (不存入存档)
REMOVEONOWNERDIE                    布尔        默认 false (来源死亡时不自动移除)
USEOWNERLEVEL                       布尔        默认 false (不采用来源单位等级)
DISPLAYPOSITIVE                     布尔        默认 false (原版未曾使用)
NONMAGICAL                          布尔        默认 false (不标记为非魔法)
MODIFIERISBONUS                     布尔        默认 false
DISPLAYMAXMODIFIER                  布尔        默认 false
STATMODIFYNAME                      字符串      属性名列表 (逗号分隔)；为空时 PERCENT 不被读取
STATMODIFYPERCENT                   字符串      百分比列表 (逗号分隔)；项数不足自动补齐 100

五个基础数值槽
──────────────────────────────────────────────────────────────────────────
优先级: 专属别名 (EFFECTSLIST.DAT 该行的 VALUE1..VALUE5) > 通用槽位名
通用名: 槽0=VALUE  槽1=VALUE2  槽2=VALUE3  槽3=VALUE4  槽4=VALUE5 (注: 无 VALUE1)
-999 为底层读取失败哨兵值，严禁作为数值配置。

数值计算公式
──────────────────────────────────────────────────────────────────────────
存在曲线: 最终值 = 曲线求值(LEVEL) × (random(MIN,MAX) × 0.01) × 属性加成倍率
未绑曲线: 最终值 = 均匀随机(MIN, MAX) × 属性加成倍率
MAX 为 0 自动取 MIN；MIN/MAX 顺序错误底层自动纠正；全程无数值钳位。

10. 常见排错与排坑指南 ​

Q1：配置了效果但完全不生效，游戏亦无任何报错提示？

• 首先检查 TYPE 拼写：若类型名称未能匹配 239 种合法类型，底层将静默回退至 193 (NONE)，导致效果完全失效；
• 其次检查 DURATION：对于 175 种基础效果类型，声明 INSTANT 将直接被视为空操作。

Q2：修改了 MIN 与 MAX 数值，但游戏中数值并未如期波动？

• 先按第 6.1 节的三步判定确认该效果走的是哪条分支。若走曲线分支，掷出的 MIN~MAX 随机值会被当作百分比去乘曲线值，量纲完全不同——数值看着「没变化」往往是因为曲线值本身很小或很大；
• 若该类型属于登记了默认曲线的 36 种之一，补写 <BOOL>NOGRAPH:true 即可切回区间随机；
• 若该类型本无默认曲线却仍未随机，检查是否误写了 GRAPHOVERRIDE —— 它会把曲线一次性绑到全部 5 个槽上。

Q3：调整了效果数值后，新角色/新掉落生效，但旧角色身上的旧装备数值未变？

• 属于正常现象。旧存档中的效果数值已作为静态快照固化（第 8.4 节），反序列化载入时不会重新求值或重掷随机数。

Q4：更新 MOD 后，玩家旧存档中的装备属性发生大面积混乱或错位？

• 检查是否修改了 EFFECTSLIST.DAT 的总行数或排列顺序。效果类型以行号索引入档，顺序变动会导致旧存档中的所有效果类型全局错位。

Q5：希望持续伤害（DoT）能够多层叠加，但实际测试只能刷新持续时间？

• 引擎针对具有持续时间的 DAMAGE (52) 与 DAMAGE CHANCE (156) 默认将 EXCLUSIVE 预置为 true。若需支持多层叠加，必须显式声明 <BOOL>EXCLUSIVE:false。

Q6：声明了独占（EXCLUSIVE）的两条效果依然同时存在并生效？

• 独占去重依赖 NAME 与 TYPE 的联合匹配。检查两条效果的 NAME 是否完全一致（包含大小写、空格与下划线）。若名称不完全一致，将被判定为两条独立效果。

Q7：配置了 STATMODIFYPERCENT 但未产生属性加成？

• 检查 STATMODIFYNAME 是否为空。若未提供属性名，引擎在 0x7AB5A7 处会直接跳过百分比字段的读取。

Q8：被动效果的属性修正行为异常？

• 检查 STAT_SOURCE_TYPE 拼写：当 ACTIVATION:PASSIVE 且缺省该键时，引擎自动设置为 3 (ON UPDATE SELF)；若拼写错误，将因未命中查表而保持为 0 (ON CAST CASTER)，且不会触发被动兜底补正。

Q9：声明为物理伤害，但在实战中却受到魔法抗性减免？

• 检查 DAMAGE_TYPE 拼写：拼写错误将回退至初始值 1 (Magical)，只有缺省或正确拼写 PHYSICAL 才会映射为 0 (Physical)。此外需排查该类型是否属于 9 种强制指定为 Magical 的特殊效果类型。