User Tools

Site Tools


mapc

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.

Base Usage

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%].

Example

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

Relative Usage

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…

Example

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 .

Output

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.

MapcUI

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.

mapc.txt · Last modified: 2014/03/09 05:18 by challengespaceyard