[AI]武器绑定与材质自发光

0.12.0 时的状态说明，现用补丁版本见正文：

**截至 2026-09-09：**兵种 mod 为 0.12.0，已安装十四种墓园兵种。本文数字保留各次交付版本的含义；最新进展见黑暗骑士与骨龙动画。

**截至 2026-09-09：**兵种 mod 为 0.11.1，已安装十种墓园兵种。本文涉及的安装数字按各次交付版本注明；最近一次扩展见吸血鬼与蝙蝠形态。

2026-09-09 工具迁移： 后续代码在 h3-art-pipeline 维护，原 tools/creature-art/ 与 tools/town-art/ 对应新仓库的 creature-art/ 与 town-art/。本文的旧路径和 PR 链接保留作历史记录。迁移与复现说明。

2026-09-09 更新： 本文的图片、姿势和测量保留为当时试稿，不能视为当前游戏版本。后续替换见完整动画，当前八兵种安装状态见尸巫交付。

上一篇说剑已经绑到手上了。其实绑错了东西： 那套判据在一个模型上找到的是剑，换个模型找到的是手臂骨。剑照样出现在每一帧里， 只是竖着挂在腿边像根拐杖，所以没有任何检查报警。

画面发灰，但不是灯的问题

先说材质。渲染出来的帧比原版素材灰一大截：亮度的 5% 到 95% 分位跨度只有 83， 原版是 169。

我试着把场景里所有灯都关掉。画面几乎没变。没有灯的场景应该是全黑的，也就是说模型 在自己发光，但我当时把这个结果当成环境光太强，接着去调灯。

其实是两件事叠在一起。Meshy 导出的 glTF 把基础色贴图接到了 Emission，强度 1， 金属度也是 1，模型自带发光。而 Blender 默认的 view transform 是 AgX，一条 压高光的电影曲线——拍照片合适，压到 79 像素的素材上就不合适。

两个都改掉：

导入时 sanitise_materials() 会断开 emission 连线、把强度归零，金属度设 0、 粗糙度设 0.65。

之前找到的是肱骨

上一版的做法是：找手能握住、并且离手关节最远的那个连通块。在写它的那个模型上， 这条规则找到 474 个顶点、伸出 0.90，确实是剑。

换到新模型，它找到的是一个 604 顶点的块，z 从 0.80 到 1.38，而手在 z 0.94—— 这是从手往上长的。手臂骨比露在外面的剑身还长，起点又离关节更近，所以肱骨赢了。

按"离最近骨头多远"来分也不行。我试过：肋骨离脊椎的距离比剑离腿还远。

真正能分开的是权重

Meshy 把剑的权重拆给了 LeftHand 35% 和 LeftFoot 43%。握把跟着拳头走， 剑尖跟着脚趾走，腿一动剑身就被拉长——拐杖就是这么来的。

身体上任何一块真实的部位，影响它的骨头在骨架里都是挨着的：股骨是髋和膝，隔一跳； 肋骨是两节脊椎，隔三跳。只有握在手里、横在身前的刚体，才会同时吃到两条不同肢链上 的骨头。

在整个 mesh 上按父子关系图量一遍：

• 五个连通块隔 10 跳，一共 1374 个顶点，全是剑
• 剩下 173 个块最多 3 跳

不用调阈值。rebind_weapon() 现在取每个连通块权重最高的两根骨头，量它们之间的跳数， 超过 5 跳就整块重绑到这两根里属于手的那根上。

剑在左手

剑终于跟着手腕走之后，攻击动作还是碰不到它：poses.py 里每个动作摆的都是 RightArm，而这个骷髅是左撇子。现在重绑会返回它把武器挪到了哪只手，是左手就把整套 姿势镜像过去——骨头名字左右对调，每个旋转的 Y、Z 分量取反。这正是站姿里两只胳膊本来 就写好的对应关系。

挥砍的符号是反的

跟反关节膝盖是同一类坑，换了个地方。剑是顺着手骨自身 的轴伸出去的，等于小臂的延长线，手腕没法单独瞄它。所以剑指向哪由站姿决定，而上臂 骨上 X 取负才是往前送，取正是往身后甩。

所有挥砍关键帧写的都是正的。骷髅一直在往后砍。

这次没再猜。我扫了上臂、小臂、脊椎的角度，量剑尖实际落在哪，再照表设关键帧。三个攻击 动作的剑尖高度：

待机时剑尖停在 0.4，剑身横在小腿前面，和原版收剑的位置一样。之前那个站姿是把剑挂在 胯侧，还挂在背朝的那一边。

两只手没有换位

挥武器的时候，身体是这样的：抬手蓄力时持剑手在后、空手在前，砍出去之后两只手换过来。 以胯为原点量一下：

空手在每一组攻击的每一帧上都停在 +0.33，因为关键帧里根本没写它，别的都在动， 只有它留在站姿里。

持剑手也得改，而这个数字差点把我骗过去。抬起时 +0.03，空手 +0.39，看着就是 “持剑手在后”。其实不是。抬手臂是把手往上带，不是往后带——整条胳膊从胸前往上 伸出去，剑尖已经指着它接下来要挥的方向。数字是真的，我从它推出来的结论是错的。

光靠肩膀解决不了，而且把肩膀往后甩之后更糟：手是到胯后面去了，但剑再也举不高—— ATTACK_FRONT 的高度从 79–103 塌到 79–81，原版是 69–108。剪影里根本没有 “举剑"这个动作了。

又后又高，靠的是肘，不是肩。上臂抬起来、肘部折死，手绕到头后面去，手腕再把剑 翻过来——剑是跟着小臂走的，不动手腕的话，胳膊甩得再靠后剑还是朝前。

这次没有再猜第四遍，而是定目标解：在肩、肘、腕的角度上做网格搜索，按"手在胯后、 剑尖在后上方"打分取最小误差。解了两轮——第一轮的目标只要求手在后、没要求剑尖高， 解出来的就是上面那个塌掉的版本。现在峰值 121–129，原版 108–119，是高出来而不是 压平。

空手用的符号规则和持剑手一样：上臂 X 取负手往前，-30° 是 +0.46，+60° 是 -0.21。 加上反向摆臂之后，抬起时空手领先持剑手 0.30 到 0.46，命中时落后 0.21 到 0.52， 三组攻击都是。

ATTACK_UP 要给得比另外两组更多。上撩这一下持剑手本来就送不远，给到 +30 的时候两只手 还在同一个深度上；给到 +48 才分得开。

姿势的形状不对

剑弄好之后，才终于能把我们的帧和原版当成形状来比。.def 每一帧都存了自己的内容框， 所以原版的尺寸能直接读出来。写成数字之后，三组动作的问题一目了然。

**待机是根柱子。**两条腿并着，膝盖基本没弯，看着像立正而不是准备打架。把腿张开、 两边膝盖压下去，宽度到 40。

格挡整个反了。原版的格挡是它最高、也是最窄的姿势之一——剑竖在身前。 我们是把剑甩到侧面，然后蹲下去，结果比自己的待机还宽、还矮。把胳膊抬起来、 肘部死死折住，剑身抬到水平线上 68°。

**走路站得太直。**原版是弓着身子往前爬的：躯干前倾，头探在胯前面，剑平举着而不是 垂着。站直了渲出来又窄又高——侧视图里脊椎立起来就是这个效果。

僵尸的脚现在单独钉住，不跟着骷髅一起变；拖着走的步子不该摆同一个架势。

走路那组一开始改过头了。前倾量给到两倍的时候，躯干直接对折，剑甩到身前，宽度冲到 73–91。表里的数是两次测量的中点。

标定标错了帧

走路的高度一直压不下来，问题出在相机，不在姿势。之前每次渲染都拿当前这组动作去标定 相机——先渲一张探针帧，量 alpha 包围盒，反复修正到人物 79 像素高。对单组是对的， 对十三组就是错的：它把每一组的第一帧都强行拉成 79。

原版不是这样。它走路 71–76，格挡 82–109，而待机是 80——移动时压低身子，格挡时往上够。 每组都缩放到固定高度，这两个动作的特征就都被抹平了。

改成只用待机帧标定一次，所有动作共用这台相机：

宽度上走路还差着：41–53 对 54–72。不是步幅的问题——把腿的摆动幅度加大 45%，剪影只 动了一个像素，因为在这个机位下步幅几乎是正对着镜头的。原版的宽度来自剑平举，不是 垂着。

我一开始把这条判成做不到，理由是剑顺着小臂焊死。剑还挂在脚上的时候这话是对的， 现在不对了：重绑之后手骨对剑是满权重，手腕可以直接瞄——-70° 能把剑抬到水平线上 3°，不转就是 -68°。用肩膀去够同一个角度的话，整个剪影会甩到 64–81 宽、掉到 59 高。

修好一个东西，把我还在拿来推理的那条约束一起解除了。

机位

英雄无敌 3 的兵是朝右的四分之三视角。我一直用方位角 0 渲染，正对镜头，挥砍全被透视 压没了。现在默认改成 -40°。模型和姿势都没动，弧线出来了。

代码在 PR #10，材质修复、按跳数重绑、 姿势镜像、挥砍关键帧都在里面。

叠在同一个站姿上的增量

poses.py 里每一组动作都是相对同一个战斗站姿的增量。这样十三组动作里的角色是 同一个人,但只要站姿本身已经在做这组动作需要替换掉的事,增量就是错的单位。

走路把这点暴露了。站姿里有个大跨步,走路周期又在上面摆一次腿,两者叠加成 126° 的 劈叉,骷髅在原地劈腿而不是走路。改成把走路的腿写成绝对角、再减掉站姿,两者就解耦 了——47°。

更麻烦的是站姿在持剑臂上带了 100° 内旋(那是为了让剑留在自己那一侧)。叠在上面的 任何增量,它的"往前"都被转歪了这么多,于是正面攻击的挥出帧,剑在整整五帧里都是斜 垂着的,而原版是平着捅出去。怎么调增量都修不好;改成解绝对角、存 绝对角 − 站姿, 一次就对了。

在想明白这点之前,我一晚上改了五次站姿。每次都是修好一处、坏掉另一处:把剑挪回自己 那侧,待机宽了 8 像素;把宽度压回去,攻击又够不着了。

角度是因,位置才是能对照的东西

走路时头埋进胸腔,我调了三轮颈椎角度,一轮比一轮糟。颈椎骨是朝上的,转它是让 颅骨绕关节往前下方画弧,不是抬起:

单调的。而我那次"修复"是把它从 −14 调到 +18——朝错误方向又走了一步。

真正找出来靠的不是再试一个角度,而是量颅骨这块几何的底部相对胸腔顶部的高度, 再和待机帧比——待机是 +0.10,看着就是对的;走路只有 +0.02,头就坐在肋骨上。角度只能 和另一个同样是猜的角度比,位置可以和一张已经对了的帧比。

没转起来的转身

TURN_L/R 只有两帧:角色从四分之三视角转过来正对镜头。我们的根本没转 —— 宽 48–58 对原版 38–39,高 80–81 对 82–108,因为身体一动没动。

关键帧转的是胯骨的 Z 轴。以"正对镜头"为基准量:站姿在 −40.7°,旧关键帧把它带到 −78.8° —— 是在把角色转得更背对镜头。

于是我改用 Y(绕骨头自身轴的滚转)。数字漂亮得很:+60 落在 +6.1°,基本正对镜头。 渲出来骷髅侧翻躺在地上。

我那个指标是"肩线在水平面上的投影”,而摔倒的身体肩线也会转,它分不开转身和摔倒。 这已经是这篇文章里第三次"数字是真的、从它推出的结论是错的",而且每次的形状一样: 这个数描述的东西,比我真正关心的东西窄。

骨头的坐标轴不是世界的坐标轴。转身是整个模型绕世界垂直轴的旋转,属于动作本身, 不属于任何一根骨头。现在动作可以带一个 yaw 字段,由渲染器去转 armature 对象。 结果 41–47 × 80–105、剑竖起来,对原版 38–39 × 82–108。

代码在 PR #10。