地表元素定位

表面元件瞄准

https://www.nexusmods.com/x4foundations/mods/710
作者：kuertee

## 更新日志
=======
v8.0.0.8，2025年9月11日：
- 调整：为8.0版本更新版本号。

## 模组效果
===========
在最后一个表面元件被摧毁后，自动瞄准下一个表面元件。"查找全部"互动：查找所有相同类型的表面元件。

## 前置需求
============
SirNukes 的 Mod 支持 API 模组 (https://www.nexusmods.com/x4foundations/mods/503)
Kuertee 的 UI 扩展模组 (https://www.nexusmods.com/x4foundations/mods/552)

## 任务目标
===============
当一个作为任务目标的表面元件被摧毁后，下一个最近的任务目标将被自动瞄准。请注意，此功能仅适用于使用"rml_destroy_components"任务指令的任务——原版游戏正是使用该指令来处理此类任务。不使用"rml_destroy_components"任务指令的任务（例如来自某个模组的自定义任务）则不受支持。

## "查找全部"互动
======================
当一个表面元件被瞄准时，使用互动菜单（F键）可以为所有相同类型的表面元件创建任务目标。当一个任务目标被摧毁后，下一个最近的任务目标将被自动瞄准。

与我其他的生活品质改进模组一样，创建的任务是一个导航任务。默认情况下，你只能拥有一个导航任务。如果有多个导航任务（例如来自其他模组），它们会列在导航任务标签页中，但你无法在它们之间切换。为了让导航任务标签页像普通任务一样工作（即"设为进行中"、"设为暂停"等），请安装我的另一个模组，UI 扩展 (https://www.nexusmods.com/x4foundations/mods/552)。

## 原版游戏 vs 本模组
=====================
在原版游戏中，你通过使用上一个/下一个表面元件键来瞄准表面元件。我将这些键映射到了 G 和 H。没有本模组时，一个表面元件被摧毁后，目标就会丢失，需要重新瞄准该舰船或空间站。并且需要从该舰船或空间站内部表面元件列表的开头重新开始瞄准。有了本模组，上一个表面元件被摧毁后，下一个表面元件会被自动瞄准，从而更容易定位表面元件。

## 推荐的配套模组
==========================
以下是我所有的生活品质改进模组。所有这些模组的任务都列在导航任务标签页中。使用我的模组，UI 扩展 (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)：创建你和你的僚机可以跟随的前往部署设备和武器的导航点。

## 安装
=======
- 解压到 'X4 Foundations/extensions/kuertee_surface_element_targeting/' 目录下。

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

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

## 鸣谢
=======
作者：kuertee。
中文本地化：Tiomer。
法文本地化：Calvitix。
德文本地化：LeLeon。
俄文本地化：Leonkillerua。

## 版本历史
=======
v7.5.07，2025年3月29日：
- 错误修复：上次更新后，模组特定的调试日志记录很可能被意外保留。如果尚未在模组的扩展选项中手动禁用，此更新将禁用它。

v7.5.01，2025年2月21日：
- 错误修复：7.5版本兼容性更新。

v7.1.13，2024年11月2日：
- 调整：将模组的自定义互动菜单从"指令"部分移动到了"行动"部分。

v7.1.01，2024年7月7日：
- 新功能：额外的"查找全部"功能——引擎、护盾、炮塔，现在可在互动菜单中使用。

v7.0.02，2024年6月29日：
- 调整：7.00 hf 1版本兼容性。
- 维护更新：使用UI扩展的新方法来加载模组特定的UIX lua文件。
- 错误修复：右键菜单查找与被瞄准表面元件相同的表面元件功能无法打开。
- 本地化：由Leonkillerua完成的俄文本地化。

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

v6.0.0004，2023年2月18日：
- 错误修复：即使你没有激活本模组中用于瞄准表面元件的任务，目标也会切换到一个表面元件。

v5.1.0314，2022年12月6日：
- 错误修复：仅在被瞄准的表面元件被玩家摧毁时才改变目标。

v5.1.0313，2022年10月31日：
- 错误修复：任务目标在被摧毁一个后无法正确自动瞄准。
- 错误修复：其他舰船摧毁的表面元件改变了玩家当前瞄准的表面元件。
- 错误修复：不必要的表面元件数量通知。

v5.1.0308，2022年9月29日：
- 错误修复：增加了更多条件（例如移动到新星区）来禁用瞄准功能。

v5.1.0305，2022年9月15日：
- 错误修复：重新编写了本模组90%的代码。希望修复了导致模组运行一段时间后停止工作（然后稍后又重新开始工作）的bug。

v4.2.0807，2022年2月28日：
- 错误修复：当玩家的目标改变时，设定为正确的空间站/舰船。以前，在某些情况下，当玩家的目标改变时，模组会保留玩家原先瞄准的空间站/舰船。

v4.2.0804，2022年2月2日：
- 调整：如果检测到没有可运行的表面元件，则发出通知。请注意，你仍然可以选择这些已停用的表面元件。它们不会在目标监视器上显示任何数据。但如果你选择将它们设置为任务目标，可能会产生混淆。
- 调整：如果检测到任何表面元件上线，则发出通知。
- 错误修复："查找全部"功能现在会将表面元件设置为任务目标。此功能在最近的两个版本中损坏。

v4.2.08，2022年1月20日：
- 错误修复：阻止自动瞄准不可瞄准的表面元件。此bug导致模组瞄准无效对象，UI将其解释为距离未知对象几公里远。

v4.2.074，2022年1月7日：
- 重新编写：之前的版本创建了一个累积性的bug，最终会影响性能。只需将此版本覆盖安装到旧版本之上，那些累积的任务线程就会被清理。

v4.2.04，2021年12月22日：
- 错误修复：被瞄准的表面元件只有在其被摧毁时才会改变。在之前的版本中，任何被摧毁的表面元件目标都会改变你的目标。

v4.1.01，2021年11月12日：
- 错误修复：不再记录空值错误。

v4.1.0，2021年11月6日：
- 错误修复：修复了许多错误。同时，代码也进行了更多清理。

v1.1.0，2021年8月11日：
- 错误修复：将 Mod 支持 API 设为必需。之前，本模组可以在没有 Mod 支持 API 的情况下安装。没有 Mod 支持 API，"查找全部 X"功能将无法使用。

v1.0.9，2021年7月25日：
- 错误修复：在使用"查找全部"互动后，本模组的任务有时会识别自身为最后一个活跃任务——这导致"重新激活最后一个活跃任务"功能无法正常工作。

v1.0.8，2021年7月11日：
- 调整：除非在扩展选项中启用，否则屏蔽调试日志。

v1.0.7，2021年7月6日：
- 错误修复："查找全部"互动功能损坏。

v1.0.6，2021年7月3日：
- 调整：当本模组的任务完成时（例如所有目标都被摧毁），重新激活最后一个活跃任务。

适用于游戏v4.0和v4.1beta1版本：
v1.0.5，2021年6月6日：
- 错误修复：上次更新导致模组无法在新存档上工作。

v1.0.4，2021年5月29日：
- 调整：移除了对 Mod 支持 API 的需求。
- 错误修复：当针对一个表面元件存在任务导航时，"查找全部"功能损坏。

v1.0.3，2021年5月4日：
- 调整：当玩家退出舰船控制时，停止瞄准序列。
- 调整：当玩家没有当前目标时，不瞄准下一个表面元件。

v1.0.2，2021年5月1日：
- 新功能：在一个作为任务目标的表面元件被摧毁后，下一个最近的任务目标将被自动瞄准。此功能仅适用于使用"rml_destroy_components"任务指令的任务——原版游戏中的此类任务绝大多数（如果不是全部）都使用此指令。不使用此任务指令的任务（例如来自某个模组的自定义任务）则不受支持。
- 新功能："查找全部"互动：当一个表面元件被瞄准时，使用互动菜单（F键）可以为所有相同类型的表面元件创建任务目标。当一个任务目标被摧毁后，下一个最近的任务目标将被自动瞄准。

v1.0.1，2021年4月30日：
- 调整：现在如果你直接瞄准一个作为表面元件的任务目标，也能正常工作。
- 错误修复：以前，你需要主动取消选择一个目标，然后选择一个新目标，模组才能工作。

v1.0.0，2021年4月29日：
- 初始版本。