Skip to content

Merge FGD Tool Usage

Jasmine 'Jazzrabbit' Stephens edited this page Mar 2, 2024 · 1 revision

Our current mapping tool, TrenchBroom, only supports loading a single fgd entity file at a time. This can be problematic if you want to be able to use entities from both the base game, and your mod, or from other mods. To solve this, we have made a tool that will merge all fgd files into a single combined fgd file automatically.

To use this tool, go through the tools installation described here Then, run the MergeFGDTool.exe tool from inside the Tools folder. By default, this will create a new file in your fuji installation folder called Celeste64Merged.fgd. This file will include all of the entities from all the fgd files in the Mods folder, and the Content folder. Note: if the same entity is defined twice, it will try to use the first one, so try to avoid redefining entities if you can.

Optional Parameters: This tool allows you to add some optional parameters if you are running it from the command line to give more control. You can control what the file that is generated is called, as well as the searchpath that it searches from. These are optional, and are only needed if you want more control and don't want to use the defaults.

Parameter Default Value Description
filename ..\Celeste64Merged.fgd The name and path of the generated file.
searchpath ..\ The root search path of the folders to search in

The filename lets you control the name of the generated file. This is pathed relative to the tool exe, so you can add an optional path to control where it generates the file. The searchpath controls the root folder we search inside of for fgd files. The tool will merge all FGD files inside of that folder by searching recursively. This can be either a relative path or an absolute path.

To use these parameters, use the following syntax from the command line:

  • MergeFGDTool.exe filename=..\CustomMerged.fgd searchpath=..\Mods\

Clone this wiki locally