Skip to content

erich666/Mineways

Repository files navigation

Mineways, a Minecraft mapper and exporter

by Eric Haines, erich@acm.org

begun 11/14/2011

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 Mineways. You probably want to go to the homepage above.

Simple example export rendered by spacebanana420

Download

Visit the project homepage for executables for Windows and MacOS.

Documentation links, credits, etc are also avaliable 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.

You usually want the latest version. If you have problems with it, you might try an older version.

Compiling

Source files are here:

  • Win/ contains the Windows version of Mineways (in C++).
  • 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.

Windows

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.

Sorry, other platforms are not directly supported, though Mineways runs fine under WINE and we also provide a Mac-specific version.

If you want to work on the mapping part of this program on another platform, see Minutor, which is supported on Mac and Linux.

License

Mineways uses the same license as Minutor.

McUsd: JG-RTX textures, rendered in Omniverse USD Composer

Mineways and JG-RTX used to make a test scene asset for the USD file format. Rendered with Omniverse USD Composer.