这篇写给被单位开火判定坑过、或正在实现瞄准/射程/停靠的开发者;下面这张表按角色列出你能带走什么、从哪节开始读。
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 被开火判定坑过的人 | 五个 bug 的现象→原因→修法→为什么能修好 | 对自己的问题对号入座 | 2 → 5 |
| 做瞄准/射程的人 | 朝向/距离/停靠三层口径表 | 把三处判定收口到同一个函数 | 3 → 4 |
| 排查「射程内却不打」的人 | 六步排查清单 | 按顺序逐项排除 | 6 |
只做纯渲染、不写单位行为的读者不必读。
这篇只讲一件事:开火判定上线时踩过的那批 bug。先把「三层判定」定义清楚,再逐个讲五个真实问题(现象、原因、修法、为什么这样能修好),最后给一份「射程内却不打」的排查顺序。层级设计本身不在这里展开,只需要知道一句:只有三级模型(车体 → 炮塔 → 炮管)能取到可独立旋转的炮塔与炮管。先看概览:
| 小节 | 讲什么 | 读它能得到什么 |
|---|---|---|
| 1 | 三层判定分别是什么 | 一张判定分层图 |
| 2 | 朝向:本地关节轴与标定时机 | 一个必须先做的标定顺序 |
| 3 | 距离:射程系数与目标准则 | 一张按目标种类的口径表 |
| 4 | 停靠:能不能停下来打 | 「能打到」与「能停下」的区别 |
| 5 | 五个真 bug 的坑表 | 对号入座的修法 |
| 6 | 排查清单与下一步 | 一份可照着走的顺序 |
三层是三个独立问题,不要混在一起调:
三层最后收口到同一个函数(下面这段 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
}
本地复现需要 Node 18 与项目依赖(仓库根目录执行 npm install);判定函数是纯函数,可以直接在 Node 里跑。
现象:落地后炮塔绕歪轴转,水平残差怎么都收不住,开火方向偏得离谱。
为什么:轴的标定用了「第一次开火时」的世界矩阵,而那一刻单位正被拿在手上,世界旋转不是出生姿态;倾斜被永久冻进轴里。炮塔随后落地旋转,围绕的却是那根带倾斜的轴。
怎么修:把标定抽成独立函数,建表时强制用出生姿态;落地、放下、重新装备时再重标一次,且只改轴、不动炮塔和炮管的局部矩阵(否则会视觉跳变)。下面这段是标定代码(3 行),关键是调用时机:
// R_bodyBirth 是出生姿态的世界矩阵,转置后把世界轴拉回本地
const axisLocal = R_bodyBirth.transpose().multiply(worldUp)
// 省略:worldUp 是该关节期望的世界轴(炮塔取竖直轴)
为什么能修好:轴只与出生姿态有关,与被拾取状态解耦;姿态变化后重标,旧轴不会残留。
现象:明明在射程内却不打;或者对着巨大娘时提前停火。
为什么:距离口径散落在选目标、保持距离、能否攻击、移动停靠四处,改一处另一处不跟;目标种类不同,量的位置也不同(巨大娘量到表面,小人与普通物体量到中心)。
怎么修:基础射程 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
为什么能修好:所有调用读同一份口径,改一处等于全改;目标种类的差异被收敛成系数与「量到表面/中心」两个分支。
现象:在射程内、朝向也对,但单位一直走、不开火。
为什么:「能打到」和「能不能停下来打」是两个距离。停靠判定其实返回两个值——能不能打到、以及能不能移动过去;后者比的是高度差:|目标.y − 自己.y| ≤ 1,因为单位只能在同一平面上走。三种目标的取值还不一样(下表):
| 目标 | 可移动性怎么取 | 为什么 |
|---|---|---|
| 巨大娘 | 直接置为「可以移动」 | 她站在单位脚下那片地形平面上,且射程按表面算(距离减去目标最小尺寸),不需要走到某个高度就能开火 |
| 小人 | 真去比高度差 | 小人可能站在台阶或斜坡上,高差超过 1 就走不过去 |
| 普通物体 | 真去比高度差 | 物体可能摆在不同高度(桌上、箱子上) |
| 建筑 | 直接置为「可以移动」 | 建筑占地大,单位总能在它脚下的平面上找到射击位置 |
所以「停靠」不等于「射程」:射程够了但高差太大时,单位会一直找能停下的点、始终不开火——这就是「明明在射程内却不打」的一个来源。
怎么修:把停靠判断并进同一个 canAttack(见第 1 节的函数),不要在移动逻辑里另写一份。
为什么能修好:判定只有一个入口,停靠与射程不会各算各的。
下面按「是什么 → 为什么是坑 → 怎么解决 → 为什么能解决」排:
| 坑是什么 | 为什么是坑 | 如何解决 | 为什么能解决 |
|---|---|---|---|
| 在手持姿态首次标定轴 | 倾斜被冻进轴,落地后炮塔绕歪轴 | 标定强制用出生姿态,姿态变化后重标 | 轴只与出生姿态有关 |
| 两根炮管合并成一个网格 | 挂多个 tween(补间动画)互相覆盖,只有一个炮管动 | tween 只挂 WeaponPart 一层,幅度按实际长度 | 同层只有一个动画写同一属性 |
| 靶子摆在原点 | 瞄准点与炮口方向相反,残差接近 180°,几十帧转不过去 | 靶子摆在真实目标点上 | 瞄准方向与真实目标一致 |
| 距离口径散落四处 | 改一处另一处不跟,射程内却不打 | 收口到一个判定函数 | 所有调用读同一份口径 |
| 停靠判断写在移动逻辑里 | 移动与攻击各算各的,停不下来就不打 | 停靠并进同一个 canAttack | 判定只有一个入口 |
「射程内却不打」按这个顺序查(从前到后,能省掉大部分瞎试):
_isCanMove 是否返回 false(该停的地方能不能停);你下一步能做什么:先把这三层判定抄成一张表,逐项标出你项目里对应的函数名;再从「朝向」开始按第 6 节的顺序跑一遍,把「射程内却不打」压到某一个具体层级上。
这些内容来自一个真实项目里上线前后的一批同类缺陷:围绕朝向、距离与停靠三层,前后处理了十几处「看起来在射程内却不开火」的问题,每个都追到具体条件再修。文中的阈值与倍数都是当时实测的结果。