Syntax
Arguments
WAD file or directory to add. Can be a
.wad/.wad.client file or a directory containing unpacked WAD structure.Target mod folder (must contain
META/info.json). WAD will be written under WAD/ directory.Flags
Path to the game folder. Rebases against game WADs; output filename is aligned to the base mount. Also strips unmodified entries.
While indexing the game, exclude TFT assets (
map21, map22).When rebasing, also drop entries not present in the base (unknown to the game).
Behavior
Without --game flag
The WAD is added directly and, if needed, renamed to end with .wad.client.
With --game flag
When the --game flag is provided, the tool:
- Finds the base mount for the WAD
- Optionally removes unknown entries (if
--removeUNKis set) - Always removes unmodified entries
- Writes the optimized WAD to the
WAD/directory
Examples
Add WAD with game rebasing and optimization
- Adds
my-changes.wadto theMyModfolder - Rebases against the game at
/games/LoL - Excludes TFT assets during indexing
- Removes unknown entries not present in the base game
Add unpacked WAD directory
- Adds the unpacked WAD directory to
MyMod - No game rebasing or optimization
- WAD is renamed to
.wad.clientif needed
Use Cases
- Adding custom assets: Add new or modified game assets to an existing mod
- Optimizing mod size: Use
--gameflag to strip unmodified files - Cleaning unknown assets: Use
--removeUNKto ensure only game-recognized files are included - Converting unpacked WADs: Import unpacked WAD directories into proper mod structure