化学门建造者

X4 化学门建设器

该工具允许你为游戏《X4：基石》构建星门连接。它能帮助玩家在游戏中的任意星区之间建立连接。该工具会生成一个游戏模组（扩展包），方便安装和卸载。

特性

• 在游戏中的任何区域之间建立传送门连接。
• 从列表或银河地图中选择扇区。
• 创建任意数量的连接，其中连接是两个扇区中一对通道的连接。
• 只需用鼠标在地图上移动，即可轻松调整星区中星门的位置。
• 使用鼠标轻松旋转区域中的闸门。
• 直接模式 - 当你只需要选择一个游戏文件夹并开始建立连接时使用。无需提取任何内容。

免责声明

任何玩家都可以在他们的模组中或直接在游戏里使用此工具所建造的传送门连接。 如果你在模组中使用了这些连接，请在模组描述中注明作者和所使用的工具。

下载

您可以从以下位置下载该工具：

• Nexus

安装

只需下载最新版本并解压到任意文件夹即可。 你可以立即开始建立你的人脉关系。

使用方法

直接模式

在直连模式下，你无需解包游戏文件，只需选择游戏文件夹即可开始建立连接。 在此情况下，工具将直接从游戏文件加载游戏数据。且仅适用于游戏扩展文件夹中的"Chem Gate Keeper"模组。你将只能保存该文件，无法选择其存储位置。

首次启动 - 直接模式

首次启动时，该工具会提示您需要选择游戏文件夹，并切换到选项菜单选项卡。 如果您取消选择直接模式，您将按照下文首次启动部分中描述的启动流程进行操作。 选择游戏文件夹后，工具将开始加载游戏数据。

从版本0.9.0起可用。

初次模组创建：直接模式

加载游戏数据后，您将看到主窗口，并可以开始建造星门连接。 当你完成连接后，可以通过模组->保存菜单项来保存模组。 模组将保存在游戏的Extensions文件夹中。

直接模式第二次及后续启动

在下次启动时，工具将自动加载不仅游戏数据，还包括"生化门卫"模组数据。因此，启动后您将看到显示模组中连接关系的主窗口。 您可以更新连接、添加新连接或移除现有连接。之后，您可以通过 模组 -> 保存 菜单项保存模组。

直接模式与常规模式之间的切换

随时可以在直接模式和普通模式之间切换。只需进入选项菜单，勾选或取消勾选直接模式复选框即可。 在某些情况下，需要重新加载提取的游戏数据。

首次开始

首次启动时，工具会提示您需要选择包含游戏文件的文件夹。 如果你取消选择直接模式，你将按照下面描述的启动流程进行。 当你按下按钮选择文件夹时，该工具将提供两种操作方式：

• 选择解压后的游戏文件夹。如果已存在，请直接点击"是"按钮。
• 解压游戏文件。如果您尚未解压游戏文件，可以点击"否"按钮开始解压。

使用提取的游戏文件

选择文件夹后，工具将开始加载游戏数据。

维基上有一个与此工具相关的提取链接 - X 编目工具。

无提取的游戏文件

你将被转到包含开始提取按钮的菜单。请按下该按钮以开始提取。 现在一切都简单了：

• 选择包含游戏文件的文件夹。
• 选择将放置新文件夹的位置，该文件夹包含提取的游戏文件。它将自动创建，名称包含当前游戏版本。例如 "X4v710-extracted"。
• 按下"提取数据"按钮。

有几种提取游戏文件的方法：

• 仅提取所需数据——这将只提取工具正常运行所需的数据。比完整提取速度更快。
• 验证提取的数据 - 这将检查提取数据的一致性。建议在每次提取数据时使用此功能。
• 覆盖现有文件 - 这将覆盖输出文件夹中的现有文件。同样，建议在每次提取数据时使用此选项。
• 将提取的文件夹设为源，并在提取后加载 - 这将把提取的文件夹设置为游戏数据的源，并在提取后加载它。

此外，如果你不想提取某些DLC，可以取消选择它们。

加载包含游戏数据与DLC的模组

在选项页面有一个复选框，允许你与游戏数据和DLC一起加载模组。如果你想在工具中处理模组，这将非常有用。模组将从游戏数据中的extensions文件夹加载。提取方式与游戏数据和DLC相同。 自版本0.7.0起可用。 已更新于版本0.8.1。

数据加载重要通知

从版本0.7.0开始，该工具需要已提取的游戏数据中内容.xml文件用于DLC和Mod。 该工具将自动为DLC提取它们。如果你之前版本的工具有提取的数据（在v0.7.0之前）——请重复该过程。

重新加载游戏数据

如果你需要重新加载游戏数据，特别是Mod或DLC更新后（例如，如果你是Mod开发者，想了解更改后星系图的效果），可以通过X4数据 → 重新加载菜单项完成。 从版本0.10.2起可用。

主窗口

启动后，您将看到主窗口，其中包含连接列表和一个用于定义门连接的区域，即两个用于定义两个扇区中的门的区域。 新的传送门已经以默认位置显示在地图上，位于区域中心。

连接编辑区域

直接扇区选择与简单地图

首先，从直接扇区组列表中选择任意扇区。 然后，所选扇区中的物品将显示在原始且简单的扇区地图上，并以列表形式显示在地图右侧。 现有的大门在游戏中以黄色大门图标显示。金色大门来自当前编辑的模组。绿色大门代表当前正在编辑的大门。 此外，god.xml中的超级高速公路大门和站点也将显示。 星域地图的背景颜色与游戏中该星域所有者的颜色相匹配。

定义浇口位置

你可以通过左键点击门并将其移动到所需位置来定义门的位置。 通过输入坐标和旋转角度，可以设置更精确的位置。 请注意，坐标被分成了两部分：

• 坐标本身，单位为公里（这是该星区内相应的区域位置）。
• 位置 - 基于坐标点的位置（单位为米，这是区域中闸门的位置）。

为简化编辑，在选择扇区时，位置部分会随机预填。

入口轮换

门的旋转可以通过三个角度来定义：偏航角、俯仰角和翻滚角。 俯仰是最重要的，因为它决定了闸门在扇区中面对的方向。偏航和翻滚在大多数情况下通常不需要，但可用于特定场景。 以下是每个项目的解释：

• 偏航角：这只是环的顺时针/逆时针旋转角度。若设为90度，环的侧舱将位于顶部和底部。因此在大多数情况下通常无需调整，可保持为0。
• 音高：这是环的左/右旋转，如果你希望环在地图上朝向特定方向，这实际上是应使用的参数。音高为0度时，环朝向北方，地图上的连接线从环的南侧延伸出来。+45度时环向右转向东北方向，地图线指向西南方向。虽然船只行驶不关心地图线的朝向，但若方向错误会导致地图显示混乱且不必要地杂乱。此外，输入框不能超过180度，因此若想面向西方必须使用负值。奇怪的是，输入框内无数值时无法输入负号（-）。例如，-135度会使星门朝向西南，地图线指向东北方向。
• 翻滚：这是闸门的前后俯仰角度，通常不需要调整，除非闸门远高于或低于扇区平面。一般保持为0即可。

用鼠标旋转大门

您可以通过在地图上的新大门图标上按住鼠标右键并移动鼠标来旋转大门。增加与大门中心的距离将提高旋转精度。

从版本 0.10.0起可用。

银河地图上的星门朝向

银河地图上星门的方向通过俯仰角显示。

可从版本0.10.0起使用。

扩展扇区地图

如果当前星区地图大小对您来说太小，您可以按下相应按钮打开扩展星区地图。 在此地图上，您可以像在简易地图上一样设置大门位置，但更加精确。

"真实"扇区大小滑块

在扇区地图下方有一个滑块，用来调整扇区地图的"实际"大小。这实际上就是扇区地图的比例尺。

其他门数据

您可以定义大门的旋转角度并设置大门的状态。出于某些原因，您也可以将其禁用（如果您计划在自定义场景中使用它）。

相反区域选择

现在你可以选择第二个扇区，并在其中定义大门的位置。 请注意，在第二个（相对扇区）的选择列表中，某些扇区会显示为灰色且无法选择。这是因为该扇区已被选为第一个扇区，或者已经与直接扇区建立了连接。

在定义第二个区域的关卡后，你可以将连接添加到列表中。

添加门连接

只需按下添加按钮即可。

该连接将被添加到列表中。您可以在列表中查看该连接，并且仍可对其进行编辑。

修改现有连接

如果你在该区域内移动现有连接的门，地图上将会出现两个"相同的"门。 一个（金色）是连接处的门，另一个（绿色）是新位置的门。

删除连接

不建议，但可以删除之前添加的连接。 加载时游戏调试日志中会出现错误，但一切都会正常运行。 更好 - 只需在连接中为两个门将 "Gate Active" 设置为 false，即可简单禁用连接。 警告：切勿在当前存档中你正在游戏的星区内删除连接。这将导致游戏崩溃。

连接编辑区域按钮

窗口底部有两个按钮：

• 添加/更新 - 将闸机连接添加到列表中。我们已经讨论过这一点。
• 重置 - 将门禁数据字段重置为默认值。更多信息请参见下文。

重置按钮

如果在列表中未选择任何门连接，重置按钮会将所有门连接相关信息重置为默认值，大多数为空或零值。 否则，它将重置栅门数据字段为所选连接的值。

地图对象提示说明

你可以将鼠标悬停在地图对象上以查看它们的额外信息，例如状态、坐标和相关连接。这一功能有助于更好地理解不同门和扇区之间的关系。

银河地图

银河地图允许你在游戏中的各个星区进行导航。你可以放大和缩小来查看每个星区及其内部星门的详细信息。使用地图，你可以选择要在星门连接中使用的星区。

缩放功能有两种选项可供使用：

• 使用地图顶部的滑块。
• 按住 Ctrl 键的同时使用鼠标滚轮。

此外，放大地图后，您还可以使用鼠标左键拖动地图。 当你在一个扇区上点击鼠标左键时，该扇区将被选为连接中的直接或对立扇区。如果所选的扇区不适用于该连接，例如下拉列表中灰色显示的扇区，则该工具不会进行任何操作。 注意：如果你在地图上无法看到需要的星区，但列表中却显示该星区存在——这可能是因为该星区所在的星群坐标无法与六边形网格对齐。这可能会在相应的模组或DLC中成为一个潜在问题。

将地图导出为图像文件（png）

您可以将银河地图的当前视图导出为PNG图像文件。此功能允许您保存并与他人分享地图视图，或将其用于项目中的参考。要导出地图，只需点击银河地图界面右上角的"导出银河地图为PNG"按钮。感谢@Sleaker提出这个想法并进行初始实现。 从 0.10.3 版本起可用。

星团和星域提示信息

你可以将鼠标悬停在地图上的星团和星区上，查看关于它们的更多信息：

• 对于集群，你可以看到名称、宏和坐标。
• 对于星区，你可以看到名称、所有者、光照强度、经济、安全等级、宏观信息和坐标。此外，还会显示所属星团的信息。

从 版本 0.8.0 开始可用。

在地图上隐藏和显示DLC与Mods

你可以在地图上切换DLC和Mod的可见性，以便专注于当前的编辑任务。此功能让你能清晰地看到正在处理的连接，而不会受到其他内容的干扰。使用地图选项菜单，根据需要显示或隐藏这些元素。

可从0.8.0版本开始获取。

显示空集群单元

你可以切换地图上空置集群单元格的可见性。此功能可让你查看可放置新集群的空单元格。请使用地图选项菜单根据需求显示或隐藏这些元素。此外，你还可以在相应的工具提示中查看此类单元格的坐标。

保存模组

完成连接后，您可以通过模组 -> 保存菜单项保存模组。请确保在保存前完成所有必要的编辑，以免丢失数据。如果连接尚未完成，保存选项可能会被禁用。 请注意，如果你尚未完成连接的编辑，此菜单项将被禁用。请保存当前连接或重置它，以便能够保存模组。 选择保存菜单项后，工具会要求您选择模组的输出文件夹。

之后，该模组即可安装至游戏中使用。

加载模组

如果您有之前保存的模组，可以通过模组 -> 加载菜单项加载它。 与保存模组的区别在于，你必须选择模组根文件夹中的content.xml文件，而不是选择输出文件夹。 这样做是为了避免选择错误的文件夹。

加载模组后，您会在列表中看到连接，并且地图上会显示第一个连接的门。这种可见性确认了模组已成功加载，并有助于验证门的配置。

检查更新

通过菜单项

你可以通过点击 帮助 菜单中的 检查更新 菜单项来检查更新。这将提示工具检查是否有可用更新，并在发现新版本或你已在使用最新版本时通知你。

工具启动时

您还可以启用工具启动时自动检查更新的选项。这可以通过在选项菜单中选择相应的复选框来完成。启用后，工具每次启动时将检查更新，并在有新版本可用时通知您。

工具和游戏中的新门概述

工具中有一个模组的简短概述，可以查看传送门的位置。

以下是游戏中小行星带星区带有模组门的几幅截图。

鸣谢

• EGOSOFT——为了游戏本身（事实上，也是为了整个游戏系列）！
• x4_modding discord频道 的成员 - 感谢他们的回答、支持、想法和灵感！
• SiliconStew - 感谢他记录了传送门旋转的详细信息！
• Sleaker - 提出了地图导出功能的创意并进行了初步实现，以及隐藏了"不必要的"Mod。

实用链接

EGOSOFT论坛

在EGOSOFT论坛上有一个关于该工具的讨论话题。您可以在那里提问、分享想法或提供反馈。

GitHub 仓库问题报告

请报告在使用该工具时遇到的任何问题或错误。您可以通过 GitHub仓库问题反馈 提交您的报告。您的贡献有助于为所有人改进此工具！

许可证

本项目遵循 Apache License 2.0 许可证 - 详见 LICENSE 文件。

更新日志

[0.10.6] - 2025-10-11

• 已添加
  • 可通过点击[帮助]菜单中的[检查更新]菜单项，或在工具启动时检查更新。
• 已修复
  • 改进门连接逻辑，修复门匹配逻辑中的Bug。
  • 已禁用的模组不再影响直接模式下的排序顺序。
  • Vortex Mod Manager 使用的符号链接未正确处理
  • 扩展文件中的信息被加载了两次
  • 其他小修复和改进

[0.10.5] - 2025-09-22

• 改进
  • 改进了鼠标滚轮缩放地图的功能 - 现在操作更加流畅

[0.10.4] - 2025-09-21

• 已修复
  • 更改"加载模组"选项后 - 工具将自动重新加载游戏数据

[0.10.3] - 2025年9月20日

• 修复
  • 修复了银河地图上错误传送门连接的问题，如果某些Mod导致传送门区域名称重复
  • 如果内置列表中没有显示游戏版本，系统会自动添加该版本。
  • 在Gate Keeper模组的content.xml文件中，游戏版本已保存更新
  • 未受模组影响的地图数据不会在地图查看器窗口的模组列表中显示（感谢 @Sleaker 提供思路和初步实现）
  • "另存为..."按钮的可用性
• 改进
  • 移除硬编码的DLC列表，即特使包正常加载
  • 游戏数据加载时主窗口模糊
• 已添加
  • 在地图查看器窗口中将地图导出为图像文件（png） （感谢 @Sleaker 提供想法和初始实现）

[0.10.2] - 2025年7月19日

• 已添加
  • 通过 X4 Data -> Reload 菜单项重新加载游戏数据

[0.10.1] - 2025-07-18

• 改进
  • 自述文件现在将在嵌入式浏览器中打开，而不是系统默认浏览器

[0.10.0] - 2025年7月18日

• 已添加
  • 在星区和星系地图上显示星门方向
  • 在扇区地图上通过鼠标旋转大门

[0.9.7] - 2025-07-18

• 已修复
  • 修复了从包含UTF-8 BOM的Egosoft目录中提取文件的问题
• 改进
  • 改进了提取窗口，重新排列了DLC和Mod的控制选项及"全部"选项
  • 改進了地圖構建期間未處理的群集的日誌記錄，前提是其坐標無法與六邊形網格對齊。

[0.9.6] - 2025年3月14日

• 已修复
  • 仅在由差异文件定义的星区中创建跳跃门（某些模组的特性）

[0.9.5] - 2025年3月5日

• 已修复
  • 忽略簇/扇区中的重复项
• 改进
  • 集群和扇区的工具提示
  • 模组版本显示在星系地图中

[0.9.4] - 2025年3月4日

• 已修复
  • 正在加载非标准颜色用于分数
  • 正在加载显示包含其内容的大区域
  • 银河地图上的缩放滑块
• 改善
  • 星区地图上的星区缩放

[0.9.3] - 2025-02-28

• 已添加
  • 支持使用自定义宇宙 ID
• 已改进
  • 改进的大门坐标、位置和旋转角度输入
  • 调试日志可读性

[0.9.2] - 2025年2月25日

• 已修复
  • 修复了使用工具加载模组时的问题，该问题始于v0.8.8
  • 加载模组差异不会因错误而中断
  • 修复了基于依赖关系的模组加载顺序逻辑

[0.9.0] - 2025-02-24

• 已添加
  • 直接模式以简化工具使用
• 改进
  • 处理EGOSOFT目录的流程

[0.8.9] - 2025-02-20

• 已添加
  • Hyperion pack DLC 支持
• 已修复
  • 修复了在模组编辑后content.xml文件损坏的问题

[0.8.8] - 2025-02-17

• 已修复
  • 修复了已创建模组加载到游戏时的问题 - "大小写"问题
• 改进
  • 游戏数据加载的内部流程

[0.8.6] - 2025-02-14

• 已修复
  • 修复了将模组加载到工具时的问题

[0.8.5] - 2025-02-14

• 已更新
  • 文档

[0.8.4] - 2025年2月14日

• 已添加
  • "另存为"选项（针对该模组）
• 改进：
  • 地图对象的工具提示
• 已修复
  • 模组变更检测逻辑

[0.8.3] - 2025-02-14

• 重构
  • 修改了数据加载的内部逻辑 (XMLPatch)

[0.8.2] - 2025-02-13

• 已修复
  • 修复了提取窗口的行为

[0.8.1] - 2025年2月13日

• 改进
  • 模组可以与游戏数据和DLC一同提取

[0.8.0] - 2025-02-13

• 已添加
  • 星团与星区工具提示
  • 在地图上隐藏和显示DLC及模组
  • 显示空集群单元格（鼠标悬停时显示坐标）

[0.7.0] - 2025-02-11

• 已添加
  • 与 Mod 合作，不仅仅是 DLC
• 已更改
  • DLC 和 Mod 的 content.xml 文件现在必须在解压后的文件中包含。
  • 它们被自动提取。
• 警告
  • 如果您已提取游戏文件，请重复提取过程

[0.6.0] - 2025年02月10日

• 已添加
  • 提取游戏文件

[0.5.2] - 2025-02-08

• 已添加
  • 星系地图
  • 很多其他的小玩意儿……
• 重构
  • 从Python重写为C#以避免误报病毒检测
• 已移除
  • 控制台版本已消失

[0.4.3] - 2025年1月14日

• 已添加
  • 初始公开版本