X4 Collision Converter

Description

This tool allows you to import X4 Foundations collision files into Blender. The addon works through the standalone CollisionConverter.exe, which reads the game's native .jcs collision format and converts it into Blender-readable geometry.

Requirements

• []Blender 4. 2 or newer.[/]

  []Windows x64.[/]

  Installation

  Main file

  The main file contains the standalone converter:

  • []CollisionConverter.exe[/]

    []Import_single.bat[/]

    []Import_multiple.bat[/]

    Download and extract the main file to any folder. The converter can be used directly from command line or through the included batch files.

    Blender addon

    The Blender addon is provided as an optional file. It is not required if you only want to use the standalone converter.

    • []Download the optional Blender addon .zip file.[/]

      []In Blender, open Edit → Preferences → Addons.[/]

      []Click Install from Disk and select the downloaded addon .zip file.[/]

      []Enable the installed addon.[/]

      []Expand the options of the installed addon.[/]

      []Specify the path to CollisionConverter.exe from the extracted main file.[/]

      After completing these steps, press N in the viewport. The X4Tools tab should appear in the sidebar.

      Using the Converter Outside Blender

      The standalone converter can be used without Blender. The archive includes CollisionConverter.exe and two optional batch files for converting collision files manually.

      Direct command line usage

      Open Command Prompt in the folder where CollisionConverter.exe is located and run:

      CollisionConverter.exe --input "C:\Path\Input\part_main-hull.jcs" --output "C:\Path\Output\part_main-hull.obj"

      The --input argument must point to the source .jcs file.

      The --output argument must point to the .obj file that should be created.

      CollisionConverter.exe --input "C:\Development\Modifications\X4 Foundations\Collision\part_main-hull.jcs" --output "D:\Development\Modifications\X4 Foundations\Hulls\part_main-hull.obj"

      Using the single-file batch

      The single-file batch is used to convert one .jcs file.

      The paths inside the batch file are empty by default, so you must provide them manually when running it:

      Import_single.bat "C:\Pa