Getting started

The Mods menu

Finding, enabling and previewing installed mods, and mod artwork.

Installed mods

The Mods screen lists every folder in mods/ that has a valid mod.json, up to 256 folders. Open Mods Folder opens the installation directory. Enabled IDs are saved in local settings under mods; missing or invalid enabled IDs are reported rather than silently removed.

Search and filters

The search box matches names, IDs and descriptions as you type. All, Enabled and Disabled filters combine with the search. The gold outline marks the mod whose details you're viewing; its switch controls whether it's enabled. Filtering never changes activation.

Mod artwork

Put an optional icon.png beside your mod.json:

• Transparent or opaque PNG, at most 512 × 512 pixels and 1 MiB.
• The list and details view use the same icon and keep its aspect ratio.
• Missing or invalid images fall back to the standard mod icon.

Press Reload Mods after changing artwork. Icons are local presentation assets and aren't sent to co-op rooms.