【补丁】兽耳助手「星之迹-级」AI 不使用闪现 —— 模块舰船修复补丁

镜影若滴

【补丁】兽耳助手「星之迹-级」AI 不使用闪现 —— 模块舰船修复

本补丁已获得兽耳助手作者许可后发布。只修这一艘船，不改原版 辐射(displacer)，也不改动兽耳助手本身的任何文件。

一、发现的问题现象

「星之迹-级」玩家手操时使用闪现正常，但交给 AI（军官 / 无人 / 自动驾驶）后无论什么情况整场一次都不会用：
战术系统充能次数充足、冷却完毕、幅能充足，但它就是不用，只会硬对炮，就好像"闪现"战术系统它不存在似的。同场的原版单舰 辐射(Radiant)（同样是闪现）AI 操作正常

Deepseek插嘴1

→ 不是「AI 不会用闪现」，而是这艘模块化舰船的激活判定必然失败。

二、根因（已由伽马AI核心(Deepseek)定位到具体机制）


根因粗略的讲就是模块船自己的模块遮挡了闪现的落点判定导致的。神秘的闪现判定。

Deepseek为你慢慢解释中1

原版 displacer 的 aiType: PHASE_DISPLACER 对应引擎类 com.fs.starfarer.combat.ai.system.voidsuper。 它在激活前要做一次落点净空判定，遍历场上每一艘舰船（只跳过战机、穿梭舱、自身）： 判定①：落点到该船距离 < 该船碰撞半径 + 本舰碰撞半径 + 50 → 判为不净空，直接返回； 判定②：该船前方 30° 锥内含落点、且与本舰同属主 → 阈值再加 500。 这个循环没有排除本舰自己的模块。星之迹的 5 个模块是独立舰船实体，挂点全为 [0,0] （见 data/hulls/mimikko_kasutariri_radiant_1.ship 里 WS0008~WS0012 的 "type":"STATION_MODULE","locations":[0,0]）， 引擎会把模块摆在与本体同位置、同朝向： 项目 数值（均取自 mod 自身数据文件） 闪现落点距本体 range = 300 本体碰撞半径 200.5 5 个模块碰撞半径 165 / 159 / 179.5 / 154.5 / 181.5 判定①阈值 模块半径 + 200.5 + 50 = 405 ~ 432 300 < 405 → 判定①每次必然失败 → AI 每次评估都在这一步返回，永远到不了「激活系统」。 原版 Radiant 是单舰、没有模块，落点干净，所以正常。

三、本补丁怎么做

只给星之迹做一套不看友军遮挡的模块兼容版闪现：

Deepseek为你慢慢解释中2

数值与原版 displacer 逐字段相同（射程 / 充能 / 冷却 / 音效 / jitter…）， aiType 改成 CUSTOM 并挂上本补丁的 AI；AI 复刻原版判定（0.25–0.5s 评估间隔、落点 = 本体 + range×行驶方向、 判定①②、赶路 / 撤退 / 规避 / 目标失能各路径），唯一实质差异 = 落点净空判定不再把同属主（友军）舰船算作障碍——其中就包括本舰自身的全部模块。 玩家手操、其它舰船、原版 displacer 一律不受影响； 系统 id 通过公开 API ShipHullSpecAPI.setShipSystemId() 在所有规格载入完成后落地（与 mod 加载顺序无关）， 系统 id 由公开 API 在启动时设置（主路径，与加载顺序无关）；另带 ship_data.csv 覆盖行作备用，隐藏船插保留未挂载。

四、安装

• 直接前置：兽耳助手！。本补丁只直接依赖兽耳助手；它自身还依赖什么（LazyLib / MagicLib / GraphicsLib / BoxUtil 等）请按其说明书安装，本补丁不做依赖传递。
• 下载该模组压缩包把压缩包放进 mods/文件夹中解压。
  

五、验证

• Deepseek插嘴2

  starsector.log 里应出现： [onApplicationLoad] mimikko_kasutariri_radiant_1 ship system: <改前> -> mimikko_kasutariri_radiant_displacer 复制代码

• 装配界面看星之迹的战术系统名应为「闪现（模块兼容）」（仍显示「闪现」= 未生效）
  

六、兼容性 / 注意

• 测试环境：游戏 0.98a-RC8 + 兽耳助手 0.761（Linux / OpenJDK 25）
• 本补丁只动这一艘船的系统，不改写兽耳助手的文件；卸载（移除 mod 或删目录）即完全恢复原版行为；
• 本补丁代码以 MIT 许可证开源（仓库见发布页）；发布已获兽耳助手作者许可；
• Deepseek插嘴3

  若你同时装了「修原版闪现」的其它补丁，两者可能都改这艘船的系统：系统 id 由 onApplicationLoad 设置（后加载者覆盖），而 ship_data.csv 覆盖行是「先处理者生效」。

  
  

七、许可

• 感谢兽耳助手作者许可补丁发布
  

授权图1