Three steps
- Download the mod from its page here. Mods come as a
.pkmodfile. - Put it in your game's
modsfolder (inside your build folder; Modtopia makes it). A mod's folder works too, and so does a LayeredFS folder or zip made for other ports of the game. - Start the game from its launcher as always. When a mod needs it, the launcher updates the game first: a small window says so, and it takes a minute or two (the first time about five).
The first time a mod's code runs
The launcher asks before a mod's code runs for the first time, and again when it changes.
- A mod with code runs with your rights, as any program does: only use mods from people you trust. Every mod listed on this website is checked by hand first.
- F1 > Mods shows each mod's checksum at the bottom. It should match the one on the mod's page.
Turn mods off or remove them
- F1 > Mods, choose the mod, Enter: off from the next start.
- To remove a mod, delete it from the
modsfolder. Its settings stay inconfig, in case you bring it back.
Updating a mod
Download the new version and put it in mods in place of the old one. Your settings are kept.