部署用的路径点字段

部署用路径点区域

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

更新日志
=======
v8.0.3.4, 2025年12月9日：
- 错误修复：若舰船的部署指令被中断（例如需从船坞补充部署物，或执行Kuda的规避行为时），它们曾会在同一位置部署多个物体。

模组效果
===========
创建你和僚机可跟随的路径点，以便部署设备与武器。

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

推荐配套模组
==========================
以下是我所有提升游戏体验的模组。这些模组的任务均列在"引导任务"标签页中。请使用我的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)：创建你和僚机可跟随的路径点，以便部署设备与武器。

工作原理
============
路径点区域通过以下两种方法之一创建。

任务激活
==================
1. 当原版游戏的 rml_achievecoverage.xml、rml_deployinplace.xml 或 rml_find_resources.xml 任务中激活了部署设备（卫星、导航信标）或武器（激光塔、地雷）的任务时，会创建路径点区域任务。由于使用探测器寻找资源的任务没有特定的目标位置，因此需要手动放置路径点区域。详见下方的"手动创建"部分。
2. 路径点区域任务会引导你和你的僚机（需携带必要的设备/武器）前往区域中的每个点。你的僚机会在每个点部署必要的设备/武器。路径点的密度和区域的大小会根据设备（或武器）的功能范围和任务要求自动设定。
3. 当主要任务完成时（例如所需覆盖范围已填满），路径点区域任务也会结束。你的僚机会回收那些未被主要任务占用的部署物。
4. 你可以自由停用路径点区域任务，但主要任务被激活时会重新激活。

手动创建
===============
1. 在地图上右键点击来创建路径点区域。
2. 在路径点区域任务菜单中配置区域。选择要部署的设备/武器以及区域的形状（立方体或球体）。
3. 你一次只能拥有一个路径点区域。
4. 通过右键菜单命令一艘舰船"创建路径点区域"。
5. 或者在路径点区域任务菜单中点击"分配舰船"按钮来分配一艘新舰船。

舰船与舰队行为
=========================
你命令执行部署的舰船会跟随路径点区域并部署必要的设备或武器。

但如果该舰船有被指定为"跟随者"的 subordinate，它们将执行部署任务，而该舰船的其余部分则负责防御。
否则，整个舰队将执行部署。

需要时，这些舰船每次会补充10个单位的物资。

安装
=======
- 解压至 'X4 Foundations/extensions/kuertee_waypoint_fields_for_deployments/'。
- 确保子文件夹和文件位于 'X4 Foundations/extensions/kuertee_waypoint_fields_for_deployments/' 中，而不是 'X4 Foundations/extensions/kuertee_waypoint_fields_for_deployments/kuertee_waypoint_fields_for_deployments/'。

从旧版本更新
=============================
在安装此版本前，请对旧版本进行一次"纯净存档"。

执行纯净存档的方法：
1. 从文件系统中删除旧版本。
2. 加载游戏。保存游戏。这就是纯净存档文件。它不包含旧版本的内容。
3. 安装新版本。
4. 从纯净存档文件加载并开始游戏。

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

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

致谢
=======
模组由 kuertee 制作。
中文本地化由 Tiomer 完成。
法文本地化由 Dorlito 完成。
德文本地化由 EagleFour 完成。

版本历史
=======
v8.0.3.2, 2025年11月12日：
- 错误修复：现在部署指令会下发给玩家作为乘客的玩家所属舰船。
- 错误修复：自定义右键交互菜单不再列于船坞的舰船控制台菜单中。

v8.0.3.1, 2025年11月11日：
- 错误修复：任务信息面板中的"从任务创建路径点"按钮已损坏。

v8.0.2.0, 2025年10月16日：
- 新功能：自定义菜单中的密度滑块。
- 新功能：由 Dorlito 完成的法文本地化。

v8.0.1.0, 2025年9月28日：
- 错误修复：当部署区域较小时，某个函数出现了"除以零"的错误。此错误存在于由部署任务创建的路径点区域中，而非通过模组自定义菜单手动创建的路径点区域。
- 错误修复：对于不使用英文文本的某些玩家，语言文件可能存在损坏。

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

v8.0.0.2, 2025年7月22日：
- 调整：与原版游戏 8.0 Hotfix 2 测试版的兼容性。

v7.6.1, 2025年6月14日：
- 错误修复：从部署任务创建路径点导致游戏死锁。
- 错误修复：某些情况下手动创建路径点导致游戏死锁。
- 调整：路径点生成已简化，并能更高效地填充其所占据的形状或体积。

v7.5.13.2, 2025年5月15日：
- 错误修复：部署位置的计算结果远超出了星区范围。

v7.5.13.1, 2025年5月15日：
- 错误修复：舰船仍在已有部署物体的位置进行部署。希望此版本能实际修复该错误。

v7.5.13, 2025年5月15日：
- 错误修复：舰船在已有部署物体的位置进行部署。

v7.5.12, 2025年5月8日：
- 调整：为部署和回收指令增加了对 NPC Reactions 模组中"报告敌人"和"侦查行为"设置的支持。

v7.5.11, 2025年4月26日：
- 错误修复：由任务创建的部署区域缺少所需的部署数量 - 导致模组永远无法完成任务。
- 调整：玩家需要处于部署区域范围内才能获得其路径点任务目标。
- 错误修复：M级舰船无法接收部署 Mk 2 激光塔的指令。

v7.5.07, 2025年3月29日：
- 错误修复：点击右键交互菜单中的"创建路径点区域"按钮后，有时菜单不显示。
- 错误修复：此前，所选舰船需要至少有一名僚机才能开始部署。
- 错误修复：上次更新后，模组特定的调试日志可能未关闭。如果未在模组的扩展选项中手动关闭，此版本将禁用它。

v7.5.05, 2025年3月18日：
- 错误修复：7.5 兼容性更新。

v6.0.0021, 2023年4月18日：
- 调整：允许在不选择舰船或选择玩家舰船时创建路径点区域。此前需要选择一艘非玩家控制的舰船。

v6.0.002, 2023年4月13日：
- 错误修复：使用一艘舰船部署时，该舰船会获取"保护位置"指令 - 中断了其部署指令。

v6.0.0004, 2023年2月18日：
- 错误修复：修正了部署时（如果他们没有"跟随"组中的下属）或保护部署位置时舰队领导者的指令。
- 注意：此版本应与 5.x 版原版游戏兼容。

v5.1.03141, 2022年12月7日：
- 调整："保护位置/舰船"指令不会覆盖舰队领导者的任何指令。但其跟随者仍会执行部署指令。例如，你可以让舰队领导者做其他事情，而其跟随者执行部署。

v5.1.0314, 2022年12月6日：
- 新功能：新行为：你命令执行部署的舰船会跟随路径点区域并部署必要的设备或武器。但如果该舰船有被指定为"跟随者"的下属，它们将执行部署任务，而该舰船的其余部分则负责防御。否则，整个舰队将执行部署。
- 调整：手动创建的路径点区域现在会在完成时关闭。此前我阻止其关闭，以便玩家使用"中止并回收"功能。但"回收范围内部署物"指令已经可用了几个版本。

v5.1.0305, 2022年9月15日：
- 错误修复：寻找补给空间站时，会遵守舰船的活动和旅行黑名单规则。在之前的版本中，补给会简单失败，导致舰船在寻找同一空间站和立即尝试前往该空间站之间循环。
- 错误修复：寻找拥有制造可部署物所需资源的空间站。在之前的版本中，会使用能够供应可部署物但缺少必要资源的空间站。

v5.1.0301, 2022年7月17日：
- 错误修复：范围内收集可部署物时因空间不足导致的循环错误。
- 调整："回收范围内可部署物"指令不再立即移除，允许你增加其范围。

v5.1.0009, 2022年5月23日：
- 调整：更好地回收范围内可部署物。

v4.2.0809, 2022年3月9日：
- 错误修复：当存在待回收的可部署物但无舰船（例如空间已满）能够回收时，"回收范围内可部署物"指令会陷入无限循环导致游戏挂起。

v4.2.0808, 2022年3月2日：
- 错误修复：上次更新破坏了"回收范围内部署物"功能。
- 调整：拥有"maxweaponrange"属性的可部署物将使用该属性而非"maxradarrange"。
- 调整：用户界面中更好的区域尺寸选择。
- 错误修复：小球体不再是圆盘状。
- 错误修复：尺寸曾错误地是所选尺寸的两倍。
- 错误修复：将路径点区域附着到物体上。以前的版本在尝试将其附着到物体（例如空间站）上时，会将区域降至黄道平面。

v4.2.0807, 2022年2月17日：
- 调整：允许 L 级和 XL 级舰船接收模组的部署指令。我之前不知道较小的舰船无法携带 Mk 2 激光塔。以前的版本将部署限制在 S 级和 M 级舰船。
- 调整：修正资源探测器的扫描范围。因为它们的扫描范围在 5.0 测试版之前未知，因此在以前的版本中其范围是估算值。

v4.2.0804, 2022年2月2日：
- 错误修复：支持模组"Crime has Consequence"的扣船功能。当存在活跃的路径点区域任务且玩家舰船被扣押时，上一个版本会导致游戏无响应地冻结。

v4.2.05, 2021年12月24日：
- 新功能：紧密密度：范围 x 2 且无间隙。此选项仅适用于未与任务关联的路径点区域。

v4.2.04, 2021年12月22日：
- 新功能：资源探测器的最佳密度现在设定为 50 公里。从它们的"鼠标悬停环"来看，其范围似乎是 100 公里。根据测试，将它们间隔 50 公里布置能产生最佳效果。即，它们开始在 50 公里距离处返回不同的数值。
- 新功能：集群地雷可用 - 如果你安装了 DLC。我认为它们随"人类摇篮"DLC 一起推出。
- 新功能：距离工具：交互菜单（即右键点击）会显示与所选物体或与全息地图上最后一次左键点击位置之间的距离。这需要 UI Extensions 模组的 v4.2.03 版本。

v4.1.0, 2021年11月6日：
- 错误修复：最小化（即移除，但可能仍会发生）一个路径点上部署物重复的问题。
- 调整：基于 4.1 版的资源探测器范围用户界面调整了资源探测器的大小和密度。注意，我认为没有人确切知道资源探测器的范围。根据我在论坛上的一个帖子，我所理解的范围是这样的："部署后，鼠标悬停在一个资源探测器上时，其周围的半径看起来大约为 40 公里 - 这是典型的通讯范围。但文档指出'currentyield'值是'... 资源探测器探测到的当前产量（体积是一个边长 32 公里的立方体空间）...'。这意味着范围（或半径）是 16 公里。但在百科全书中，它的范围是 3 公里。"这是关于该范围的讨论：https://forum.egosoft.com/viewtopic.php?f=146&t=442026&p=5079853&hilit=kuertee+probes#p5079851

v2.0.7, 2021年7月25日：
- 新选项：自动补充。默认启用。可在模组的"扩展选项"中禁用。

v2.0.6, 2021年5月29日：
- 调整：除了寻找资源任务外，其他任务不再需要处于活跃状态才能创建路径点区域任务。

v2.0.5, 2021年4月25日：
- 错误修复：补充物资时，舰船曾会前往最远的拥有库存的空间站，而不是最近的空间站。

v2.0.4, 2021年4月22日：
- 错误修复：没有僚机且没有空间回收可部署物的 NPC 飞行员未移除其指令，导致他们无限期闲置。

v2.0.3, 2021年4月19日：
- 错误修复：如果你的资金不足以支付费用，NPC 飞行员将不会补充可部署物。
- 调整：有时"创建路径点区域"按钮在任务激活后不可用，直到你关闭再重新打开菜单。此版本修复了此问题。

v2.0.2, 2021年4月18日：
- 新功能：部署任务中的 NPC 飞行员现在会补充其可部署物。
- 调整：在任务用户界面中... 你现在需要将任务设为"活跃"状态后，"创建路径点区域"按钮才可用。
- 调整：路径点区域任务现在不会在接受/接收到部署任务时自动创建。

v2.0.1, 2021年4月5日：
- 新功能：扩展选项中可配置的尺寸倍率。
- 调整：玩家的 NPC 舰船现在默认部署普通地雷。以前，它们无法快速撤离或会触发地雷。在此版本中，部署的地雷处于非激活状态，只有在路径点区域任务完成后才会激活。
- 错误修复：为任务部署激光塔或地雷有时会被忽略 - 阻止当前路径点完成。
- 错误修复：执行"回收可部署物"指令的舰船领导者（或单艘舰船，如果该舰船没有僚机）有时不会回收可部署物，因为它正忙于搜索要回收的可部署物以向其僚机下达回收指令。对于没有僚机的舰船，可部署物将不会被回收。在此版本中已修复。
- 错误修复：以前，如果先前部署的物体被摧毁（例如地雷爆炸），路径点区域将永远无法完成，因为摧毁导致的计数错误。

v2.0.0, 2021年3月11日：
- 新功能：为 4.0.0 beta 11 版原版游戏更新。
- 调整：清理了不必要的本地化文件。重写了 content.xml 清单文件。
- 新功能：每种可部署物的形状、大小和密度设置会被保存并在下次使用时恢复。
- 新功能：AI 指令：回收范围内可部署物。你现在可以命令你旗下的任何舰船回收给定区域内的任何可部署物。
- 调整：与我的另一个模组"Accept mission for later"的兼容性。接受一个部署任务不会覆盖你当前活跃的任务。

v1.2.8, 2020年12月28日：
- 调整：创建路径点区域现在也是一种舰船指令。选中一艘舰船后，在地图上右键点击将命令该舰船进行部署。
- 调整："允许部署"和"暂停部署"现在只是 AI 控制项。即使部署暂停，任务仍会引导你前往每个路径点。以前，必须允许部署才能让任务引导你前往每个路径点。

v1.2.7, 2020年12月22日：
- 调整：将任务转移给一艘舰船不再转移给其舰队的最高指挥官。任务仅转移给该舰船及其僚机。
- 调整：预览信标现在基于其位置是否已被探索，而不是基于其与星区核心的距离。
- 调整：手动创建的路径点区域在部署全部完成后不会终结。这允许你发送"中止并回收"指令。
- 调整：任务目标通知现在更紧密地跟随所附带的任何 X4 任务的通知方式。
- 调整：由 EagleFour 提供的德文语言文件。
- 错误修复：对玩家忽略的路径点重新分配错误的另一次修复尝试 - 我似乎无法修复这个问题。

v1.2.6, 2020年12月18日：
- 调整：减少了任务提示音。仅当你的路径点改变、你的某个僚机在一个路径点进行了部署并改变了其状态、或路径点的可部署物、形状、密度发生改变时才会发出提示音。
- 错误修复：切换可部署物现在会恢复其默认的大小和密度设置 - 而非获取之前的设置 - 这可能导致面板中对于新可部署物没有可用的选项。
- 错误修复：玩家忽略的路径点未重新分配给 AI 飞行员。

v1.2.5, 2020年12月17日：
- 错误修复：引导任务错误："设定为活跃"、"设定为非活跃"按钮现在可用。并且"转移任务至..."按钮现在可用。所需的 UI Extensions 文件 kuertee_menu_map.lua 之前未能加载。在我本地的环境中它之所以能工作，是因为我有其他加载了该文件的模组。
- 错误修复：防止 AI 回收可部署物时崩溃。
- 新功能：资源探测器现在有更大的尺寸选项（25公里、50公里、100公里、150公里、200公里）和新的密度选项（不足 x5、缺陷 x10）。
- 错误修复：中止或"中止并回收"路径点区域任务现在会激活其附带的 X4 任务（如果有关联）。

v1.2.4, 2020年12月15日：
- 新功能 / 错误修复："转移任务至..."允许你选择将执行部署的舰队。这同时修复了将任务锁定给一个特定舰队的错误 - 迫使你必须摧毁或出售该舰队的领导者才能将新的路径点区域任务重置给当前舰船。你需要更新后的 UI Extensions 模组才能使用此功能。

v1.2.3, 2020年12月13日下午：
- 错误修复：对于目标覆盖范围小于上一次错误修复中引入的最佳部署密度的情况，球体布局计算不正确。这会产生一个奇怪的圆柱形形状。此版本正确修复了此错误。

v1.2.2, 2020年12月13日：
- 错误修复：对于目标覆盖范围小于最佳部署密度的情况，球体布局计算不正确。例如，36公里半径的卫星覆盖任务。
- 错误修复：原始任务组在其一个任务完成后未重新激活。

v1.2.1, 2020年12月8日：
- 新功能：墙壁、矩形平面和圆盘布局。
- 调整：更好的立方体和球体布局。
- 调整：手动创建的路径点区域将获取上一个手动创建的路径点区域的设置。
- 新功能：模组的任务现在列在"引导任务"标签页中，使你的"剧情任务"标签页不再被我的各种模组创建的辅助任务占据。我建议使用我的 Ui Extensions 模组 (https://www.nexusmods.com/x4foundations/mods/552)。没有这个模组，你将无法在"引导"标签页中列出的任务之间切换。
- 调整：更好的任务和目标描述，以配合我的其他辅助模组：拾取采矿、舰船扫描器、信号泄漏猎手 - 递增范围以及空间站扫描器。
- 调整：以前，预览信标可能会渲染在星区已知空间之外 - 增加了星区的已知空间。在此版本中，预览信标仅在其位于星区已知空间内时才会渲染。
- 错误修复：太空行走会阻止你的僚机进行部署。这是因为在游戏内部，太空服被视为舰船。然而，任务（用于引导你和僚机指令的路径点区域控制器）仍仅限于一艘舰船。换船会中断前一艘舰船的僚机指令。但新舰船的僚机会继续执行任务。我建议不要换船。执行任何其他操作（停靠、离舰、守卫、跳跃到另一个星区等）都不会中断路径点区域任务。

v1.2.0, 2020年12月1日：
- 新功能：大小和密度控制现已启用。它们在以前的版本中被禁用（如果你查看代码，会看到这一点）。我想通过实际游玩来熟悉这个模组，而不仅仅是进行游戏测试，以确定实际需要的控制项。（另外，我知道我之前的立方体/球体布局不是最好的。我想在启用这些控制之前对它们进行调整。）
- 调整：路径点区域任务仅附着到已激活的部署任务。以前，它会尝试附着到最后一个部署任务，即使该任务未激活。
- 调整：仅在原始部署任务第一次被激活时自动创建路径点区域任务。如果你中止了路径点区域任务，则需要通过原始部署任务重新创建。
- 错误修复：修复了此前在两点发生的崩溃：创建路径点位置时以及 AI 回收部署物时。
- 错误修复：此前，任务更新通知错误地报告了部署数量与总数之比。
- 调整：更好地将玩家忽略的路径点重新分配给 AI 飞行员。
- 调整：更好地处理任务中止/完成。
- 调整：更好地处理在地图上手动创建路径点。以前，它会自动创建一个引导任务（当路径点区域任务激活时会立即移除）。在此版本中，它不再需要引导任务。

v1.1.0, 2020年11月22日：
- 新功能：直接通过在地图上右键点击来创建路径点区域。
- 新功能：路径点区域面板现在会列出其附带的任务。"显示原始任务"和"显示路径点区域任务"可在两个任务面板之间切换。
- 新功能：路径点区域任务（例如任务目标、进度等）现在附属于你最后控制的舰船。以前，只有当你直接控制该舰船时它才会工作。在此版本中，你可以离开该舰船去做其他事情。
- 调整：僚机默认在执行采矿任务时部署 Fried-Foe 地雷。手动命令他们部署其他类型的地雷。他们的 AI 在避开自己部署的地雷方面表现不佳。
- 调整：更好地分配回收的部署物。以前，第一个僚机会尽可能多地回收，而其他僚机则回收剩余的一小部分。
- 调整：由原版游戏的 rml_achievecoverage.xml、rml_deployinplace.xml 和 rml_find_resources.xml 文件创建的任务现在会创建路径点区域任务。这些底层文件是以前使用的 gm_* 文件的基础任务。
- 调整：增加了资源探测器路径点的水平间隔。
- 错误修复：对于部署后不会立即设置所有权的部署物，路径点完成之前会失败 - 导致僚机在同一个路径点部署多次。例如，激光塔。
- 错误修复：对于手动创建并附属于任务的路径点区域，如果部署的星区与任务的星区不同，僚机的部署会在第一个部署后停止。
- 错误修复：重新分配玩家忽略的路径点。
- 错误修复：此前，当任务的目标覆盖范围小于我的模组中设置的路径点间隔时，会导致失败。在此版本中，由区域决定间隔。

v1.0.0, 2020年11月15日：初始发布。