X4: Foundations

X4: Foundations

GEM FX
 This topic has been pinned, so it's probably important
Ganossa  [developer] 20 Apr, 2020 @ 7:03am
Custom Color Correction Guide
For all of you who are interested in customizing the Color Correction modes and especially in sharing their own creation, below is a quick guide that should get you started.

A preview to your workshop creation can be shared in the following discussion: https://steamhost.cn/steamcommunity_com/workshop/filedetails/discussion/2061697157/3609015230781868303/

Don't be discouraged by the amount of steps, I meant to write it in much detail, so its far shorter/easier than you might think.

Have fun creating~
Last edited by Ganossa; 20 Apr, 2020 @ 9:41am
< >
Showing 1-8 of 8 comments
Ganossa  [developer] 20 Apr, 2020 @ 7:15am 
Required Tools
Photo Editing Tool that handles .dds formats
e.g. Gimp (https://www.gimp.org/downloads/)

X Tools (including Publishing Tool and X Catalog Tool)
from Steam's Tool library
Last edited by Ganossa; 20 Apr, 2020 @ 9:17am
Ganossa  [developer] 20 Apr, 2020 @ 7:16am 
Getting Started
  1. Subscribe to below mod and run the game at least once (to download mod files) https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=2067181123
  2. Create your own modding folder "gemfx_<modder-id>_luts_01" at any location (not in "extensions" folder)

  3. Copy content.xml from the subscribed modding folder to your own modding folder
    (change Name, Description and Author accordingly)

  4. Open the X Catalog Tool (via X Tool from Steam's Tool library)
    1. Select the subscribed "X4 Foundations\extensions\gemfx_ganossa_luts_01" folder as root folder for input files

    2. Import Catalogs to import subst_01.cat and ext_01.cat from the above folder

    3. Extract all to your own modding folder "gemfx_<modder-id>_luts_01"
Last edited by Ganossa; 20 Apr, 2020 @ 9:18am
Ganossa  [developer] 20 Apr, 2020 @ 7:17am 
Custom Color Correction
  1. Open "gemfx_ganossa_luts_01\assets\textures\regionluts\test-noCC-lut.dds" in your Photo Editing Tool (e.g. Gimp) but DISABLE the option to "Load mipmaps"

  2. Layer-1 and Layer-2 are textures used for Lens Effects

  3. Select and make exclusively visible Layer-3 to proceed with Custom Color Correction

    • The native lookup table can be found at the upper left corner

    • In the middle is the control image (a scene from X4)

    • On the bottom are Control sections/squares to tweak gemfx's handling of your custom lockup table (use Gimp filling tool to change [white/black] value of Control squares)

      1. left square red color range value for output luminance of LUT (100% if red color range is 100%) vs luminance of original image (100% if red color range is 0%)
      2. left square green color range value for output chroma (color) of LUT (100% if green color range is 100%) vs chroma (color) of original image (100% if blue color range is 0%)
      3. left square blue color range value for input chroma (color) and luminance of original image of original image (100% if blue color range is 100%) vs exclusively chroma (color) (100% if blue color range is 0%)
  4. Use the selection tool, to only select the area of the control image and the LUT for color correction

  5. Choose any color correction effect from the Photo editing tool and apply them to the LUT and control image until you are satisfied with the look of the control image

  6. File > Export as ... > .dds with Format: RGB8 and Save: As volume map
    • File name depends on which Color Correction mode you want to replace:
      1. Position; name to: "test-photo-lut.dds"
      2. Position; name to: "test-desat1-lut.dds"
      3. Position; name to: "test-desat2-lut.dds"
      4. Position; name to: "test-experimental-lut.dds"
    • You do not need to replace all 4 Color Correction modes, since if you don't, simply the gemfx stock ones will be used
Last edited by Ganossa; 27 Apr, 2020 @ 8:34am
Ganossa  [developer] 20 Apr, 2020 @ 7:18am 
Custom Graphic Settings Menu
In "gemfx_<modder-id>_luts_01\t\0001-l0**.xml" change Color Correction mode name to your preference (only for those you actually replaced with new .dds files)
Last edited by Ganossa; 20 Apr, 2020 @ 9:03am
Ganossa  [developer] 20 Apr, 2020 @ 7:20am 
Packing and Publishing
  1. Open the X Catalog Tool
    1. Select the subscribed "path_to_your\gemfx_<modder-id>_luts_01" folder as root folder for input files

    2. Import Folders to import "assets" folder (first remove all existing content from the tool's list)

    3. Save as catalog to your own modding folder "gemfx_<modder-id>_luts_01\subst_01.cat"

    4. Import Folders to import "t" folder (first remove all existing content from the tool's list)

    5. Save as catalog to your own modding folder "gemfx_<modder-id>_luts_01\ext_01.cat"
  2. Open the Publishing Tool (via Play X Tool console from Steam's Tool library)
    • to publish a new mod, execute:
      WorkshopTool publishx4 -path "path_to_your\gemfx_<modder-id>_luts_01" -preview "your_preview.jpg"
    • to update an existing mod, execute:
      WorkshopTool update -path "path_to_your\gemfx_<modder-id>_luts_01" -changenote "what you changed"
  3. On your mods steam workshop page, on the right hand side (owner controls) use Add/Remove required items feature to add the base gemfx mod as a requirement to your extension mod
Last edited by Ganossa; 20 Apr, 2020 @ 9:46am
Ganossa  [developer] 20 Apr, 2020 @ 9:48am 
<reserved>
Ganossa  [developer] 20 Apr, 2020 @ 9:48am 
<reserved>
Ganossa  [developer] 20 Apr, 2020 @ 9:49am 
<reserved>
< >
Showing 1-8 of 8 comments
Per page: 1530 50