Kenneth: /* Minecraft Overviewer */

2015-11-29T01:58:58Z

Minecraft Overviewer

New page

=== Minecraft Overviewer ===

Minecraft Overviewer - https://github.com/overviewer/Minecraft-Overviewer

North facing issue: https://github.com/brownan/Minecraft-Overviewer/issues/48

This program requires:
* Python 2.6 or 2.7 <http://python.org/download/>
* PIL (Python Imaging Library) <http://www.pythonware.com/products/pil/>
* Numpy <http://scipy.org/Download>
* Either the Minecraft client installed, or a terrain.png file. See the
`Textures`_ section below.

Install Python 2.7.5:
mkdir -p ~/.src ; cd ~/.src
wget http://www.python.org/ftp/python/2.7.5/Python-2.7.5.tgz
tar -zvxf Python-2.7.5.tgz
cd Python-2.7.5
./configure --prefix=$(echo ~)/overviewer-python
make clean && make && make install
export PATH=$(echo ~)/overviewer-python/bin:$PATH

Install PIL:
# prerequisite for MO requirement: (zlib libraries) REQUIRED!
sudo yum -y install zlib-devel libjpeg-devel
# sudo apt-get install libjpeg-dev zlib1g-dev
mkdir -p ~/.src ; cd ~/.src
wget http://effbot.org/downloads/Imaging-1.1.7.tar.gz
tar -zvxf Imaging-1.1.7.tar.gz
cd Imaging-1.1.7
python setup.py build # check dependencies are meet
python setup.py install

# if have to repeat
python setup.py clean
python setup.py build --force
python setup.py install
# Missing: TKINTER, FREETYPE2, LITTLECMS
# Supported: JPEG, ZLIB (PNG/ZIP)

WARNING: Install zlib-devel or you will get this error when running Overviewer: ''IOError: decoder zip not available''

On Ubuntu you may have to do this fix: [http://stackoverflow.com/questions/7648200/pip-install-pil-e-tickets-1-no-jpeg-png-support] [http://ubuntuforums.org/showthread.php?t=1751455&p=10811107#post10811107]
# #ubuntu-fix freetype/fterrors.h# cd /usr/include ; ln -s freetype2 freetype
apt-get install libzzip-dev libjpeg-dev
sudo ln -s /usr/lib/x86_64-linux-gnu/libfreetype.so /usr/lib/
sudo ln -s /usr/lib/x86_64-linux-gnu/libz.so /usr/lib/
sudo ln -s /usr/lib/x86_64-linux-gnu/libjpeg.so /usr/lib/

Install numpy:
# dependency:
sudo yum -y install git
mkdir -p ~/.src ; cd ~/.src
git clone git://github.com/numpy/numpy.git numpy
cd numpy
# git tag -l
git checkout v1.7.1
python setup.py install

Test libraries:
cd ~
echo "import PIL" | python
echo "import numpy" | python # don't try from within numpy source path
# expect no errors and no response if successful

Make folders and get assets:
mkdir -p ~/.minecraft/bin ~/.minecraft/saves/
# COPY [DESKTOP]\%appdata%\.minecraft\.bin\minecraft.jar TO ~/.minecraft/bin/
VERSION=1.6.2
wget https://s3.amazonaws.com/Minecraft.Download/versions/${VERSION}/${VERSION}.jar -P ~/.minecraft/versions/${VERSION}/

# mkdir -p ~/.minecraft/bin ~/.minecraft/saves/
#rm -f ~/.minecraft/saves/World1
# ln -s /home/minecraft/[WORLD]/world ~/.minecraft/saves/World1
# Copy jar (from an updated client) to bin:
# # %appdata%\.minecraft\bin\minecraft.jar
# # C:\Documents and Settings\kenneth\Application Data\.minecraft\bin\minecraft.jar
# cp [...]/minecraft.jar ~/.minecraft/bin/
# for i in $( seq 1 10 ) ; do echo "copy minecraft.jar to ~/.minecraft/bin/" ; done

Install Minecraft Overviewer:
# git clone https://github.com/rmrector/Minecraft-Overviewer MO # rotate map
# git clone https://github.com/brownan/Minecraft-Overviewer.git MO # original
cd ~
git clone git://github.com/overviewer/Minecraft-Overviewer.git overviewer
cd overviewer
cp ~/.src/Imaging-1.1.7/libImaging/Imaging.h .
cp ~/.src/Imaging-1.1.7/libImaging/ImPlatform.h .
python setup.py build
python overviewer.py # test - shows help
# ~/overviewer-python/bin/python overviewer.py
# ./overviewer.py # test

Update Minecraft Overviewer:
cd overviewer
git fetch
git pull
git checkout .
python setup.py build
python overviewer.py # test - shows help

# cp /some/path/minecraft.jar .minecraft/bin/

==== Minecraft Overviewer Execution ====

Execution:
# overviewer.py [OPTIONS] <World # / Name / Path to World> <tiles dest dir>
python overviewer.py --rendermodes=normal,lighting,night,spawn,cave 1 /www/minecraft/map

Alternatives:
python overviewer.py ~/iago/world /www/minecraft/map
/home/minecraft/python/bin/python /home/minecraft/overviewer/overviewer.py --rendermodes=normal,lighting,night,cave ~/iago/world /www/minecraft/map

Crontab:
0 3 * * * ~/genmap.sh

~/genmap.sh:
<pre>
#!/bin/sh

MAP_HOME=/www/minecraft
USER_HOME=/root
PYTHON=/opt/python26/bin/python

THEDATE=`date`

function header {
cat > $MAP_HOME/index.html <<EOF
<html>
<head>
<title>Minecraft Server Maps</title>
</head>
<body>

<h1>Minecraft Server Maps</h1>

<p>Maps generated ${THEDATE}</p>

EOF
}

function footer {
cat >> $MAP_HOME/index.html <<EOF

</body>
</html>
EOF
}

function genmap {
# Minecraft-Overviewer
echo $1
rm -f $USER_HOME/.minecraft/saves/World1
ln -s $USER_HOME/$1/world $USER_HOME/.minecraft/saves/World1
cd $USER_HOME/overviewer
nice $PYTHON ./overviewer.py --rendermodes=normal,lighting,night,spawn,cave 1 /www/minecraft/$1
echo "<p><a href="$1">Overview Map: $1</a></p>" >> $MAP_HOME/index.html
}

header
genmap mc
footer
</pre>

Minecraft/Overviewer - Revision history

Kenneth: /* Minecraft Overviewer */