How to use mapc
Mapc is a program designed to compile the levels made with Radiant to make them usable in Neverball and Neverputt. All instructions are based upon using command lines.
Note: You may need to precede mapc with ./ if using bash.
Be sure the map(s) you want to compile are in the root Neverball directory. Then input the following (be sure you include a .map extension after the name of the file)
mapc [%MAPNAME%] [%MTRL%]
This will output a file called [%MAPNAME%].sol. Now you can put this in the appropriate directory. Normally, use data for [%MTRL%].
For this example, file easy.map will be used. This file should be in the root directory of Neverball, then, inside the root directory,
mapc easy.map data
Note: Periods (when used to reference different directories) might not work in Neverball 1.5.2 and later, as the PhysicsFS library disallows its usage.
You can compile maps in another directory other than the root, just add the appropriate relative location. Use .. for parent directory and specify directory name for the name of the directory…
For this example, file easy.map will be used. This file should be in the data directory of Neverball, then, inside the root directory,
mapc data/easy.map data
Or if you are in the data directory:
../mapc easy.map .
This example is based on compiling a very simple map using the R948 compiler.
StartWalledLumpX.sol (10/$0) mtrl vert edge side texc geom lump path node body 4 32 66 24 20 52 10 0 3 1 item goal view jump swch bill ball char indx 0 0 0 0 0 0 1 0 312
Key factors to consider when gauging how well the map will perform, especially on older systems, are the lump, indx, and (to a lesser extent) vert. Having any of these too high will cause performance issues.
You can also use the front end program MapcUI. MapcUI does not require knowledge of a command shell, and it can easily order a folder's worth of compilations with one keystroke.