Using the mod manager

Start the manager without a command:

yarn dlx -p @sabinmarcu/mods mods
sh

Select a game from the picker, or bypass it with --game:

yarn dlx -p @sabinmarcu/mods mods --game grounded2
sh

The manager lists only complete triplets for the selected installation. An entry with [+] is enabled; an entry with [-] is disabled. Files that do not form a complete .pak, .ucas, and .utoc set do not appear, and the manager does not repair or remove them.

Enable and disable

Move with the Up and Down arrow keys or j and k. Press Space on the selected entry to toggle it.

Disabling renames all three files by appending .disabled. Enabling removes that suffix from all three files. The mod data remains in the selected mods directory in either state, so toggling is reversible.

Use g or Home to select the first entry, G or End to select the last entry, and q or Ctrl+C to quit. The manager requires an interactive terminal; a non-interactive invocation must select a game explicitly and exits rather than presenting a list.

Initialize a mods directory

The game picker can initialize a missing canonical mods directory interactively. For scripts or direct use, select a game and run init:

yarn dlx -p @sabinmarcu/mods mods --game grounded2 init
sh

Initialization creates only the final directory expected by the adapter, and only when its parent exists. If the game was not detected, combine the command with --game-root.

Built and maintained by Sabin Marcu

(2025 -2026)

Table of contents

Experiments