TL2 左键触发机制逆向分析：Move/Attack 二合一、攻击距离判定与 64 条原版键位

0. 核心结论速览 ​

1. 左键是「移动/攻击」二合一，名字是引擎自己起的：MEDIA/KEYMAPPING/KEYBIND.DAT 的第一条绑定就是 NAME:Move/Attack KEY:LMB EXCLUSIVE:true。同一张表里 Move（只走不打）是独立按键 `。⇒ 「只走」在引擎眼里是需要额外按键的例外，默认路径就是 Move/Attack。
2. 两条调用链汇到同一个分叉函数：鼠标消息 sub_43D610 → sub_439750（点击派发）→ sub_42A4E0；每 tick 的 sub_439180（命令处理器）→ sub_438080（order 处理器）→ 同一个 sub_42A4E0。
3. sub_42A4E0(controller, a5) 每次被调都重新分叉：光标下的单位进 controller+488（主目标）/ +512（次目标）；CCharacter__isHostileTo 为真走攻击路（够不着就先靠近再 sub_544200，够得着直接 sub_544200）；没有敌对目标且 a5 为真 ⇒ sub_426DC0() 走路。
4. 主目标不粘：controller+488 每 tick 由悬停拾取刷新，不是点一次就锁住。
5. 按住不放会持续下单，证据是 0x43A903 起的 20 个字节：cmp byte [ebp+52h],0 → jnz +0Dh 正好跨过把待处理点击目标 dword_287DBF8/DBFC 清成 −1 的三条指令（3+5+5=13 字节）→ mov byte [ebp+52h],1。第一 tick 清一次并置位，之后每 tick 目标还在就重复下单，直到松手（+0x52 在松手路径 0x43A69E 被清 0）。
6. 下单是每 tick 的，节奏由被调方把关：纯移动 sub_426DC0 内部有 *(float*)(this+56) = 0.1 的 0.1 秒节流；攻击的节奏在 sub_544200 / sub_545070 里（攻击延迟 / 动画）。调用方一行冷却都不写。
7. 攻击距离 CCharacter::isTargetInAttackRange = sub_5350C0，形状是「先高度门、再水平距离」：|dy| > 2.5 且不是远程 ⇒ 直接 false；然后 reach + rangeBonus >= (d − r目标) − r自己。
8. 2.5 是从数据段读出来的：0x5351FE 处 fcomp dword ptr [0x216FDF8]，0x216FDF8 的四个字节 00 00 20 40 就是小端 float 2.5。
9. 远近由装备决定：CInventory::getItemAtEquipLocation(inv, 1) 与 (inv, 2) 两个武器槽，任一件 hasUnitType(0x23) 且不是 0xBC、也不是 0x74 ⇒ 远程分支；当前技能的 +36 字节为真也算远程。rangeBonus 只在远程时非 0，值是 getStat(78, 7, 0)。
10. 三份 KEYMAPPING DAT 一共 64 条绑定：KEYBIND 40 + QUICKKEYS 14 + HELPERBINDINGS 10。隐藏 11、独占 48、带修饰键 14、鼠标 5，全部能映射。
11. 原版数据自带一条冲突：CTRL+S 绑了两次（SoundDebug / SteamStatsData，都在 HELPERBINDINGS.DAT，都 EXCLUSIVE:false、都 HIDDEN:true）。谁赢没查。
12. w 是 WeaponSwap、s 是 SkillMenu、a 是 AutoTarget ⇒ TL2 原生没有 WASD 移动，任何要加 WASD 的 MOD 都得先解决这三条冲突。
13. TL2 的字符串转 bool 只看首字符：非空且首字符 ∉ {F, f, 0} ⇒ 真。MOD 里写 no / off 全都是 true。

1. 左键是 Move/Attack 二合一 ​

1.1 引擎自身命名与数据定义 ​

该结论源自两个互不依赖的证据链：反汇编控制流首先揭示了「移动与普通攻击共用同一入口」，随后原版配置文件 KEYBIND.DAT 第一条显式声明 Move/Attack。汇编实现与数据定义完全吻合，互为独立佐证。

KEYBIND.DAT 里与这条口径直接相关的绑定：

HoldPosition 与 AttackOnlyTargets 两行的「口径」一列是按 DISPLAYNAME 推断的字面语义，底层具体执行分支未做深入展开。

1.2 两条调用链，一个分叉点 ​

鼠标消息  sub_43D610 ──► sub_439750（点击派发）        ──► sub_42A4E0（移动/攻击分叉）
每 tick   sub_439180（命令处理器）──► sub_438080（order 处理器）──► sub_42A4E0（同一个）

点击那一刻走上面那条，之后每个 tick 走下面那条，终点都是 sub_42A4E0。这就是为什么「按住」与「点一下」在引擎里是同一个函数在反复跑，而不是两套逻辑。

1.3 sub_42A4E0(controller, a5) 的三步分叉 ​

每次被调都从头分叉，不带上一次的状态：

a5 是「允不允许走」的开关。点击路径上传的是 1——0x43A8FA 处的 9 个字节 6A 01 8B CD E8 DD FB FE FF 就是 push 1 / mov ecx,ebp / call sub_42A4E0。

sub_544200 是真正「启动移动/攻击」的函数，本文只到调它为止，它内部怎么起动画、怎么算伤害没有逆。

1.4 主目标每 tick 刷新，不粘 ​

controller+488 不是点一次就锁住的。它由悬停拾取管线每 tick 重写，光标挪开了目标就变。⇒ 「按住左键扫过一群怪」在引擎里等价于每 tick 对光标当前指着的那只重新下单。

2. 按住不放会持续下单 ​

2.1 0x43A903 起的 20 个字节 ​

这是「按住持续下单」的全部证据。原始字节：

80 7D 52 00 75 0D 83 C8 FF A3 F8 DB 87 02 A3 FC DB 87 02 C6

拆开看：

jnz +0Dh 的 0x0D = 13 = 3+5+5，正好跨过那三条清 −1 的指令，落在 C6 上。于是：

• 第一 tick：标志为 0，不跳 ⇒ 清一次待处理目标，然后置位。
• 之后每 tick：标志为 1，跳过清除 ⇒ 目标还在，就再下一次单。
• 松手：+0x52 在松手路径 0x43A69E 被清 0，循环结束。

2.2 它紧接着 call sub_42A4E0 ​

0x43A8FA 的 9 字节 push 1 / mov ecx,ebp / call sub_42A4E0 加 9 正好是 0x43A903。也就是说这 20 字节是 call sub_42A4E0 返回之后的第一件事——每 tick 先分叉一次（§1.3），回来再决定要不要把目标清掉。

2.3 节奏由被调方把关 ​

下单是每 tick 的，但攻击不会每 tick 挥一次。节奏在被调方：

调用方 sub_42A4E0 及其上游一行冷却都不写。

3. 攻击距离：CCharacter::isTargetInAttackRange（sub_5350C0） ​

3.1 判定形状：先高度门，再水平距离 ​

① 高度门   if (fabs(dy) > 2.5 && !远程)  return false;      // 先于一切
② 水平距离 d = length(目标位置 − 自己位置, 其中 Y 分量置 0);
③ 判定     return reach + rangeBonus >= (d − r目标) − r自己;

顺序是硬的：高度门在水平距离比较之前。一只怪站在比你高 2.5 以上的台子上，近战连水平距离都不比就判「够不着」。

3.2 reach 的构成 ​

reach      = sub_52A9D0(player) * *(float*)(player + 1588)
rangeBonus = 远程 ? getStat(78, 7, 0) : 0

• sub_52A9D0 取的是当前选中技能的 +108 字段，并会被武器抬高；双持时取两把里大的那个。
• +1588 是单位上的一个 float 乘子。
• rangeBonus 只在远程分支非 0，值是 stat 下标 78。

技能的 +108、单位的 +1588、stat 78 各自对应哪个 DAT 键名，本文材料里没有，不猜。

3.3 远近由装备决定 ​

「远程标志」（§3.4 汇编里的 bl）这样算：

三条任一成立即远程。⇒ 「够不够得着」是装备的函数，不是角色的常量。三个 unittype 下标在材料里只有十六进制值，没有对应到 UNITTYPES 名字。

3.4 高度门的字节，与那个 2.5 ​

0x5351FE 起 18 字节：

D8 1D F8 FD 16 02 DF E0 F6 C4 41 75 08 84 DB 0F 84 D9

常量本体在 0x216FDF8，4 字节 00 00 20 40，小端 float = 2.5。该数值直接提取自可执行文件的数据段常量。

4. 键位全表 ​

4.1 三份 DAT 与普查 ​

MEDIA/KEYMAPPING/ 下三份 DAT（UTF-16LE），每条绑定是一个 [KEYBIND] … [/KEYBIND] 块，字段 NAME / DISPLAYNAME / KEY / MODIFIERKEY / EXCLUSIVE / HIDDEN。

普查：隐藏 11 · 独占 48 · 带修饰键 14 · 鼠标 5 · 映射不出来的 0。HELPERBINDINGS.DAT 的 10 条全部 HIDDEN:true、全部 EXCLUSIVE:false。

KEY 与 MODIFIERKEY 都是字符串，大小写混用（KEY:F 与 KEY:c 并存）。引擎侧怎么解析这两个串没逆——下面的表照数据原样列，不折大小写。

4.2 64 条全表 ​

4.3 数据里本来就有的冲突 ​

同一个 (KEY, MODIFIERKEY) 出现多次是原版数据的性质，不是解析错误：

CTRL+S 是把单字符大小写折叠后查出来的唯一一处同键同修饰键重复。引擎侧怎么裁决、EXCLUSIVE 在这种场合起不起作用，没逆。

4.4 w / s / a：WASD 的三条路障 ​

表里第 17、12、7 行：

64 条里没有一条 KEY 是 d。TL2 原生没有 WASD 移动——移动是左键 Move/Attack（§1）。任何「加 WASD」的 MOD 都得先把这三条挪开，其中 a 那条是隐藏绑定，界面上看不见，容易漏。

4.5 EXCLUSIVE / HIDDEN 的取值规则：仅判定首字符 ​

TL2 将配置字符串转换为布尔值的规则为：字符串非空且首字符 ∉ {F, f, 0} 时均判定为真。因此在 MOD 数据中即使书写 EXCLUSIVE:no 或 HIDDEN:off，引擎在底层均解释为 true。若需显式声明为假，必须使用 false、F 或 0 开头。

5. 未闭环与已知偏差清单 ​

下表列出逆向分析中明确保留的未决项，以及独立运行时（复刻侧）实测发现的边界差异：

附录 A：虚地址与字节锚点表（Torchlight2.exe，ImageBase 0x400000） ​

附录 B：材料来源 ​

• 真值账本 truth/ledger.jsonl：C-0172（must-exact / O0 / guarded），本文的主干。
• 证据 JSON 原版游戏分析/reversed_cpp/REGISTRY/attack_trigger_semantics.json：调用链、分叉、字节锚点、攻击距离公式、复刻侧实测与未闭环清单。
• 键位工具 tools/f2_keybinds.py：三份 KEYMAPPING DAT 的解析口径、冲突报告、bool 首字符规则、project.godot [input] 段生成。
• 键位数据 build/f2/keybinds.json：64 条绑定原始串与普查数字（§4 全表的来源）。
• 引擎数据 MEDIA/KEYMAPPING/{KEYBIND,QUICKKEYS,HELPERBINDINGS}.DAT：第二 oracle。