Works with Minecraft Java Edition v1.2.1 - v1.21.x
The Minecraft Overviewer is a command-line tool for rendering high-resolution maps of Minecraft Worlds.\ It generates a set of static HTML Image files and uses LeafletJS to display an interactive map.
While The Minecraft Overviewer was in active development for nearly a decade by the original developers, they have stopped development; leading to the community to take over the project and work to continue development.
Mostly written in Python with critial sections written in C as an extension module.
You can visit docs.overviewer.org to view the entire documentation of The Minecraft Overviewer.
This Repo will soon have a Wiki that will better reflect the documentation.
For large maps, there is a lot of data to parse through the process. If your world is very large, expect the initial render to take at least an hour to render, or possibly even days.
Since Minecraft Maps can be infinite, the maximum time this could take is also infinite.\ Keep this in mind for large worlds.
While Overviewer can be run directly from the command line, it's generally easiest to set up a configuration file and running script once that you can then use whenever you want to update your map, so that's what we'll go over here. It's worth noting that this guide is designed for use on Windows computers.
Step 1: Download the latest zipped release from Github.
Step 2: Download the sample configuration and batch files.
Step 3: Unzip the downloaded files. You can put them wherever you like on your system.
Step 4: Edit RunOverviewer.bat using your favorite text editor (Notepad works great).
Step 5: Edit ConfigOverviewer.txt
Step 6: You're ready to run! Double-click the RunOverviewer.bat file to begin. It will open a terminal window, and then you can press the key directed to continue and start the render. As mentioned above, if this is the first time you're running the render, it could take hours or possibly even days. Don't worry, updating the map after the initial run is much faster.
Step 7: Once it completes, you can go to the folder you instructed it to place the output in and open "Index.html" to view the map. To share with others, you can give them the whole folder, or host it online!
In the future: To update your map, just double-click the RunOverviewer.bat file again. Overviewer will automatically check your world to find out where things have changed, and only update those parts of the map.
A great place to start is the old docs. They aren't being updated anymore, but since this repo's Wiki is still a work in progress, they're a great tool and nearly all the information in them is still accurate.
Another option is to reach out on the Overviewer Discord! There you can find a friendly, helpful community. Please read the rules in the #Rules channel before messaging.
Within the output directory you've specified, you will find:
You can upload these files on a web server and let others view your map.
The Minecraft Overviewer only supports the world format from the Java Edition of Minecraft.\ Minecraft Bedrock worlds are not supported.
Using a tool such as Amulet to convert your Bedrock Worlds into Java Edition Worlds has been reported to work.\ But, the results may vary.