hemtt build

Build the project for final testing

Usage: build [OPTIONS]

Options:
      --no-bin             Do not binarize the project
      --no-rap             Do not rapify (cpp, rvmat, ext, sqm, bikb, bisurf)
      --just <JUST>        Only build the given addon
  -t, --threads <THREADS>  Number of threads, defaults to # of CPUs
  -v...                    Verbosity level
      --no-color           
  -h, --help               Print help (see more with '--help')

Description

Build the project for final testing

hemtt build will build your mod into .hemttout/build. It will binarize all applicable files, and will not create folder links like hemtt dev.

It is intended to be used for testing your mod locally before release.

Binarization

By default, supported file types are converted to their binary formats for optimal game performance. This process is slower but produces smaller, faster-loading files similar to BI’s official addons.

Configuration

[hemtt.build]
optional_mod_folders = false # Default: true

`optional_mod_folders`

By default, hemtt build will create separate mods for each optional mod folder.

PAA Conversion

hemtt build will convert supported image files to the PAA format.

The conversion can be configured in the project configuration under [hemtt.paa].

[hemtt.paa]
enabled = false # Default: true
extensions = [] # Always uses ["png", "tga"], additional extensions can be added here
allow_argb8 = "ask" # Default: "ask", can also be "allow" or "deny"

`enabled`

Determines if PAA conversion is enabled.

`extensions`

Specifies the image file extensions that should be converted to PAA format.

`allow_argb8`

Determines if ARGB8 images are allowed during PAA conversion. This format is only used for non-standard images that aren’t using powers of two textures.

"ask": Prompt the user for each ARGB8 image.
"allow": Allow all ARGB8 images.
"deny": Deny all ARGB8 images.

Files will be copied directly into the PBO without binarization. config.cpp, *.rvmat, *.ext, *.sqm, *.bikb, *.bisurf will still be rapified. This can be configured per addon in addon.toml.

Useful for faster builds during testing when you don’t need optimized file formats.

–no-rap

Do not rapify (cpp, rvmat, ext, sqm, bikb, bisurf)

They will be copied directly into the PBO. This can be configured per addon in addon.toml.

The HEMTT Book