MapConverter

	Latest experimental build (with 0.900+ features) can be downloaded here: MapConverter_0900_r2357.zip [0.5 MB] This is a portable build, and can be used without fCraft.dll. Requires .NET 4.0

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

Usage

MapConverter [options] -e=ExporterName "MapFile1" "MapFile2" "MapFile3..."

MapConverter [options] -e=ExporterName "Directory"

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` One-letter flags can be combined: `-rty` is same as `-r -t -y`

`-e=, --exporter=FORMAT`

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

ClassicWorld (.cw) - used by ClassiCube and fCraft 0.900+ (new in 0.900)
D3 (.map) - used by old versions D3 server
D3Folder (folder) - used by newer versions of D3 server (new in 0.900)
FCMv3 (.fcm) - used in fCraft 0.500-0.64x
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
Schematic (.schematic) - classic tileset (new in 0.900)
ModernSchematic (.schematic) - converted-to-modern tileset (for improved compatibility) (new in 0.900)

`-f=, --filter=PATTERN`

Optional: Pattern to filter input filenames, e.g. *.dat or builder*. Applicable only when a directory name is given as input. Regular expressions can be used in the filter if -x / --regex flag is given.

`-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
ClassicWorld (.cw) - used by ClassiCube and fCraft 0.900+ (new in 0.900)
D3 (.map)
D3Folder (folder) - used by newer versions of D3 server (new in 0.900)
FCMv2 (.fcm) - used by fCraft prior to version 0.500
FCMv3 (.fcm) - used in fCraft 0.500-0.64x
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.

`-r, --recursive`

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

`-t, --tryhard`

Optional: Try ALL the map converters on files that MapRenderer has trouble loading. When enabled, ALL map converters are tried, including ones that do not typically handle files with the given file extension.

`-x, --regex`

Optional: Enable regular expressions in "filter".

`-y, --overwrite`

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

`-?, -h, --help`

Prints usage information and a list of options.

MapConverter.exe edit codes

Code	Meaning	Notes
0	Success
1	ArgumentError	Required command-line arguments were missing, or an error occurred while trying to parse options.
2	UnrecognizedImporter	Given importer name was not recognized.
3	UnrecognizedExporter	Given exporter name was not recognized.
4	InputPathNotFound	Given file/directory name does not exist.
5	PathError	Error occurred while trying to check input directory, or error occurred while trying to check/create output directory.
6	UnsupportedLoadFormat	Given "importer" format name was recognized, but loading from it is not supported.
7	UnsupportedSaveFormat	Given "exporter" format name was recognized, but saving to it is not supported.