Missing terrain.png

Minecraft Overviewer uses actual textures to render your world. However, these textures are not included in the Minecraft Overviewer package, so you need to provide it yourself. All it really needs is the terrain.png out of the official minecraft.jar or from a custom texture pack.

For the Overviewer to find a suitable terrain.png, you have several options:

• If you have the Minecraft client installed, The Overviewer will automatically use the textures that come with Minecraft. This is a good solution, since the Minecraft Launcher will always keep this file up-to-date and you don't have to do anything extra.

  • If you're running Overviewer on a server, you can still put the minecraft.jar file into the correct location and Overviewer will find and use it (even if the rest of the client is missing). On Linux, you can easily do this with a command like wget

    <code>wget -N http://s3.amazonaws.com/MinecraftDownload/minecraft.jar -P ~/.minecraft/bin/</code>
    

• You can manually extract the terrain.png file from Minecraft and place it in the same directory as overviewer.py or overviewer.exe. This makes the most sense if you're installed Overviewer via source, or if you've downloaded a Windows binary. If you're installed Overviewer via the APT repository, this probably won't work.

• You can put a terrain.png file anywhere you want, and point to it with the --textures-path option (which should point to the directory containing terrain.png).

  • This is a good option if you want to use a custom texture pack. To do this, extract the terrain.png from the texture pack's zip file, and then specify its path on the command line to the Overviewer with --textures-path.

Note:

• The --check-terrain option can be helpful for debugging terrain.png issues. For example:

$ ./overviewer.py --check-terrain
2011-09-26 21:51:46,494 [INFO] Found terrain.png in '/home/achin/.minecraft/bin/minecraft.jar'
2011-09-26 21:51:46,497 [INFO] Hash of terrain.png file is: `6d53f9e59d2ea8c6f574c9a366f3312cd87338a8` 

$ ./overviewer.py --check-terrain --textures-path=/tmp
2011-09-26 21:52:52,143 [INFO] Found terrain.png in '/tmp/terrain.png'
2011-09-26 21:52:52,145 [INFO] Hash of terrain.png file is: `6d53f9e59d2ea8c6f574c9a366f3312cd87338a8`