Originally by Eric Haines, erich@acm.org — begun 11/14/2011
This is a fork of erich666/Mineways that adds a native macOS port. See the Releases page for macOS downloads and the CHANGELOG for release notes.
Mineways is an open-source GUI program that exports Minecraft maps into 3D models for use in 3D software, printing and rendering. Mineways supports most Minecraft: Java Edition versions and offers many settings and functionality to customize the map export to your needs.
Homepage is http://mineways.com which redirects to https://www.realtimerendering.com/erich/minecraft/public/mineways/
The page you're on now holds the open-source code for a macOS fork of Mineways. You probably want to go to the homepage above for the original Windows version. For pre-built macOS downloads from this fork, see the Releases page.
Visit the project homepage for the latest Windows executables. For macOS, download from this fork's Releases page.
Documentation links, credits, etc are also available on the homepage. Much of the mapping and UI code is built on the open-source project Minutor.
Mineways does not have a Linux build, but it runs well under WINE. See more here for Linux. This fork provides a native macOS build; see the Releases page.
You usually want the latest version. If you have problems with it, you might try downloading an older version. All upstream releases of the code back to v3.01 are on Github.
Source files are here:
- Win/ contains the Windows version of Mineways (in C++).
- Mac/ contains the native macOS version of Mineways (using
wxWidgets). - ChannelMixer/ contains the ChannelMixer for Mineways, which extracts the individual block textures from a mod resource pack into a directory.
- TileMaker/ contains the TileMaker, which takes the block in that directory and forms a terrainExt.png file for use by Mineways. Using this allows you to replace any terrain textures with your own custom tiles.
Mineways comes with executables, but if you prefer, you can compile Mineways with Visual Studio Community 2022:
- Install the "Desktop development with C++" workload
- Go to "Individual components", search on "MFC", and choose "C++ MFC for latest v143 build tools (x86 & x64)".
- Open Mineways.sln in Visual C++, switch the target to "Release" and "x64", then Build | Rebuild Solution.
You should then find a mineways.exe in GitHub\Mineways\x64\Release\Mineways.exe
For more on Visual Studio 2022 and C++, see Microsoft's tutorials.
To compile the native macOS app:
- Install dependencies via Homebrew:
brew install wxwidgets - Run
make -C Mac appfrom the project root. - You will find
Mineways.appinside theMac/directory. Note that the resulting app is unsigned.
For distribution-ready builds that bundle all dylibs into the .app, also install dylibbundler (brew install dylibbundler) — this is what the GitHub Actions CI workflow uses to produce self-contained release artifacts.
Sorry, other platforms like Linux are not directly supported, though Mineways runs fine under WINE.
If you want to work on the mapping part of this program on another platform, see Minutor, which is supported on Mac and Linux.
Mineways uses the same license as Minutor.
Mineways and JG-RTX used to make a test scene asset for the USD file format. Rendered with Omniverse USD Composer.