Syntax
Arguments
Source mod folder (must contain
META/info.json).Destination mod folder. If it exists, it will be replaced.
Flags
Path to the game folder. Rebase mod WADs against the game to reduce deltas.
Exclude TFT assets when indexing the game.
Behavior
Thecopy command performs the following operations:
- Resolves conflicts inside the mod
- Writes normalized WADs into
dst_mod_dir - Copies
META/*files to the destination
In-Place Optimization
Ifsrc_mod_dir == dst_mod_dir, the command performs a safe in-place optimization using a temporary directory.
With --game flag
When rebasing against the game:
- Reduces file deltas by aligning with base game assets
- Strips unmodified entries
- Optimizes mod size
Examples
Copy and optimize with game rebasing
- Copies
MyModtoMyMod.optimized - Rebases against the game at
/games/LoL - Resolves internal conflicts
- Reduces mod size by stripping unmodified files
In-place optimization
- Optimizes
MyModin place using a temporary directory - Excludes TFT assets during processing
- Resolves any internal conflicts
- Normalizes WAD structure
Use Cases
- Mod optimization: Reduce mod size by removing redundant files
- Conflict resolution: Automatically resolve internal file conflicts
- Format normalization: Ensure mod follows proper structure
- In-place cleanup: Optimize mods without creating duplicates
- Distribution preparation: Create clean, optimized versions for sharing