Roller should be run from the command line or from a Windows batch file.
Usage: roller.exe WRPFILE [options] Replacing objects and textures: -F, --replace-forests A,B,C Replace OFP forest block objects with individual trees and bushes, according to comma-separated list of YAML files (occurs after object replacement) -o, --replace-objects A,B,C Replace objects according to comma-separated list of YAML files (occurs before forest replacement) -t, --replace-textures A,B,C Replace textures according to comma-separated list of YAML files Altering the terrain: -c, --terrain-cell-size N Set new size of terrain cells (metres). This must give a legal grid size of 16x16 to 4096x4096 cells (e.g. for an island imported from OFP, which has 50m cells, you could resize to 800, 400, 200, 100, 25, 12.5, 6.25 or 3.125). -b, --terrain-bumpiness N Maximum amount of vertical distortion of new grid points added by terrain-cell-size (metres). Applied after terrain cell resizing, but before other changes. -r, --raise-sea-level N Move sea level up by this distance (move sea level down if negative). Done before edge-height is set. -e, --edge-height N Sets the height of all terrain points around the edge to a specific value. This is applied after cell, bumpiness and sea-level changes. Generating images: -m, --satellite-mask [FILE] Export a satellite mask PNG image (FILE defaults to 'WRPFILE_mask.png') -C, --satellite-cell-size N Size of satellite cells, i.e. pixels, in metres (defaults to 2m if this option is omitted') Exporting files: -O, --objects [FILE] Export BIS objects file (FILE defaults to 'WRPFILE_objects.txt') -u, --unique-objects [FILE] Export a list of objects used in the WRP (FILE defaults to 'WRPFILE_unique_objects.txt') -w, --wrp [FILE] Export WRP file in 8WVR format, regardless of which format it was imported as (FILE defaults to 'WRPFILE_export.wrp') -x, --xyz [FILE] Export XYZ file (FILE defaults to 'WRPFILE.xyz') Common options: -p, --show-progress Show the graphical progress bar (which will slow down all import, export and processing slightly). -f, --force-overwrite Forces overwriting of existing output files (defaults to requesting user confirmation of overwrites) -?, --help Display this message
If running from sources, rather than from the executable, the parameters are exactly the same, but the way of calling the application is slightly different.
Usage: ruby roller.rb WRPFILE [options]
Note that all file-names do not require an extension if they use the correct extension. Thus, replace_frogs is equivalent to replace_frogs.yaml if a YAML file is expected.