空间站扫描仪

空间站扫描仪

https://www.nexusmods.com/x4foundations/mods/496
（原名：报告扫描需求）
作者：kuertee

更新日志
=======
v8.0.3.1，2025年11月11日：
- 新功能：由 DanOfStarfleet 添加的法语本地化。

模组效果
===========
- 使用飞船扫描仪时，会锁定需要太空服扫描仪扫描的模块。
- 使用太空服扫描仪时，会锁定最近的未完成扫描的模块。跟随这个锁定轨迹来扫描空间站。

前置需求
============
SirNukes Mod Support APIs 模组 (https://www.nexusmods.com/x4foundations/mods/503)
Kuertee's UI Extensions 模组 (https://www.nexusmods.com/x4foundations/mods/552)

推荐配套模组
==========================
以下是我所有的生活品质模组。所有这些模组的任务都列在“引导任务”选项卡中。使用我的模组 UI Extensions (https://www.nexusmods.com/x4foundations/mods/552) 来启用“引导任务”中的“设置为激活”和“设置为非激活”按钮。否则，你将无法手动切换它们。
- 打捞采矿 (https://www.nexusmods.com/x4foundations/mods/511)：在玩家采矿过程中，手动锁定战利品会激活锁定AI，锁定所有相同类型的其他战利品。在破坏一个可开采的小行星后，会自动锁定最近的、含有相同战利品的可开采小行星。
- 飞船扫描仪 (https://www.nexusmods.com/x4foundations/mods/591)：飞船扫描仪是一种锁定AI，在完成一次飞船扫描后，会持续锁定未扫描的飞船，直到你周围的所有飞船都被扫描完毕。
- 信号泄漏猎手 - 递增范围 (https://www.nexusmods.com/x4foundations/mods/498)：在递增范围内扫描并锁定信号泄漏和/或维修面板。
- 空间站扫描仪 (https://www.nexusmods.com/x4foundations/mods/496)：使用飞船扫描仪时，会锁定需要太空服扫描仪扫描的模块。使用太空服扫描仪时，会锁定最近的未完成扫描的模块。跟随这个锁定轨迹来扫描空间站。
- 表面元件锁定 (https://www.nexusmods.com/x4foundations/mods/710)：在最后一个表面元件被摧毁后，自动锁定下一个表面元件。查找所有相同类型的表面元件。
- 部署用航点场 (https://www.nexusmods.com/x4foundations/mods/585)：创建你和你的僚机可以跟随的航点，以到达部署设备和武器。

第三方模组兼容性
===========================
使用以下代码来禁用模组的任务在启用扫描模式时自动激活：
<cue name="DisableStationScanMissionAutoActivate">
<conditions>
<event_cue_signalled cue="md.Setup.GameStart" />
<event_game_loaded />
</conditions>
<cues>
<cue name="DisableCrime_interval" instantiate="true" checkinterval="5s">
<actions>
<do_if value="@md.kuertee_station_scanner.DisableMissionAutoActivate.exists">
<run_actions ref="md.kuertee_station_scanner.DisableMissionAutoActivate" />
<reset_cue cue="parent" /><!-- 为下一次 event_game_loaded 准备 DisableCrime 并完全清除此间隔 -->
</do_if>
<cancel_cue cue="this" /><!-- 清除此间隔实例 -->
</actions>
</cue>
</cues>
</cue>

使用以下代码重新启用模组的任务在启用扫描模式时自动激活：
<run_actions ref="md.kuertee_station_scanner.EnableMissionAutoActivate" />

模组工作原理
=================
- 在扫描仪激活时激活。
- 会为扫描创建一个引导任务，并会列在“引导任务”选项卡中。它会附着在一个相关的、活跃的扫描任务上。当原始附着任务完成时，引导任务也会完成。
- 当空间站扫描率达到100%时，任务也会完成。
- 当你飞离空间站时，任务会被中止。
- 已扫描模块的扫描等级要求会通过通知报告：“扫描等级：X，需要：Y。”
- 会锁定需要更深度扫描的模块。
- 使用太空服扫描仪时，每次成功扫描后，会锁定下一个需要扫描的最近模块。
- 未扫描的模块会以亮红色高亮显示。
- 当任务完成或中止时，会自动激活“信号泄漏猎手 - 递增范围”（我的另一个模组）。

如何完整扫描空间站和信号泄漏
====================================================
(https://www.nexusmods.com/x4foundations/articles/46)
使用两个模组扫描空间站的工作流程：
信号泄漏猎手 - 递增范围：https://www.nexusmods.com/x4foundations/mods/498
空间站扫描仪：https://www.nexusmods.com/x4foundations/mods/496

- 激活飞船扫描仪。在信号泄漏猎手任务激活时，绕着空间站飞行，寻找信号泄漏，并扫描未发现的模块。
- 暂时留着飞船无法到达的信号泄漏。待在飞船里，继续寻找信号泄漏并扫描未发现的模块。
- 你可以随时在信号泄漏猎手任务和空间站扫描仪任务之间切换，以查看锁定的信号泄漏和锁定的模块。对于这个工作流程，在你继续寻找信号泄漏和扫描未发现模块之前，先切换到信号泄漏猎手任务。
- 当所有可能的信号泄漏都被发现并扫描，所有未发现的模块都被扫描后，离开飞船进行太空行走。
- 激活太空服扫描仪。太空行走并扫描之前飞船无法到达的、剩余的信号泄漏。
- 当绝对所有的信号泄漏都被发现并扫描后，空间站扫描仪任务会自动激活，显示所有其检测到需要太空服扫描仪扫描的模块。
- 太空行走至这些模块进行扫描。每完成一次扫描，空间站扫描仪会检测并锁定最近的未完成扫描的模块。跟随这个锁定轨迹，直到空间站扫描仪不再检测到未完成的模块。
- 此时，空间站扫描率达到100%，并且其所有信号泄漏都已被发现。

来自X4手册的回顾
==========================
(https://www.egosoft.com:8444/confluence/display/X4WIKI/Ships+And+The+Playership#ShipsAndThePlayership-ShipModes)
- “非常靠近一个空间站模块可以被动地获取关于它的信息。”
- “获取的信息量与所装备的扫描仪类型成正比（基础扫描仪 < 警察扫描仪 < 太空服扫描仪 < 升级版太空服扫描仪）。”

这两点意味着什么
==========================
飞过一个模块就可以扫描它。请注意，当扫描仪激活时，未发现的模块会被高亮显示。

有几个扫描等级，某些模块需要特定的扫描等级：
基础飞船扫描仪 = 扫描等级 0
警察飞船扫描仪 = 扫描等级 1
太空服扫描仪 = 扫描等级 2
升级版太空服扫描仪 = 扫描等级 3

不幸的是，即使未发现的模块仅被部分扫描，它们的高亮显示也会被移除——无论它们是否需要太空服扫描仪。这使得识别需要太空服扫描仪的模块变得困难。

安装
=======
- 解压到 'X4 Foundations/extensions/kuertee_station_scanner/'。

卸载
=========
- 删除模组文件夹。

故障排除
===============
1. 通过在启动参数中添加 "-debug all -logfile debug.log"，让游戏将事件记录到文本文件。
2. 如果扩展选项中有该模组的条目，请启用模组特定的调试日志。
3. 游戏足够长的时间让模组记录其事件。或者强制触发你遇到的错误。
4. 将位于 My Documents\Egosoft\X4(你的玩家特定编号)\debug.log 的日志文件发送到我的邮箱 (kuertee@gmail.com)，邮件主题行注明模组名称。

致谢
=======
Kuertee。
中文本地化由 Tiomer 完成。
法语本地化由 Calvitix、DanOfStarfleet 完成。
俄语本地化由 Alex5Not 完成。

历史版本
=======
v8.0.1.0，2025年9月28日：
- 新功能：Alex5Not 的俄语本地化。
- Bug修复：语言文件可能对某些不使用英文文本的玩家破损。

v8.0.0.8，2025年9月11日：
- 来自测试版的更改日志：
- 调整：8.0 兼容性。

v8.0.0.2，2025年7月22日：
- 调整：与基本游戏 8.0 热修复2测试版的兼容性。

v7.5.07，2025年3月29日：
- Bug修复：模组特定的调试日志可能在上次更新后未关闭。如果未在模组的扩展选项中手动禁用，此更新将禁用它。

v7.5.01，2025年2月21日：
- Bug修复：7.5 兼容性更新。
- Bug修复：未扫描的模块没有显示为红色。感谢 Fihnakis（来自Nexus Mods）！

v7.1.00，2024年7月3日：
- Bug修复：在 lua 中，将已废弃的 GetSoftTarget 的使用改为 GetSoftTarget2。

v7.0.02，2024年6月29日：
- 调整：7.00 hf 1 兼容性。
- 维护更新：使用 UI Extensions 的新方法来加载模组特定的 UIX lua 文件。

v6.0.002，2023年4月13日：
- 调整：版本号更新以与我其他模组保持一致。自上一版本以来没有内部更改。

v4.1.0，2021年11月6日：
- 调整：仅当此任务激活时，来自此模组的任务通知才会显示在左侧控制台窗口中。

v2.0.2，2021年7月11日：
- Bug修复：任务没有自动激活，这是上一个版本引入的错误。

v2.0.1，2021年7月3日：
- 兼容性：第三方模组可以禁用此模组的任务在启用扫描模式时自动激活。请参阅下面的“第三方模组兼容性”部分。

v2.0.0，2021年3月11日：
- 新功能：为基本游戏 v4.0.0 beta 11 更新。
- 调整：清理了不必要的本地化文件。重写了 content.xml 清单文件。

v1.2.7，2020年12月17日：
- Bug修复：引导任务错误：“设置为激活”和“设置为非激活”按钮现在可用。所需的 UI Extensions 文件 kuertee_menu_map.lua 没有被加载。它在我环境中能工作是因为我有其他模组加载了该文件。
- Bug修复：将 X4 扫描任务附加到“扫描空间站”任务有时仍然失败。

v1.2.6，2020年12月14日：
- Bug修复：附加 X4 扫描任务有时失败。

v1.2.5，2020年12月8日：
- 新功能：模组的任务现在列在“引导任务”选项卡中，使你的剧情任务免受我的各种模组创建的辅助任务的干扰。我建议使用我的 Ui Extensions 模组 (https://www.nexusmods.com/x4foundations/mods/552)。没有这个模组，你将无法在“引导”选项卡中列出的任务之间切换。
- 新功能：引导任务列在“引导任务”选项卡中。它会附着在一个相关的、活跃的扫描任务上。当原始附着任务完成时，引导任务也会完成。
- 调整：更好的任务和目标描述，以配合我的其他辅助模组：打捞采矿、飞船扫描仪、信号泄漏猎手 - 递增范围、以及部署用航点场。

如何从先前版本更新
====================================
在安装此版本之前，对先前版本执行一次干净保存。

执行干净保存的步骤：
1. 从文件系统中删除先前版本。
2. 加载一个游戏。保存游戏。这是干净保存文件。它不包含先前版本的数据。
3. 安装新版本。
4. 从干净保存文件加载并继续游戏。

v1.2.4，2020年11月2日：
- 调整：如果你有一个活跃的目标（即不是任务目标，而是白色软目标），任务不会激活，以获得更好的用户体验。

v1.2.3，2020年8月28日：
- Bug修复：在之前的版本中，任务有时会过早终止——即使你还有更多组件需要扫描。
- 与任务简报屏幕的集成更清洁。在之前的版本中有点笨拙。

从先前版本更新
================================
在安装此版本之前，对先前版本执行一次干净保存。
如何执行干净保存：
1. 从文件系统中删除先前版本。
2. 加载一个游戏。
3. 保存游戏。这是干净保存。安装新版本后加载此存档。

v1.2.2，2020年7月23日：
- 调整：如果另一个扫描目标活跃，则扫描任务不会自动激活。

v1.2.1，2020年6月6日：
- Bug修复：当扫描仪被激活但附近没有空间站时，任务会被创建并立即移除。
- 调整：确保 Init cue 处于等待状态。
- 调整：清理了 cue 实例化。

v1.2.0，2020年5月23日：
- Bug修复：在之前的版本中，对话后也会创建扫描任务。
- 调整：进行太空行走时，仅锁定最近的未完成扫描的模块。与之前版本中飞船扫描仪检测到的模块也被锁定相比，这更明显地是一个“锁定轨迹”。
- 调整：在某些情况下，可能无法将空间站扫描到100%。在这些情况下，当没有检测到进一步的未完成模块时，任务结束。在之前的版本中，任务仅在空间站扫描率达到100%时结束。

v1.1.0，2020年5月15日：
- 为扫描创建了任务日志。
- 当空间站扫描率达到100%时，任务完成。
- 当你飞离空间站时，任务被中止。
- 会锁定需要更深度扫描的模块。
- 使用太空服扫描仪时，每次成功扫描后，会锁定下一个需要扫描的最近模块。
- 当任务完成或中止时，会自动激活“信号泄漏猎手 - 递增范围”（我的另一个模组）。

v1.0.0，2020年5月12日：首次发布。