Header image

You normally need your Minecraft world to be saved on your computer, running Minecraft: Java Edition on Windows, Mac, or Linux (or converting from the Bedrock Edition). You interactively select a model from your world map, which creates a 3D print or rendering file. See the step-by-step guide below or the first minute of this video for the basic process. Preview the output model with a 3D file viewer; I recommend G3D for OBJ files, MeshLab for STL or VRML files.

At this point you can upload your model for free to share, or make pictures of it with a rendering package, or have it 3D printed. For this last option, use your own 3D printer or upload the zip file Mineways produces to a 3D printing service. Prices of 3D prints range from $5 to $500, depending on size - my mantra is "smaller is cheaper, cuter, and cooler", such as this castle or house. See the gallery for some 3D printed models others have made.

How to set up and run Mineways:

Watch the first minute of this tutorial. Here's the step by step, explaining more functions:

1) Unzip mineways*.zip, the whole thing, to some directory. On Windows you can run mineways.exe from the zip file, though I don't recommend this.

2) Double-click the Mineways.exe program to run. If things don't start up correctly, see this guide.

3) Use "File | Open World" to select a world. Use "File | Open..." to open a schematic file.

4) Use the left mouse button to drag the map around, use the mouse wheel to zoom. "F3" takes you to the player's location. (More about keys and mouse.)

5) Drag with the right mouse button to select an area on the map and to adjust this rectangle.

6) Optionally click with the middle mouse button or set the "Lower depth" slider to select a depth for the volume to export.

7) Export the model for rendering by "File | Export for Rendering". Export for 3D printing by "File | Export for 3D Printing" - just hit "OK" on the Options dialog. To upload directly to the web is slightly more involved, see these directions.

8) Optional: if you want to see the result, view the .OBJ with G3D, the .WRL with MeshLab, or use some other 3D model viewer.

Not clear? Read over the quick reference page or watch the first minute of this quick introduction to see what's what, then this and this for advanced tips. You can find more tutorials on the video playlist.

Problems? Look below for platform-specific problems on Windows, Mac, and Linux, then see the Troubleshooting Guide that follows if those don't help.

3D Printing: To preview your exported model to see if it's what you want, open the .wrl/.obj/.stl file with MeshLab or other model viewer. If you want to 3D print your model and don't have a 3D printer (or want a multicolored model), create a free Shapeways account and upload the .zip file. Once the model is processed by Shapeways (a few minutes), you can order it - make sure to select "Sandstone" and "Full Color" for the material.

As an example, here's my non-profit store. Note that no part of this process will cost you anything, unless you order something. Sculpteo is another 3D print service worth considering (see my sample store). It's generally more expensive but often delivers more rapidly (even shipping from France!). There are other 3D print services such as 3D Hubs; see a list here.

Rendering: see this section for how to import your model into various rendering and animation systems.

What to try next: work through the documentation page to learn more about other export options. The information is roughly in order of importance. In particular, for 3D printing, check out the "Export lesser blocks" option, which lets you get more detail. This feature is not on by default because it has some risks, so read about them there.

Platform-Specific Problems and Fixes

Windows

Can't download Mineways itself? First thing to try: open up an Incognito tab and download from the homepage. If that doesn't work, try using a different browser. Sometimes antivirus software will not allow you to download Mineways (and sometimes it won't even tell you it's "protecting" you). Chrome and other browsers may give you "minewaysVxxx.zip is not commonly downloaded and may be dangerous" with a "Discard" button next to it. Hit the "^" to the right of that and choose "Keep." Alternately, download the Mineways minimal version, which shouldn't give the warning. Everything else in the main zip is for adding new resource packs, automating processes, etc. Mineways.exe is all you need most of the time. Me, I'm trustworthy. The Mineways code is open source. That said, do make sure you're downloading Mineways from this site, mineways.com (which renames to https://erich.realtimerendering.com/minecraft/public/mineways/, because I'm a cheapskate).

If you have problems with exporting, first try not changing any export options. Some tutorial videos give various options to click in the export dialog. For the most part, the default options should get you something reasonable to start with, and changing them might even cause a crash in Mineways (since there are so many permutations, it is hard for me to test them all).

If you get an error about MSVCR140.DLL being missing or "VCRUNTIME140_1.dll was not found" or "api-ms-win-runtime-l1-1-0-.dll" not found or similar, install the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 for your system. Select vc_redist.x64.exe if you have a 64-bit system, vc_redist.x86.exe for a 32-bit system. You may also need to reboot. (Not sure what system type you have? Press the Windows key+I, select "System", select "About" at the bottom, and look at "System type" under "Device specifications"). Sorry for this annoyance, but Microsoft does not make this easy, and the problem even has a name. Microsoft will misleadingly say "Reinstalling the program may fix this problem" - it won't. Installing the redistributable will. Still having weird problems on startup? Try looking for system corruption, advice from this post. Note: For Mineways 5.10 and earlier, you may get an error about MSVCR120.DLL being missing; install the Visual Studio 2013 (VC++ 12.0) redistributable.

If you get "Windows protected your PC" when running Mineways, click on "More info" and then "Run anyway". I'm trustworthy, but feel free to run the mineways.exe executable through VirusTotal to feel safe. Note that this site sometimes reports that VBA32 will find BScope.Backdoor.IRCBot on the Mineways ZIP itself - looking at individual files, mineways32.exe (now "for_old_machines_Mineways32.exe") appears to be the one causing this warning. Note that VBA32 is just 1 of 71 antivirus packages run on the code, so I believe this is a false positive, since the other 70 packages clear it. Read about false positives here. I've written the VBA32 people about this problem; no response. If you are still concerned, download the Mineways minimal version, which shouldn't give the warning. Also, I noticed that VirusTotal is now saying that the file for_old_machines_Mineways32.exe has the virus Gen:Variant.Razy.582623. I have no idea what that is about; I think it's a false positive but cannot find more information about it on Google. If someone else knows different, clue me in. I have asked about it here.

If you get "Error writing to export file; partial file output" (and "PNG error: failed to open file for writing") when you try to save an export, it's likely that antivirus software (such as Avast) is blocking Mineways. You need to give Mineways permission to write documents. See the item above if you want to test Mineways for viruses. Another possibility is that the directory path you gave Mineways is somehow confusing it. Try exporting to some directory that is simpler, such as c:\temp (which you may need to create, of course).(Thanks to Repty for figuring out the antivirus solution.)

Mineways understands only worlds created in the Minecraft: Java (aka Classic) Edition. If it doesn't find your worlds, you may be using the Bedrock Edition on Windows 10. If your level.dat files are located in a directory with the path ..."\AppData\Local\Packages\Microsoft.Minecraft"... in it, or have weird directory names like "ZAD1Xfl9AAA=", that's a Bedrock Edition save. You can easily convert worlds from the Bedrock to the Java Edition so that Mineways can read them.

If Mineways doesn't run for you, make sure you've got the latest version, downloaded the whole .zip file (it should be about 24 megabytes), that you have unzipped the file to some directory, and that you're running mineways.exe. Read on for more things to try.

If Mineways gives you an error on startup or gets stuck mid-export, try Mineways32 (aka "for_old_machines_Mineways32.exe"). If that doesn't work any better, double-click (i.e., run) the file mineways_min_debug.bat (you might not see the ".bat" on your system). This will start up without loading the list of worlds, and create a file mineways_exec.log while running Mineways. After Mineways crashes or doesn't start or fails, etc., take a look at this file. Whatever is happening at the end of it may give you a hint. If not, send it on to me for analysis. You might also try mineways_debug_log.bat, which starts up normally (loads your list of worlds), unlike mineways_min_debug.bat, but still creates a debug log file.

Is your first language not English? Mineways (especially Sketchfab export) can have problems with accented characters. If, after checking into antivirus blockers, it fails to run or save, try unpacking Mineways into a directory with a short name such as C:\temp and try running it and saving there.

If a particular world is not loading, note that Mineways is unlikely to work on modded worlds. Mineways assumes certain things about how blocks can connect, and if those rules are modified, all bets are off.

If you find you scroll the map and the program crashes, or you crash when exporting, it's likely you're out of memory. Ideas: close down all other applications you have running; use Mineways32.exe instead of Mineways.exe, which limits map memory usage to about 2 gigabytes; under "Help" select "Give more export memory!"

If you are still using Windows XP, the last version that will work for you is 4.17.

One user had a problem where the left mouse did not drag the map. He found unzipping the zip again fixed it - strange. Me, I'd also try rebooting.

Still stuck? See the General Troubleshooting section below for other common problems.

Feel free to write me if you still have problems. The more you describe what you've tried, what happened or didn't happen, and what type of computer you're on (Windows 10, Mac, etc.), the more chance I have of helping you.

Mac

To use Mineways on the Mac, download Mineways 11.04 on Wineskin (370 Mb), which runs on Big Sur (thanks, Hypersun_pro/Froxcey!). You'll likely get a message that this pkg cannot be opened because it is from an unidentified developer. If you instead right-click the pkg file and select "Open" and confirm, you can then install it. The steps done to make the Mineways Mac version are shown in this tutorial.

Other options: you can use Wine if you know what you're doing. Another option is PlayOnMac, which is free. Using it, run Mineways32.exe in the Windows distribution (now called "for_old_machines_Mineways32.exe"), the 32-bit version.

Other options that may work include VMware Fusion, which is free to students and home users (i.e., you), and Parallels, which has a free trial.

Another option is to use Crossover, which costs money, but does have a free 14-day trial (and the promo code "CX64BIT" gives you a 25% discount). I've briefly tried this out, and it's a bit confusing to set up, but does work. You don't "install" Mineways, the program just runs. What I did was "create a new bottle," (lower left corner of main window) then "Run Command..." and pick mineways32.exe (now "for_old_machines_Mineways32.exe")- this worked. Crossover does not appear to work on the 64-bit version of Mineways.

Yet another way is to use Boot Camp, which lets you boot your Mac as a Windows 10 machine. This is a pretty serious commitment, but will certainly work.

By default, Mineways now uses its own tile textures that are stored in the program itself. Other "terrainExt.png" can be used - a number of these come with the program. Use "File | Set Terrain File" and select the terrainExt.png in /users/<your name>/Downloads/MinewaysMac or wherever you put Mineways. You might need to search for these files, just use Spotlight and search on "terrainExt.png". The other terrainExt*.png files will be found in this directory.

When you save, go to the directory /Users/<your name>/Documents to save. Note that the 32-bit version of Mineways cannot export huge areas that the 64-bit version can. This normally doesn't matter for 3D printing, since you want to keep the models small. If you do find you're out of memory, try the "Give more export memory!" option under Help, which clears out the map cache before trying to export the area you've selected.

Otherwise the Mac version is the same as the PC version, and Mac users can similarly use MeshLab or GLC Player for viewing exported 3D models. See the main documentation page for (way) more help on using Mineways in general.

Troubleshooting for the Mac

If you get the warning "'Mineways' can't be opened because the identity of the developer cannot be confirmed." take steps similar to those explained here. The short version: right-click and select "Open," then verify that you want to run the program. Yes, I'm trustworthy.

If when opening a world it says that the file name cannot contain the characters "/ : < > or |", change your world's folder name so that it doesn't contain these characters. Mineways is a Windows program masquerading as a Mac program, and Windows does not allow any of these characters in file names.

If you get the message "Couldn't find your Minecraft world saves directory..." you'll need to guide Mineways to wherever your world files are saved on your computer. Follow these instructions. If you are using a Mac with a language that is not English, Mineways may still have problems with the path to your files. One solution is to copy your world files to C:\TEMP or some other short, English folder name - this avoids the path problems. Another solution may be to temporarily change the language to English.

If you get "Error creating export file; no file output" or "PNG error: failed to open file for writing," try saving to a simple directory name. Mineways is a Windows application underneath it all, so elaborate directory paths with special characters can confuse it. Making a simple directory name and saving to it fixes this problem.

If you can't see the Application Support/minecraft folder, see this page for how to use the terminal utility to make it visible - old article, but one of those is bound to work. Short version (which should still work): search for "terminal" in Spotlight, copy and paste this line into the terminal:

	defaults write com.apple.Finder AppleShowAllFiles TRUE

and then hit Enter. Then type or paste this line:

	killall Finder

to restart the finder. You can find your saves folder by opening Finder -> Go -> Go To Folder -> type ~/Library/Application Support/minecraft/saves. For future reference, it's best to make an alias for this folder and copy it to your desktop.

Selection is done with right-click; if you are using a trackpad or your mouse cannot right-click, hold down the Control key and left-click, or see this page for more options.

Still stuck? See the General Troubleshooting section below.

Feel free to write me if you have problems. The more you describe what you've tried, what happened or didn't happen, and what type of computer you're on (Windows 10, Mac, etc.), the more chance I have of helping you.

Linux

For Linux, download the Windows version and then use WINE to emulate Windows. You should be able to use the normal 64-bit mineways.exe, according to users and this FAQ. Note: Wine also works on the Mac; the downloadable Mac version here is the Windows version plus the Wine executables wrapped around it. That said, some Ubuntu Linux users have had problems (that I haven't figured out - something about GetMessage...). Linux is not "supported" by Mineways; I don't have Linux on any machine, I've never tried Mineways on Linux, I've been told it sometimes works. Crossover for Linux may work for you (see my Mac instructions above) - let me know. One other bit of advice: try starting up with "mineways -s none" if you get a warning about the worlds directory not being found.

Troubleshooting

General Troubleshooting Guide

If something goes wrong, here's the checklist I go through with people:

  • Did you download the latest version? Mineways has undergone many bug fixes.
  • Did you read any warnings from the program carefully?
  • Reboot your computer and try the program one more time, just to be sure. Sometimes starting fresh clears out some box inadvertently checked, or untangles some hidden operating system bug.
  • Run through the platform-specific problems for Windows, Mac, and Linux.
  • Try starting from the command line, e.g., "mineways -s none".

Here are some common problems:

  • "I tried to export a large area of my world but ran out of memory" - The way around this is to export smaller sections of your world in a series, then load the resulting files. You can precisely make a set of exports by using scripting. See this example script for what to put. Better still, use the hunk_maker.py that comes with Mineways to generate the script for you. Just open that file in a text editor, then read it and follow the instructions there.
  • "I double-click on Mineways, it seems to run but doesn't appear" - This is often due to some (still mysterious to me) path problem with where your worlds are located. Instead of double-clicking on Mineways.exe, double-click on the file "mineways_without_worlds" (you might see it end in ".bat"). You'll have to open your worlds manually by finding the right directory. You can easily do this by using File | Open... and then pasting in this for the file name: %appdata%\.minecraft\saves - choose a world directory and select the level.dat file there to open it.
  • "I tried to export a large area but Mineways ran out of memory or otherwise failed" - First, use mineways.exe and not mineways32.exe (now "for_old_machines_Mineways32.exe"), if you can - the latter is for Windows 32, an old operating system with serious memory limits. Next, try selecting "Give more export memory!" under the "Help" menu and then export. If that fails, you can use scripting to export your world as separate "hunks."
  • "I chose the map fine, but the screen is all gray" - first, try hitting F2 (jump to spawn) and F3 (jump to player) and see if that helps get you to the right spot on your map. Next, you have the latest version of Mineways, right? The latest version is needed to support the newest version of Minecraft, and beta versions of Minecraft can cause problems.
  • "I use the insert-name-here mod and Mineways doesn't work with it" - Sorry, Mineways likely never will, see this explanation for why mod support is hard.
  • "I don't like your torches/flames/etc." - you can remove any block from export by using a color scheme, then put your own models in place. You can use color schemes for all sorts of tricks, e.g., export your model a few times, with different options for the blocks you want to export. To change the textures on a block, use "Export tiles for textures" and edit the individual texture output. You might also look into MCprep if you use Blender.
  • "I read the OBJ file Mineways made into Blender and objects like grass and flowers are surrounded in black." Read the Blender import documentation, especially step 9.
  • "The blocks have funny fringes around them, especially as I get farther away from them." This is likely a mipmapping artifact. Try exporting using the option "Export separate textures" to avoid it. See here on down for more on mipmapping.
  • "I selected a color scheme and the program locked up and died!" - my advice is to delete all your color schemes and remake them. Sorry about that! I thought I had licked this bug, but it might still be there under some circumstances.
  • "I uploaded to Shapeways, but they say my model could not be processed" - read their email carefully. Sometimes, however, they'll have no additional hints. First, you uploaded the .ZIP file, right? It should have a .wrl and .png file inside of it. Second thing to try: upload the .ZIP file again - I've sometimes had a model rejected which I then upload again and it's fine. Third thing: try exporting with the option "Weld all shared edges" checked. This may affect how your model looks, so preview it, but it does give a more robust (and stronger) model that Shapeways likes. Do not normally bother with trying STL instead of VRML; STL will not print at Shapeways with color.
  • "I uploaded to Shapeways, but on the model page it says the model is tiny" - on the Shapeways upload page where it says "Unit of Measure" and "Choose", the default is millimeters (though Shapeways has changed this in the past). Make sure the "Model's units" on the export dialog says "Millimeters".
  • "It (still) doesn't work" - write me if you still have problems. The more you describe what you've tried, what happened or didn't happen, and what type of computer you're on (Windows 10, Mac, etc.), the more chance I have of helping you.
  • "I get a long error message about Mineways not finding my worlds directory, then nothing else shows up." I'm not sure the cause of this one, but it's been seen when running on Linux. Starting Mineways by doing "mineways -s none" has been known to get around this problem.

Known Bugs

See the open issues for known bugs and feature requests.

How I Make a 3D Print Export

I'm assuming you have basic knowledge from the quick-start guide and can find options on the output dialog. If you need more information on a process, just follow the links or search this page for the term.

For me it starts with determining whether the model is printable at all: if it has elements that are floating in the air, then I either don't print it, or will add blocks to hold these elements up in the air when printed. If there are thin columns holding up larger elements, I have to guess whether these thin columns will be able to support the weight or will break. Even trees will often break off, because their trunks are too thin to stand up to the cleaning process.

If printable, I then decide what part of a model to print. If there's construction below ground level that I want to expose, how deep do I want to go? Should the model get printed as two or more pieces, so I can see the rooms inside? If the model is symmetrical, should I print just half or a quarter of the model and show the interior that way?

Once I've figured out what to capture, there are then a few steps I walk through:

  • First I do a rough selection of the volume of the model. I select an area, export, and view by double-clicking on the WRL file produced. I then adjust the bounds by grabbing the border of the selection in Mineways with the right-mouse and dragging, and use the "[" and "]" keys to adjust the bottom's height, then use Control-X to instantly re-export. I export again, then in MeshLab hit R to reload the model. Lather, rinse, repeat until I like the result I'm seeing in preview.
  • I'll check the price and see if it's affordable. If so, great. If it's too high, then I try out the ideas in this section. My mantra in all this is "smaller is cuter is cheaper". Complexity is free when doing 3D printing, cost is based entirely on the number and size of the blocks, not their positions. The downside of smaller block sizes is that you can't see the textures on them as well. The upside is that you get fine details that are more impressive; larger blocks look easier to make.
  • If I get the warning that there are floating pieces, I check them out in the preview (there's a special debug mode if they're not obvious) and usually just remove them by cranking up the "Delete floating objects" number, as shown in this tutorial. This number is low by default, 16, as otherwise large pieces could be discarded without the user realizing it. 16 was chosen mostly so that floating bits of trees overlapping into the scene would be discarded. You can crank this number to 999999 and only the largest connected object will be saved.
  • Since cost is based on the model's weight (volume), my main thought is "how can I get rid of any blocks I'll never see?" The major part of the work is then making sure unseen rooms are sealed off, so that Mineways can do its job removing them. The easiest way to do this is to add torches to the entrances of rooms and then use the "Seal off entrances" option on the export dialog. What should then happen is that these sealed rooms get filled with glass, then the hollowing process will delete them. Note that you can play in and change your world while also running Mineways, just hit the "R" key in Mineways to reload your world with your changes.
  • Do I want to remove glass? If I want to look inside the building and it has glass in the windows, the glass should go (it doesn't print as transparent). Using a color scheme removes the glass, as described in this video tutorial (note that if you use glass panes, you should remove those, too). The downside of removing glass is that costs usually go up, since rooms won't then get removed by hollowing.
  • Does filling in the tunnels look better? I'll try the option "Fill in isolated tunnels in base of model" and see how things look on the outside: do I mind having these tunnels filled in? I'll also check the cost and see how much money this option saves me (the price is always lower).
  • Should I use the "Export lesser blocks" option? If I have fine details I think would look cool and I don't think they'll break off in printing, then I turn it on.
  • Should I use another texture pack? I'm still experimenting in this area, and in practice the printing process won't pick up on many fine details (I'm guessing about 8x8 pixel resolution detail at 2 mm/block; at 3 mm/block the details show up well), but certainly the colors and contrast of a texture pack makes a difference. See this section about how to create and use terrainExt.png files.