三层开火判定与那批 bug:朝向、距离、停靠 | 杨元超的世界

读者是谁

这篇写给被单位开火判定坑过、或正在实现瞄准/射程/停靠的开发者;下面这张表按角色列出你能带走什么、从哪节开始读。

读者 带走什么 拿它做什么 从哪节开始读
被开火判定坑过的人 五个 bug 的现象→原因→修法→为什么能修好 对自己的问题对号入座 2 → 5
做瞄准/射程的人 朝向/距离/停靠三层口径表 把三处判定收口到同一个函数 3 → 4
排查「射程内却不打」的人 六步排查清单 按顺序逐项排除 6

只做纯渲染、不写单位行为的读者不必读。

0 本文讲什么

这篇只讲一件事:开火判定上线时踩过的那批 bug。先把「三层判定」定义清楚,再逐个讲五个真实问题(现象、原因、修法、为什么这样能修好),最后给一份「射程内却不打」的排查顺序。层级设计本身不在这里展开,只需要知道一句:只有三级模型(车体 → 炮塔 → 炮管)能取到可独立旋转的炮塔与炮管。先看概览:

小节 讲什么 读它能得到什么
1 三层判定分别是什么 一张判定分层图
2 朝向:本地关节轴与标定时机 一个必须先做的标定顺序
3 距离:射程系数与目标准则 一张按目标种类的口径表
4 停靠:能不能停下来打 「能打到」与「能停下」的区别
5 五个真 bug 的坑表 对号入座的修法
6 排查清单与下一步 一份可照着走的顺序

1 三层判定:先定义,再看 bug

三层是三个独立问题,不要混在一起调:

三层最后收口到同一个函数(下面这段 10 行是完整顺序,伪代码):

function canAttack(unit, target) {
  const axis = unit.localAxis                     // 朝向:本地关节轴
  const dir = target.pos.clone().sub(unit.pos)
  if (!aimAligned(unit, dir, axis)) return false  // 偏航/俯仰是否收敛
  const range = unit.range * factorFor(target)    // 距离:按目标种类乘系数
  if (dir.length() > range) return false
  if (!unit.isCanMove(target.pos)) return false   // 停靠:能不能停下来打
  return true
}

1.1 需要准备什么

本地复现需要 Node 18 与项目依赖(仓库根目录执行 npm install);判定函数是纯函数,可以直接在 Node 里跑。

2 朝向:轴必须在出生姿态下标定

现象:落地后炮塔绕歪轴转,水平残差怎么都收不住,开火方向偏得离谱。

为什么:轴的标定用了「第一次开火时」的世界矩阵,而那一刻单位正被拿在手上,世界旋转不是出生姿态;倾斜被永久冻进轴里。炮塔随后落地旋转,围绕的却是那根带倾斜的轴。

怎么修:把标定抽成独立函数,建表时强制用出生姿态;落地、放下、重新装备时再重标一次,且只改轴、不动炮塔和炮管的局部矩阵(否则会视觉跳变)。下面这段是标定代码(3 行),关键是调用时机:

// R_bodyBirth 是出生姿态的世界矩阵,转置后把世界轴拉回本地
const axisLocal = R_bodyBirth.transpose().multiply(worldUp)
// 省略:worldUp 是该关节期望的世界轴(炮塔取竖直轴)

为什么能修好:轴只与出生姿态有关,与被拾取状态解耦;姿态变化后重标,旧轴不会残留。

3 距离:射程系数与口径收口

现象:明明在射程内却不打;或者对着巨大娘时提前停火。

为什么:距离口径散落在选目标、保持距离、能否攻击、移动停靠四处,改一处另一处不跟;目标种类不同,量的位置也不同(巨大娘量到表面,小人与普通物体量到中心)。

怎么修:基础射程 computeRemoteDistance(emitterLife, emitterSpeed),目标种类只改系数。下面这张表是三类目标的距离口径:

目标 距离怎么量 系数
巨大娘(巨型敌人) 量到表面:距离减目标最小尺寸 1
小人(小型敌人) 量到中心 0.6
普通物体 量到中心 1

下面这段是距离判定(4 行):

const [targetDistance, minTargetDistance] = computeRemoteDistance(emitterLife, emitterSpeed)
const factor = isLittleMan ? 0.6 : 1
const distance = isGiantess ? pos.distanceTo(targetPos) - minSize : pos.distanceTo(targetPos)
const canFire = distance <= targetDistance * factor

为什么能修好:所有调用读同一份口径,改一处等于全改;目标种类的差异被收敛成系数与「量到表面/中心」两个分支。

4 停靠:能打到 ≠ 能停下打

现象:在射程内、朝向也对,但单位一直走、不开火。

为什么:「能打到」和「能不能停下来打」是两个距离。停靠判定其实返回两个值——能不能打到、以及能不能移动过去;后者比的是高度差:|目标.y − 自己.y| ≤ 1,因为单位只能在同一平面上走。三种目标的取值还不一样(下表):

目标 可移动性怎么取 为什么
巨大娘 直接置为「可以移动」 她站在单位脚下那片地形平面上,且射程按表面算(距离减去目标最小尺寸),不需要走到某个高度就能开火
小人 真去比高度差 小人可能站在台阶或斜坡上,高差超过 1 就走不过去
普通物体 真去比高度差 物体可能摆在不同高度(桌上、箱子上)
建筑 直接置为「可以移动」 建筑占地大,单位总能在它脚下的平面上找到射击位置

所以「停靠」不等于「射程」:射程够了但高差太大时,单位会一直找能停下的点、始终不开火——这就是「明明在射程内却不打」的一个来源。

怎么修:把停靠判断并进同一个 canAttack(见第 1 节的函数),不要在移动逻辑里另写一份。

为什么能修好:判定只有一个入口,停靠与射程不会各算各的。

5 五个真 bug 的坑表

下面按「是什么 → 为什么是坑 → 怎么解决 → 为什么能解决」排:

坑是什么 为什么是坑 如何解决 为什么能解决
在手持姿态首次标定轴 倾斜被冻进轴,落地后炮塔绕歪轴 标定强制用出生姿态,姿态变化后重标 轴只与出生姿态有关
两根炮管合并成一个网格 挂多个 tween(补间动画)互相覆盖,只有一个炮管动 tween 只挂 WeaponPart 一层,幅度按实际长度 同层只有一个动画写同一属性
靶子摆在原点 瞄准点与炮口方向相反,残差接近 180°,几十帧转不过去 靶子摆在真实目标点上 瞄准方向与真实目标一致
距离口径散落四处 改一处另一处不跟,射程内却不打 收口到一个判定函数 所有调用读同一份口径
停靠判断写在移动逻辑里 移动与攻击各算各的,停不下来就不打 停靠并进同一个 canAttack 判定只有一个入口

6 排查清单与下一步

「射程内却不打」按这个顺序查(从前到后,能省掉大部分瞎试):

  1. 朝向:轴是不是在出生姿态下标定的,落地后有没有重标;
  2. 朝向:偏航残差是否真的收敛(打印残差,不要凭眼睛看);
  3. 距离:目标种类取的系数对不对(小人 0.6、普通 1);
  4. 距离:巨大娘是否按「量到表面」算;
  5. 停靠:_isCanMove 是否返回 false(该停的地方能不能停);
  6. 表现:炮管 tween 是否挂在 WeaponPart 这一层(双炮管不要挂两个)。

你下一步能做什么:先把这三层判定抄成一张表,逐项标出你项目里对应的函数名;再从「朝向」开始按第 6 节的顺序跑一遍,把「射程内却不打」压到某一个具体层级上。

这些内容来自哪里

这些内容来自一个真实项目里上线前后的一批同类缺陷:围绕朝向、距离与停靠三层,前后处理了十几处「看起来在射程内却不开火」的问题,每个都追到具体条件再修。文中的阈值与倍数都是当时实测的结果。

相关文章