From a957d0b0975639b06751961aaa2d93703e09027f Mon Sep 17 00:00:00 2001 From: Andrew Brown Date: Sun, 26 Sep 2010 23:04:12 -0400 Subject: [PATCH] clarified texture issue in readme. Misc changes Added check for python >=2.6 Added current directory and program directory to paths to search for minecraft.jar --- README.rst | 20 ++++++++++++++++++++ gmap.py | 7 +++++-- textures.py | 2 ++ 3 files changed, 27 insertions(+), 2 deletions(-) diff --git a/README.rst b/README.rst index 2f1f509..39ba237 100644 --- a/README.rst +++ b/README.rst @@ -23,6 +23,9 @@ Features * Renders large resolution images of your world, such that you can zoom in and see details +* Customizable textures! Pulls textures straight from your installed texture + pack! + * Outputs a Google Map powered interface that is memory efficient, both in generating and viewing. @@ -41,6 +44,8 @@ This program requires: * Python 2.6 or 2.7 * PIL (Python Imaging Library) * Numpy +* Either the Minecraft client installed, or a terrain.png file. See the + `Textures`_ section below. I develop and test this on Linux, but need help testing it on Windows and Mac. If something doesn't work, let me know. @@ -65,6 +70,21 @@ directory and it will only update the tiles it needs to. There are probably some other minor glitches along the way, hopefully they will be fixed soon. See the `Bugs`_ section below. +Textures +-------- +The Overviewer uses actual textures to render your world. However, I don't +include textures in the package. You will need to do one of two things before +you can use the Overviewer: + +* Make sure the Minecraft client is installed. The Overviewer will find the + installed minecraft.jar and extract the textures from it. + +* Install a texture file yourself. This file is called "terrain.png" and is + normally found in your minecraft.jar file (not "Minecraft.jar", the launcher, + but rather the file that's downloaded by the launcher and installed into a + hidden directory). You can also get this file from any of the third party + texture packs out there. + Running ------- To generate a set of Google Map tiles, use the gmap.py script like this:: diff --git a/gmap.py b/gmap.py index 2b33f3a..22048d2 100755 --- a/gmap.py +++ b/gmap.py @@ -1,4 +1,4 @@ -#!/usr/bin/python +#!/usr/bin/env python # This file is part of the Minecraft Overviewer. # @@ -15,9 +15,12 @@ # You should have received a copy of the GNU General Public License along # with the Overviewer. If not, see . +import sys +if sys.version_info[0] != 2 and sys.version_info[1] < 6: + print "Sorry, the Overviewer requires at least Python 2.6 to run" + sys.exit(1) import os -import sys import os.path from optparse import OptionParser import re diff --git a/textures.py b/textures.py index cc49b35..ef75a0c 100644 --- a/textures.py +++ b/textures.py @@ -59,6 +59,8 @@ def _find_file(filename, mode="rb"): "Application Support", "minecraft","bin","minecraft.jar")) jarpaths.append(os.path.join(os.environ['HOME'], ".minecraft", "bin", "minecraft.jar")) + jarpaths.append(programdir) + jarpaths.append(os.getcwd()) for jarpath in jarpaths: if os.path.exists(jarpath):