How do I install a mod?
Since NEO Scavenger became moddable, several have asked how to install the mods they find.
In many cases, the mod comes in a zip file, and that zip file can be unzipped directly into your game folder. The game folder is whichever folder contains NEOScavenger.exe (or .app on OSX). Make sure you backup your game folder someplace in case you ever need to revert to it.
Depending on the mod, there may be special instructions in the zip. If so, follow those instead.
The important part of the mod is to get the mod's data folders into NEOScavenger's game folder, and to update getmods.php to list the new mod content. Most mods will have a getmods.php file included, and it's usually possible to just overwrite the vanilla game's getmods.php with the mod's version.
Starting in v0.988b, the mods are handled in a way that supports multiple mods. It also insulates mods against any new or edited content I add to the game (except when data formats change).
In 0.988b and later, each mod has its own folder. The game reads the getmods.php file to determine which order to load mods, and where to find them. If you want to install a mod, simply drop their mod folder into the game folder, and update getmods.php so the game knows where to find it.
To help illustrate this, the game comes with a sample mod called "SampleMod." This SampleMod will add a new "fancy shopping bag" item to the starting loot in the cryo hex. The getmods.example.php shows what your getmods.php file should look like to load the mod. The readme.txt in the game folder explains in more detail.
What if I have NEO Scavenger v0.988b, but the mod I want is from an earlier version?
There's a slight chance you can still use it, by installing it the same way 0.987b mods are installed. I.e. replace neogame.xml and other files with the mod's files. In theory, this will work.
However, you'll likely be missing new content from 0.988b or later if you do this. And it could cause unforseen bugs. Do so at your own risk.
How Do I Install Multiple Mods?
This is possible, but not all mods will be compatible with each other.
Generally, the process is to install each mod normally, and then edit the getmods.php file to list both mods. Some modders have kindly included special hybrid getmods.php files for other popular mods, and you can just use those. But if not, the rough idea is to tell the game:
- How many mod folders to load.
- The name of each mod.
- Which folder each mod is in.
Here's what it would look like for a simple mod:
What the above says is:
- nRows=2 - There are two mods.
- &strModName0=SampleMod - First mod's name is "SampleMod".
- &strModURL0=SampleFolder - First mod's folder (URL) is "SampleFolder".
- &strModName1=0 - Second mod's name is "0".
- &strModURL1=0 - Second mod's folder is "0".
The little "&" at the beginning of each line is just a separator, and the reason the first mod is strModName0 is because the computer starts counting at 0 instead of 1.
Dan Fedor - Founder, Blue Bottle Games