Header image

Documentation

To quickly get started, see the downloads page. For problems, see the troubleshooting section; let me know if you're still stuck. Check the quick reference page for a brief rundown of mouse and keyboard controls, menu and export options, and what the files included with Mineways each do. Read this for the process I go through when exporting for 3D printing.

Normally you can just hit "OK" on the export dialog and things will work fine. Read on if you want to understand how to make your models less expensive, use different texture packs, and otherwise tailor you want to see printed out. What follows is extensive documentation about each part of the export and print process. If you don't want to wade through it all, at least search this page for the phrase "Key tip", as these bits are particularly useful.

Subscribe to the Mineways mailing list - it's for only important announcements, such as new version releases.

Installation

Installation is trivial: download and unzip (using 7-Zip or other decompressor) to some directory, like the desktop.

Uninstall: just delete the directory. If you created color schemes, there will be a few small entries in the registry, If you are fanatical and really want to clean these out, search for "Mineways" in your registry editor and you'll find them.

Double-click the mineways.exe to run the program.

Opening Worlds

There are many ways to open a Minecraft world in Mineways. If one doesn't work for you, try the next.

File | Open World: In the "File" menu header there is "Open World". Click (or hover) and move to the right to select your world. These are the worlds in your "%appdata%\.minecraft\saves" directory. The worlds are listed by their (not necessarily unique) given names on the left, their folder on the right, and arranged alphabetically by these folders.

If you want to export any particular block, use File | Open and select the "[Block Test World]" - this is an internally-generated "world" of blocks, with each block type listed from west to east in block ID order, and with variants shown from north to south. To select a single block, find it, select it, then hit "[" to move the bottom level up by one, so selecting only the block itself and not the surrounding grass.

Here's a view of a tiny piece of [Block Test World] exported to OBJ and viewed with G3D:

If you can't find your world in the list, you can select "Find your world..." at the bottom, which is the same as doing...

File | Open...: Navigate to wherever your world is stored and select the level.dat file. On Windows, the default folder for saves is "%appdata%\.minecraft\saves"; for Mac it's "~/Library/Application Support/minecraft/saves/".

File | Import Settings: If you've previously exported data from your world, you can actually select this data file (.OBJ, .WRL, or for STL export, the .TXT file generated) with Import Settings. This will not only open your world, but will also set all the previous export settings you used to make this export file, including the color scheme and the terrain file chosen.

When you import a file's settings, the settings affect only the particular file type. For example, if you read in a WRL file for 3D printing, its settings will not affect OBJ rendering export (or even OBJ 3D printing export, for export settings specific to OBJ files, such as material output). This feature is backwards compatible to Mineways 2.0, though of course features added since then will be given default values. A noticeable change in 5.01 is that the "Create composite overlay faces" is off by default; files from before 5.01 will read in but not change this option to on (which is what was used in 5.00 and earlier to export the model).

One other extremely useful type of file that Import Settings can read in is a script file, which can automatically perform all sorts of operations, including a powerful system for modifying blocks during export. See the scripting documentation for more information.

Mapping

Here's basic map use: