mod-tools CLI
The mod-tools CLI provides a comprehensive set of commands for working with CSLOL-style mods and WAD files. It supports importing/exporting mods, copying and optimizing mod folders, building overlays, and running the live overlay patcher.General Usage
Available Commands
The CLI provides six main commands:addwad- Add a WAD (file or directory) into a mod foldercopy- Optimize and copy a mod folder, resolving internal conflictsexport- Export a mod folder to a single archive after optimizing itimport- Import various mod inputs into a standardized mod foldermkoverlay- Build an overlay from multiple mods against the game’s WADsrunoverlay- Run the overlay with the live patcher
Common Flags
Path to the game folder. Enables rebasing against the game WADs and filtering.
Exclude Teamfight Tactics assets when indexing game WADs (skips
map21 and map22).Path Handling
Unless otherwise noted, paths may be absolute or relative. Commands log progress and exit with non-zero status on error.Format Notes
WAD Source
A “WAD source” can be:- A
.wador.wad.clientfile - A directory that looks like an unpacked WAD (contains
data,data2,levels,assets, orOBSIDIAN_PACKED_MAPPING.txt)
Mod Folder
A “Mod folder” must contain:META/info.json- Mod metadataWAD/directory (after optimization)
Exit Codes and Logging
- Success: Prints
Done!and exits with code 0 - Error: Prints a backtrace and error message to stderr, exits with non-zero code
TFT Filtering
The--noTFT flag excludes maps named map21 and map22 when indexing the game, reducing install size for Summoner’s Rift-only mods.