The Minecraft Overviewer¶
New! See New features in version 0.9
The Minecraft Overviewer is a command-line tool for rendering high-resolution maps of Minecraft worlds. It generates a set of static html and image files and uses the Google Maps API to display a nice interactive map.
The Overviewer has been in active development for over a year and has many features, including day and night lighting, cave rendering, mineral overlays, and many plugins for even more features! It is written mostly in Python with critical sections in C as an extension module.
- Renders high resolution images of your world, let’s you “deep zoom” and see details!
- Gloriously awesome smooth lighting is here!
(rendermode name is
- Customizable textures! Pulls textures straight from your installed texture pack!
- Choose from four rendering angles.
- Generates a Google Maps powered map!
- Runs on Linux, Windows, and Mac platforms!
- Renders efficiently in parallel, using as many simultaneous processes as you want!
- Only requires: Python, Numpy, and PIL (all of which are included in the Windows download!)
- Utilizes caching to speed up subsequent renderings of your world. Only parts that need re-rendering are re-rendered.
- Throw the output directory up on a web server to share your Minecraft world with the internet!
- Run The Overviewer from a command line or on a cron schedule for constantly updated maps! Run it for your Minecraft server world to provide your users with a detailed map!
New features in version 0.9¶
- Supports the new Anvil level format of Minecraft 1.2
- Multi-world! Render all your worlds and dimensions with a single unified interface and configuration file.
- Per-render configuration options - render one world multiple ways, render all your worlds one way, or some complex combination. It’s up to you!
- Supports Nether and The End dimensions.
- New configuration file format. More flexibility and function!
- Build your own rendermodes out of rendermode primitives (see Custom Rendermodes and Rendermode Primitives)
- Fixed north directions
- Built-in support for Biomes!
- Vastly cleaned-up codebase.
What The Overviewer is not¶
Full disclosure disclaimers of what The Overviewer is not.
It does not run fast. Because of the high level of detail, initial renders of a world can take some time. Expect minutes for medium worlds, hours for large to huge worlds. Subsequent renders are much faster due to the caching.
Also note that speed is improving all the time. We continually make efficiency improvements to The Overviewer. Besides, for the level of detail provided, our users consider it worth the time!
The Overviewer is not targeted at end users. We mainly see Overviewer fitting in best with server operators, rendering their server’s map for all users to view.
You are welcome to use The Overviewer for your single player worlds, and it will work just fine. However, since the only interface is currently command line based, you will need to know a bit about the command line in order to operate The Overviewer.
This is a quick list of what’s required to run The Overviewer. It runs on Windows, Mac, and Linux as long as you have these software packages installed:
- Python 2.6 or 2.7 (we are not yet compatible with Python 3.x)
- PIL (Python Imaging Library)
- Either a Minecraft Client installed or a terrain.png for the textures.
The first three are included in the Windows download. Also, there are additional requirements for compiling it (like a compiler). More details are available in either the Building or Installing pages.
The Overviewer works with Linux, Mac, and Windows! We provide Windows and Debian built executables for your convenience. Find them as well as the full sources on our Github Homepage.
If you are running Windows, Debian, or Ubuntu and would like the pre-built packages and don’t want to have to compile anything yourself, head to the Installing page.
Running Windows and not familiar with the command line? Head to the Windows Newbie Guide page.
If you would like to build the Overviewer from source yourself (it’s not that bad), head to the Building page.
For all other platforms you will need to build it yourself. Building the Overviewer from Source.
IF YOU NEED HELP COMPILING OR RUNNING THE OVERVIEWER feel free to chat with us live in IRC: #overviewer on Freenode. There’s usually someone on there that can help you out. Not familiar with IRC? Use the web client. (If there’s no immediate response, wait around or try a different time of day; we have to sleep sometime)
Also check our Frequently Asked Questions page.
If you think you’ve found a bug or other issue, file an issue on our Issue Tracker. Filing or commenting on an issue sends a notice to our IRC channel, so the response time is often very good!
- Building the Overviewer from Source
- Running the Overviewer
- The Configuration File
- Signs and Markers
- Windows Newbie Guide
- Frequently Asked Questions
- Design Documentation