Skip to content

Mod Manager

Jump to bottom
siecvi edited this page Jun 7, 2026 · 2 revisions

ZeroSpades includes a built-in mod manager for downloading, installing, and managing mods directly from the Mods tab in the main screen.

Installing Mods

Downloading official mods

All mods are downloaded from the zerospades-paks repository. Mods are saved into the Mods/ folder inside your User Resource Directory. If a mod file already exists, it will be overwritten.

Installing mods manually

You can also install mods manually by placing files directly into the Mods/ folder:

  • Loose pak — a single .pak file at the root of Mods/ (e.g. Mods/MyMod.pak).
  • Folder mod — a subfolder containing one or more .pak files (e.g. Mods/MyMod/pak0.pak).

Managing Mods

The mod list shows every mod found in Mods/, with the following columns:

Status · Apply Order · Mod · Paks · Size

  • Status — checkbox indicating whether the mod is enabled.
  • Apply Order — the 1-based position in the load order; higher numbers are applied later and win file conflicts. Blank when disabled.
  • Rows shown in green are enabled and present on disk.
  • Rows shown in orange are enabled but their files are missing from disk — disable them and reinstall if needed.

Enabling and disabling mods

Click a row to toggle the mod on or off. The change is saved immediately, but takes effect only after a restart.

When you are done making changes, click Apply changes to restart the game with the new set active. The game relaunches automatically and returns to the Mods tab.

Changes are not live until you restart. Toggling a mod and then closing the game without clicking Apply changes will still apply next time you launch — but if you just close the game normally nothing is lost.

Controlling load order

Mods are applied in the order they were enabled — the most recently enabled mod is applied last and wins any file conflicts. Its Apply Order number will be the highest in the list.

To change the order, disable the mods you want to reorder and re-enable them in the desired sequence.

Disabling all mods

Click Disable all to clear the entire enabled set. This takes effect after a restart (or after clicking Apply changes).

How It Works

Mods are mounted as a read-only overlay on top of the base game paks at startup — nothing is copied or merged onto disk. The base paks are never modified.

On each launch, the engine reads EnabledMods.txt in your User Resource Directory and mounts each enabled mod's pak(s) in order. The last-enabled mod ends up on top and wins any file conflicts.

Creating Mods

To create your own mods, see mod-workbench — a helper tool for developing, testing, and packaging ZeroSpades mods without any zip/pak round-trip.

Clone this wiki locally