Mineways features are explained in detail on this page. Troubleshooting information is here and, for platform-specific problems, here. Converting Bedrock Minecraft worlds is explained here.

Mouse and Keyboard

• Left-click and drag - move around map.
• Right-click and drag - select or resize volume to export. Left-click and control-key also works.
• Shift + right-click and drag - the selection snaps to be a square region.
• Middle-click - change the depth (the lowest level exported) to the height visible where you clicked.
• Mouse wheel - zoom in and out. Hold shift and you instead change the visibility height; hold control and you modify the depth of the selected volume.

Also, hover the mouse over an option in the Export dialog for more information on it.

More on mouse controls in the Selection section.

You can drag and drop many kinds of files on to Mineways to load them:

• Drag and drop an exported *.OBJ, *.USDA, *.WRL, or STL *.TXT file to set Mineways to the same world, selection area, and conditions you used to export the model.
• Drag and drop a *.MWSCRIPT file to run its script commands.
• Drag and drop a terrainExt*.png terrain file to set the terrain export file.
• Drag and drop a *.DAT file from a Minecraft saved world to load that world.
• Drag and drop a *.SCHEMATIC to load that schematic for export.

Handy shortcut keys, for precision work:

• [ and ] changes the selected depth by one level up/down. Ctrl-mousewheel does the same.
• Space bar selects a reasonable depth for your selection volume, based on visibility (water is considered invisible, so that the bottom of lakes will be solid). Holding shift while tapping the spacebar will treat water and glass as opaque, useful for 3D printing.
• E/Q and PageUp/PageDn and +/- zoom in/out one level. (Note the Shift key is not needed.)
• Home and End zoom all the way in and out.

All shortcut keys are shown at the end of this page.

Mineways Menu Items

Shortcut keys are shown in parentheses next to each command.

File Menu

• Open World - select from list of worlds. The world name is shown to the left, the folder name to the right.
• Open... (Ctrl-O) - select the level.dat file of the Minecraft world to open.
• Reload World (R) - reopen loaded world. Handy for changing your Minecraft world itself and then reloading it.
• Choose Terrain File (Ctrl-T) - select a terrainExt*.png file found in the same directory as mineways.exe.
• Open Terrain File (Ctrl-T) - select a Mineways terrainExt*.png file by name, either one provide or one you've made with TileMaker.
• Download Terrain Files - go to the web location for downloading additional terrain files for Mineways.
• Import Settings (Ctrl-I) - import a previously-exported model (OBJ, USDA, WRL, STL's TXT file) to continue where you left off. Or, run a script of commands.
• Export for Rendering (Ctrl-R) - export the selected volume into a file appropriate for rendering. Tip: preview with G3D.
• Export for 3D Printing (Ctrl-P) - export for 3D printing, making solidity checks and simplications.
• Publish to Sketchfab (Ctrl-F) - put your model up for display at Sketchfab, a free service.
• Export Schematic (Ctrl-S) - export the model for use in WorldEdit or MCEdit.
• Repeat Export (Ctrl-X)- do an export again with the same export options. Handy for exporting, looking at result, and modifying volume until it's what you want.
• Close (Ctrl-Q) - exit program.

View Menu

• Undo selection (Ctrl-Z) - undoes (only) the last selection change you made.
• Jump to Spawn (F2) - view your spawn location.
• Jump to Player (F3) - view the (single-player) player location, if any, else spawn.
• Jump to Model (F4) - once you've made a selection, move the map view to this location.
• Focus View (v) - move the map view to this location.
• Information (i) - show world name, directory, Minecraft version, and player and spawn locations.
• View Nether (F5) - switch to the corresponding Nether level, if any.
• View The End (F6) - switch to The End level, if any.
• Show all objects (F7) - by default, small objects such as signs and ladders are not shown on the map.
• Show biomes (F8) - show the biome coloring for the world.
• Elevation shading (F) - higher elevations are brighter. Affects the USDA export's renderer settings, adding gloomy fog (needs work).
• Lighting (L) - an evening view of the world. Affects the USDA export's lighting.
• Cave mode (C) - shows the presence of underground caves.
• Hide obscured (H) - mostly useful for The Nether, it shows what's under the topmost level at Max height.
• Transparent water (T) - removes water from the map view, only. Water blocks will still be exported normally. If you truly want to remove water from export, use a color scheme and set the alphas of water and stationary water, #8 and #9, to 0.
• Map grid (M) - overlay a chunk and Anvil file (.mca) grid on the map. These coordinates are also shown at the bottom in the status line.
• Zoom out further - Lets you zoom out to more than one block per pixel. Doing so may cause slowdowns or lockups. See the scripting command line option "-zl" for more information.

Colors Menu

• Color Schemes... - defining one of these lets you change which block types are output, and what the block color is for display.

Help Menu

• Help at website - opens up this page in your browser.
• About ... - shows version number and other information.
• Give more export memory! - if you get an "out of memory" error from Mineways, try this to minimize memory use. Usually needed for only the Windows 32-bit version of Mineways. Mineways holds on to "map chunks" as it goes. If you move to a different part of your world, the old map chunks take up space in memory. When you call this option, all chunks not visible are freed up. The downside is a slower map drawing speed.

Mineways Export Options

You can usually ignore this scary dialog box and just click "OK" or hit the Enter key to skip it.

Rendering related:

• World coordinates selection volume: the lower and diagonally-opposite upper corners of the volume you're exporting.
• Create a ZIP file: this file is the one to upload to 3D print services. It's also handy for packaging up all the files produced.
• Export no materials, etc.: whether the model has a single color, solid colors on blocks, noisy colored textures, large images with all textures, or individual textures as needed.
• OBJ file export options: various professional settings allowing you to make the data easier to modify.
• Make Z the up direction: some systems use Y as up, some Z.
• Create composite overlay faces: ladders, vines, lily pads, and other flat (or flattened, for 3D printing) objects will be composited atop whatever is beneath them, making a separate, new texture for the combination. If off, these objects will be separate, floating polygons put a small bit above their related surfaces.
• Center model around the origin: if turned off, Minecraft coordinates are used instead. Useful for professionals.
• Use biome: use the biome's attributes to color the blocks. Currently uses only the single biome at the center of the export.
• Create block faces: if you don't plan on seeing the outer edges of your export, uncheck to make the file smaller. Useful for tiling, i.e., exporting separate sections of a world and having them join up.
• Tree leaves solid: for interactive applications such as VR, exports noticeably fewer polygons.
• Rotate model clockwise: can be useful for choosing a default view angle for other programs reading in the model produced. Unlikely to work well for schematic export.

3D Print related:

• 3D printing related options:
  • Make the model 5 cm in height: set the physical height of the model.
  • Minimize size based on wall thickness...: make the walls as thin as possible while still being printable.
  • Make each block 2 mm: the default safe wall thickness is shown, and can be changed.
  • Aim for a cost of $25.00: roughly choose the cost of the model, which will scale it in size.
• Fill air bubbles: hollow "bubbles" in the model are made solid. Usually a wise move when 3D printing. Can also reduce polygon count when rendering, by deleting areas fully enclosed.
  • Seal off entrances: use torches to seal off an entrance, so that the building interior can be filled in (and then hollowed out).
  • Fill in isolated tunnels: if a tunnel pokes out the side but does not reach the surface, fill it in.
• Connect parts sharing an edge: if a part would otherwise float in space, add a block to connect it to a nearby part.
  • Connect corner tips: if a floating part touches another by just the corners, add blocks to connect it.
  • Weld all shared edges: for any blocks touching only at the edge, add a block. Usually overkill, but can be useful for sloped roofs.
• Delete floating objects: if a solid block is not connected to the bottom of the model, delete it. This option can help tidy up a model for rendering or Sketchfab, too, by deleting tree foliage poking into an exported volume.
• Hollow out bottom of model...: make 3D print models more affordable by hollowing out unseen blocks.
  • Superhollow: aggressively hollow, carving away into nooks and crannies.
• Melt snow blocks: obscure command, meant for making "weep holes" for 3D printing larger after all other processing.
• Export lesser, detailed blocks: normally blocks are either printed as full blocks, or not at all. This allows many "partial" blocks to be printed.
  • Fatten lesser blocks: some detailed blocks can be too thin and will not print well. This makes them thicker.
• Debug: show floating parts...: any parts that are not fully attached to the main model will be made obvious.
• Debug: show weld blocks...: any blocks added by Mineways to make the model printable are shown as lava and pink wool.

Mineways Command Line Options

Using these options from the command line lets you customize how Mineways starts up.

file1.mwscript
Specify the file name and path for a script or model file to load on startup.

-w X Y
Specify the X and Y resolution in pixels of the startup window. Values must be positive integers.

-m
Start up Mineways as a minimized window. Useful for running scripts to completion with "Close" at the end to shut the program down.

-s UserSaveDirectory
Specify the directory where your Minecraft worlds are located, shown in the "File | Open World" list. This directory is "%appdata%\.minecraft\saves" by default, if not specified. The directory is not a single world's save folder, but rather a directory holding all world folders you want to choose from. If your directory path has spaces in it, you need to use double-quotes around the path, e.g. -s "C:\temp\My Minecraft Saves". Use "-s none" to load no world list at all.

-l mineways_exec.log
For debugging startup problems, you'll normally never use this. Saves startup and commands executed to the file specified.

Mineways Files

• Mineways.exe - the main, 64-bit executable.
• for_old_machines_Mineways32.exe - 32-bit executable version. Not recommended, unless you have no choice.
• terrainExt.png - the default Minecraft block tiles texture read by Mineways, if present.
• terrainExt_*.png - various popular resource pack block textures. Use Set Terrain File and select one of these for a different texture set, or make your own with TileMaker.
• docs/index.html - the starting spot for documentation; same page as mineways.com.
• README.txt - some quick notes, mostly leading you to documentation.
• mineways.bat - run Mineways and first apply whatever scripting commands are in scripting/startup.mwscript (empty by default).
• mineways_debug_log.bat - run Mineways and generate a mineways_exec.log file showing diagnostics.
• mineways_without_worlds.bat - an "if startup fails" way to run Mineways; avoids reading worlds from your default location.
• mineways_min_debug.bat - run Mineways without reading worlds and generate a mineways_exec.log file showing diagnostics.
• scripting/register-Mineways-run-as-administrator.bat - run once to associate *.mwscript scripting files with Mineways.exe. More here.
• scripting/*.mwscript - script files for automatically controlling Mineways in various ways. View the script itself to see comments about what it does. More about scripting here.
• TileMaker/ChannelMixer.exe - a program to pull in the various textures in a resource pack and, for physically based rendering packs, to separate the various channels into separate textures. See here.
• TileMaker/TileMaker.exe - a program to make a new terrain block texture set (terrainExt*.png) from a resource pack. More here.
• TileMaker/terrainBase.png - the basic template for textures. The same file as terrainExt.png, just to be safe.
• TileMaker/blocks - the directory where tiles (block textures) for TileMaker are put for processing. You provide the blocks you want to change. Also see the _readme.txt file there.
• TileMaker/textures - a tiling normal map texture for water from NVIDIA's open-source MDL (see the _readme.txt), for use when making PBR terrainExt files and you're missing a water texture.

Shortcut Keys

All shortcut keys for Mineways. Holding "Shift" does not matter for shortcut keys.

• Space bar selects a reasonable depth for your selection volume, based on visibility (water is considered invisible, so that the bottom of lakes will be solid). Holding shift while tapping the spacebar will treat water and glass as opaque, useful for 3D printing.
• Ctrl-A for worlds, selects the area visible on the screen; for schematics, selects the entire model.
• [ and ] changes the selected Depth slider by one level up/down. Ctrl-mousewheel does the same.
• < and > (with or without holding Shift) changes the selected Height slider by one level up/down. Shift-mousewheel does the same.
• 0-9 move the Height slider to fixed locations.
• Escape clears the selected area.
• E/Q and PageUp/PageDn and +/- zoom in/out one level. (Note the Shift key is not needed.)
• Home and End zoom all the way in and out.
• WASD and the arrow keys move around.
• Ctrl-O opens a world file, useful for when the world file is in some non-standard place.
• Ctrl-R saves a 3D model file for rendering, e.g., water is made transparent.
• Ctrl-P saves a 3D model file for 3D printing at Sculpteo or other 3D print service or printer.
• Ctrl-X saves the model again, without showing the file or export dialogs. Useful for when you are readjusting the bounds or color scheme of the model and simply want to redo your export.
• Ctrl-Z undoes the last selection change you made, to help you if you messed up. This feature will not undo height slider changes but undoes just about everything other selection modification.
• F1 opens up this online Mineways reference page in your browser, as does the ? key (with or without holding "Shift").
• F2 jumps to spawn.
• F3 jumps to single-player player's location, if any, else spawn.
• F4 jumps to selected area, if any.
• F5 goes to the Nether, if any.
• F6 goes to The End, if any.
• F7 shows all blocks on the map, such as flowers, mushrooms, ladders; off by default, as these can be distracting. Also shows ID and data values of the first block (including transparent blocks) under the cursor. This option does not affect exported models.
• F8 shows biomes. Grass, leaves, and water colors are affected by biomes. Moving the cursor over a biome displays its name in the lower left. Exporting with this option on will turn on the "Use biome in center of export area" option. Note: swamplands are not fully simulated, as in Minecraft these use a complex Perlin noise function to vary the temperature, which in turn determines the color of the grass: sickly brown or lush green. I chose sickly yellow as the default. The lush green is color #4c763c, if you want to use a color scheme to simulate it.
• F shades by altitude. This option does not affect exported models. When biomes are displayed, it shades by temperature, a subtle effect. Minecraft drops the temperature of a biome by 0.00167 every meter above 64.
• L show nighttime lighting. This option does not affect exported models.
• C shows underground caves below the given altitude.
• H hides obscured blocks. When you set a maximum altitude underground, this option discards all blocks at this altitude and lower, until an air pocket is hit. Try it with the slider set to 60 or lower, to see tunnels. On by default in the Nether.
• R reloads the world's map. This is useful for when you edit your world while Mineways is running, see this tutorial.
• T makes water fully transparent on the map. This setting does not affect export.
• Ctrl-Q closes the program.