RunningOnWindows

Running TopoMC under Windows is not supported. That being said, this is what I did and it worked for me.

VS2010, Python, GDAL

I installed Virtual Studio 2010 Express for another project. This may be helpful if you decide to use the compiled NBT code in pymclevel. I have not yet tested this feature so I do not know exactly how to make it work. If anyone does get this going, please let me know what you did!

I installed the 64-bit version of Python 2.7.3 from http://www.python.org/getit/ to match my 64-bit version of Windows 7. I then went to http://www.gisinternals.com/sdk/ where I clicked on "release-1600-x64-gdal-1-9-1-mapserver-6-0". This page contains links for GDAL itself (gdal-19-1600-x64-core.msi) and the Python bindings (GDAL-1.9.1-win-amd64-py2.7.msi). I installed first GDAL and then the bindings.

At this point I modified the Path variable to contain the locations of GDAL, Python, and the Python scripts directory -- C:\Program Files\GDAL;C:\Python27;C:\Python27\Scripts got stuck at the end of the existing variable.

Python Dependencies

I went to http://www.lfd.uci.edu/~gohlke/pythonlibs/ for most of the remaining dependencies, including numpy-MKL, scipy, pywin32, and pyyaml. cython is required to build the aforementioned optimization in pymclevel, and pyopencl is required to use the OpenCL optimizations -- alas, my laptop can't run OpenCL so I don't know whether it works or what else is required on the Windows front. If anyone does get this working, please let me know so I can update the wiki!

I downloaded ez_setup.py from http://peak.telecommunity.com/dist/ez_setup.py and ran it in order to install easy_install. I then used easy_install to install suds, since it's not available from LFD.

GitHub for Windows and git commands

Now that GDAL, Python, and all their dependencies are installed, I installed GitHub for Windows from http://windows.github.com/ which included a Powershell install. Once that install completed, I visited the web page https://github.com/mathuin/TopoMC and clicked the 'Clone to Windows' button. Once the clone finished, I opened the Powershell (right-click on the repository, select 'open a shell here') and ran the following commands:

• git checkout develop
• git submodule init
• git submodule update

These commands switch to the develop branch (the most recent code with all the fixes), initialize the submodules (currently just pymclevel), and update those same submodules (checking out the proper version of pymclevel).

This is the point where on Linux I would change to the pymclevel directory and run the setup_nbt.py build command, but I do not know whether or not that is necessary on Windows. Give it a try. Let me know. :-)

Let's Make Some Maps!

At this point TopoMC is ready to roll. From this same shell, try the following commands:

• ./GetRegion.py --name Provincetown --ymax 42.0901 --xmin -70.2611 --ymin 42.0091 --xmax -70.1100
• ./PrepRegion.py --name Provincetown
• ./BuildRegion.py --name Provincetown

Now use Windows Explorer to cruise around the Regions directory. It should contain a subdirectory named Provincetown. This subdirectory should contain directories named Datasets and Tiles, and files named Map.tif and Region.yaml. The Worlds directory should contain a subdirectory named Provincetown which contains the generated world.

Now What?

Zip that directory up and extract it in your Minecraft saves directory, and open Minecraft. You should see a new nap in single-player named Provincetown. Open it up, and the game will convert the map to Anvil format. (This last bit is temporary until pymclevel or something else starts supporting the creation of Anvil worlds.) Quit as soon as you enter the game, and the world is now ready for anything from MCEdit to multiplayer. Enjoy!!

Stuff to fix in this document

I need to figure out exactly what's necessary to make the accelerated NBT module in pymclevel work.

I need to figure out exactly what's necessary to make the OpenCL optimizations work.