MapConverter

MapConverter is a utility, bundled with fCraft 0.630+, that can convert mapfiles between different file formats. MapConverter.exe requires fCraft.dll to function.

Usage

MapConverter [options] -e=ExporterName "FileOrDirectory"

Examples

Single file conversion

MapConverter -e=MCSharp "filename.dat"

Converts a single file named "filename.dat" to MCSharp format, and saves it to "filename.lvl"

Batch conversion

MapConverter -r -e=FCMv3 "C:/maps"

Finds all map files in "C:/maps", including files in subdirectories, and converts them to FCMv3 (.fcm) format. Each converted file is saved into the same directory as the original file.

Moving out conveted maps

MapConverter -r -o "C:/converted" -e=FCMv3 "C:/maps"

Same as above, but converted map files are all placed into "C:/converted" directory.

Filtering

MapConverter -f=builder* -e=Opticraft "old_maps"

Looks for filenames that start with "builder", in a directory named "old_files".

Options

	Options have alternative short (one-letter) and a long (whole word) forms. You can use either form: `-e=MCSharp` is same as `--exporter=MCSharp`

`-e, --exporter=FORMAT`

REQUIRED: Converter used for exporting/saving maps. Available formats:

D3 (.map)
FCMv3 (.fcm) - used in fCraft 0.500-0.630
FCMv4 (.fcm) - planned format for future versions of fCraft
JTE (.gz)
MCSharp (.lvl) - MCSharp, FemtoCraft, MCZall, MCLawl, MCForge, etc
MinerCPP (.dat) - also works for LuaCraft
Opticraft (.save)
Raw (.raw) - block data array, without any metadata

`-i, --importer=FORMAT`

Optional: Converter used for importing/loading maps. Available importers:

Auto - default; tries to determine file type automatically
Classic (.dat or .mine) - Minecraft Classic and SurvivalTest maps
D3 (.map)
FCMv2 (.fcm) - used by fCraft prior to version 0.500
FCMv3 (.fcm) - used in fCraft 0.500-0.630
FCMv4 (.fcm) - planned format for future versions of fCraft
Indev (.mclevel) - from Minecraft Indev maps
JTE (.gz)
MCSharp (.lvl) - MCSharp, FemtoCraft, MCZall, MCLawl, MCForge, etc
MinerCPP (.dat) - MinerCPP and LuaCraft
Myne (directory-based) - Myne, MyneCraft, Hyvebuild, and iCraft
Opticraft (.save)

`-o, --output=PATH`

Optional: Path to save converted map files to. If not specified, converted maps will be saved to the original maps' directory.

`-f, --filter=PATTERN`

Optional: Pattern to filter input filenames, e.g. *.dat or builder*. Applicable only when a directory name is given as input.

`-r, --recursive`

Optional: Look through all subdirectories, and convert map files there too. Applicable only when a directory name is given as input.

`-y, --overwrite`

Optional: Do not ask for confirmation to overwrite existing files.

`-?, -h, --help`

Prints usage information and a list of options.