Marvel Rivals mod packaging, conversion, extraction, inspection, and install toolset.
| Tool | Use for | Avoid for |
|---|---|---|
repak-gui |
normal mod install/manage workflow; archives; raw folders; legacy pak repack; IoStore mods | script automation |
retoc-rivals-cli |
scriptable .pak/.utoc/.ucas, archive, directory, manifest, KawaiiPhysics, and conversion workflows |
visual mod management |
remat-rivals |
extracted-asset material mask and KawaiiPhysics value/curve editing | normal one-click installs |
repak_cli |
pak-only legacy inspection/extraction/packing | modern Rivals IoStore output (.utoc/.ucas) |
Modern Marvel Rivals mods normally install into:
MarvelRivals\MarvelGame\Marvel\Content\Paks\~mods
- Download latest release from Nexus Mods: https://www.nexusmods.com/marvelrivals/mods/1717.
- Open
repak-gui. - Confirm or browse to
Content\Paks\~mods. - Drag in
.7z,.zip,.rar,.pak, IoStore triples, or folders. - Review install rows/options.
- Click
Install mod. - Launch game from GUI or Steam.
| Page | Contents |
|---|---|
| GUI | install flow, mod list, tags, file table, KawaiiPhysics mapping |
| retoc-rivals-cli | commands, accepted inputs, examples, filters, compression, full IoStore checks |
| remat-rivals | material masks, Kawaii values, curve editing, preview limitations |
| Build | Rust builds, run commands, workspace packages |
| Troubleshooting | game path, locked files, KawaiiPhysics, IoStore dependency failures |
| Release Automation | Nexus Mods workflow inputs and config |
| Changelog | release history |
| Path | Purpose |
|---|---|
repak-gui/ |
primary GUI app |
remat-rivals/ |
material/Kawaii editor GUI |
retoc-rivals-cli/ |
current scriptable Rivals CLI |
retoc-rivals/ |
IoStore conversion/extraction library |
repak/ |
pak reader/writer library |
repak_cli/ |
older pak-only CLI |
uasset-mesh-patch-rivals/ |
mesh patch helper |
usmap/ |
mapping-related workspace content |
cargo run -p repak-gui
cargo run -p remat-rivals
cargo run -p retoc-rivals-cli -- --help
cargo build -p repak-gui --release
cargo build -p remat-rivals --release
cargo build -p retoc-rivals-cli --release
cargo checkretoc-rivals-cli info ExampleMod_9999999_P.utoc
retoc-rivals-cli manifest ExampleMod_9999999_P.utoc --filters
retoc-rivals-cli unpack ExampleMod_9999999_P.utoc --output unpacked
retoc-rivals-cli unpack-dir "C:\Downloads\Rivals Mods"
retoc-rivals-cli pack unpacked --output "C:\Path\To\~mods" --compression oodle
retoc-rivals-cli pack-dir "C:\Downloads\Rivals Mods" --output "C:\Path\To\~mods"
retoc-rivals-cli pack-dir "C:\Downloads\Rivals Mods" --output fixed_mods --separate-output-dirs
retoc-rivals-cli pack-dir "C:\Downloads\Rivals Mods" --output fixed_mods --kawaii-physics
retoc-rivals-cli pack ExistingMod_9999999_P.utoc --output fixed_mods --game-paks-dir "C:\Path\To\Paks" --obfuscate
retoc-rivals-cli fix-kawaii-physics unpacked
retoc-rivals-cli fix-kawaii-physics --output fixed-modsSee docs/retoc-rivals-cli.md for full command behavior.