X4 碰撞转换器

X4 碰撞转换器

Blender 插件和独立转换器，用于将 X4 Foundations Jolt 碰撞 .jcs 文件导入 Blender。

X4 碰撞转换器预览查看大图

描述

该工具可将 X4 基石碰撞文件导入 Blender。该插件通过独立的 CollisionConverter.exe 运行，该程序读取游戏原生的 .jcs 碰撞格式并将其转换为 Blender 可读取的几何体。

系统要求

  • Blender 4.2 或更高版本。
  • 64 位 Windows 操作系统。

安装

主文件

主文件包含独立的转换器：

  • CollisionConverter.exe
  • Import_single.bat
  • Import_multiple.bat

下载并将主文件解压到任意文件夹中。转换器可直接通过命令行或附带的批处理文件使用。

Blender 插件

Blender 插件作为可选文件提供。如果您只想使用独立转换器，则无需安装。

  • 下载可选的 Blender 插件 .zip 文件。
  • 在 Blender 中，打开 编辑 → 偏好设置 → 插件。
  • 点击“从磁盘安装”，然后选择已下载的插件 .zip 文件。
  • 启用已安装的插件。
  • 展开已安装插件的选项。
  • 指定主文件中 CollisionConverter.exe 的路径。

完成这些步骤后，在视口中按 N 键。侧边栏中应会出现 X4Tools 选项卡。

在 Blender 外使用转换器

独立转换器可在没有 Blender 的情况下使用。压缩包中包含 CollisionConverter.exe 和两个可选的批处理文件，用于手动转换碰撞文件。

直接命令行使用

在 CollisionConverter.exe 所在的文件夹中打开命令提示符，然后运行：

CollisionConverter.exe --input "C:\路径\输入\part_main-hull.jcs" --output "C:\路径\输出\part_main-hull.obj"

--input 参数必须指向源 .jcs 文件。

--output 参数必须指向要创建的 .obj 文件。

示例：

CollisionConverter.exe --input "C:\开发\修改\X4基石\碰撞\part_main-hull.jcs" --output "D:\开发\修改\X4基石\船体\part_main-hull.obj"

使用单文件批处理

单文件批处理用于转换一个 .jcs 文件。

批处理文件中的路径默认为空，因此您必须在运行时手动提供它们：

Import_single.bat "C:\路径\输入\part_main-hull.jcs" "C:\路径\输出\文件夹"

示例：

set "INPUT_FILE=C:\开发\修改\X4基石\碰撞\part_main-hull.jcs"
set "OUTPUT_DIR=C:\开发\修改\X4基石\船体"

输出的 .obj 文件将在指定的输出文件夹中创建，并使用与源 .jcs 文件相同的名称。

使用多文件批处理

多文件批处理用于转换一个文件夹中的所有 .jcs 文件。

批处理文件中的路径默认为空，因此您必须在运行时手动提供输入文件夹和输出文件夹：

Import_multiple.bat "C:\路径\输入\文件夹" "D:\路径\输出\文件夹"

示例：

set "INPUT_DIR=C:\开发\修改\X4基石\碰撞"
set "OUTPUT_DIR=D:\开发\修改\X4基石\船体"

输入文件夹中找到的所有 .jcs 文件都将被转换为 .obj 文件并放置到指定的输出文件夹中。