2017-04-10 10:18:14 +00:00
|
|
|
====================================
|
2012-10-12 14:40:48 +00:00
|
|
|
Minecraft Overviewer |Build Status|
|
2017-04-10 10:18:14 +00:00
|
|
|
====================================
|
2011-04-13 15:15:19 +00:00
|
|
|
By Andrew Brown and contributors (see CONTRIBUTORS.rst).
|
2010-08-28 22:02:14 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
Documentation:
|
|
|
|
http://docs.overviewer.org
|
2010-09-04 23:38:31 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
Github code repository:
|
2017-04-10 10:18:14 +00:00
|
|
|
https://github.com/overviewer/Minecraft-Overviewer
|
2014-02-27 21:35:42 +00:00
|
|
|
|
2012-10-12 16:18:12 +00:00
|
|
|
Travis-CI:
|
2017-04-10 10:18:14 +00:00
|
|
|
https://travis-ci.org/overviewer/Minecraft-Overviewer
|
2014-02-27 21:35:42 +00:00
|
|
|
|
2012-02-09 20:49:06 +00:00
|
|
|
Blog:
|
2017-04-10 10:18:14 +00:00
|
|
|
https://overviewer.org/blog/
|
2012-02-09 20:49:06 +00:00
|
|
|
|
2010-08-28 22:02:14 +00:00
|
|
|
|
2023-04-05 16:40:23 +00:00
|
|
|
**PLEASE NOTE: Overviewer is currently unmaintained. PRs will not be merged
|
|
|
|
and issues will not be addressed. The website and repository will remain online
|
|
|
|
and accessible.**
|
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
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
|
2016-06-28 15:01:22 +00:00
|
|
|
uses Leaflet to display a nice interactive map.
|
2010-09-22 02:37:45 +00:00
|
|
|
|
2014-06-04 11:23:30 +00:00
|
|
|
The Overviewer has been in active development for several years and has many
|
2011-10-24 20:36:19 +00:00
|
|
|
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.
|
2011-04-13 13:14:27 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
Getting Started
|
|
|
|
---------------
|
|
|
|
All documentation has been consolidated at our documentation site. For
|
|
|
|
information on downloading, compiling, installing, and running The Overviewer,
|
|
|
|
visit the docs site.
|
2010-09-22 02:51:12 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
http://docs.overviewer.org
|
2010-09-07 15:56:29 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
A few helpful tips are below, but everyone is going to want to visit the
|
|
|
|
documentation site for the most up-to-date and complete set of instructions!
|
2010-09-07 15:56:29 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
Alternatively, the docs are also in the docs/ directory of the source download.
|
|
|
|
Look in there if you can't access the docs site.
|
2010-09-27 03:04:12 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
Examples
|
|
|
|
--------
|
|
|
|
See examples of The Overviewer in action!
|
2010-09-04 23:38:31 +00:00
|
|
|
|
2011-10-24 20:36:19 +00:00
|
|
|
https://github.com/overviewer/Minecraft-Overviewer/wiki/Map-examples
|
2011-04-13 13:14:27 +00:00
|
|
|
|
2010-09-04 23:38:31 +00:00
|
|
|
Disclaimers
|
|
|
|
-----------
|
2010-09-15 23:07:00 +00:00
|
|
|
Before you dive into using this, just be aware that, for large maps, there is a
|
|
|
|
*lot* of data to parse through and process. If your world is very large, expect
|
2010-09-25 05:33:39 +00:00
|
|
|
the initial render to take at least an hour, possibly more. (Since Minecraft
|
2010-09-15 23:07:00 +00:00
|
|
|
maps are practically infinite, the maximum time this could take is also
|
|
|
|
infinite!)
|
|
|
|
|
|
|
|
If you press ctrl-C, it will stop. The next run will pick up where it left off.
|
|
|
|
|
|
|
|
Once your initial render is done, subsequent renderings will be MUCH faster due
|
|
|
|
to all the caching that happens behind the scenes. Just use the same output
|
|
|
|
directory and it will only update the tiles it needs to.
|
2010-09-04 23:38:31 +00:00
|
|
|
|
|
|
|
There are probably some other minor glitches along the way, hopefully they will
|
|
|
|
be fixed soon. See the `Bugs`_ section below.
|
2010-08-28 22:02:14 +00:00
|
|
|
|
2010-09-25 05:33:39 +00:00
|
|
|
Viewing the Results
|
|
|
|
-------------------
|
|
|
|
Within the output directory you will find two things: an index.html file, and a
|
|
|
|
directory hierarchy full of images. To view your world, simply open index.html
|
2016-06-28 15:01:22 +00:00
|
|
|
in a web browser.
|
2010-09-25 05:33:39 +00:00
|
|
|
|
2016-06-28 15:01:22 +00:00
|
|
|
You can throw these files up to a web server to let others view your map.
|
2010-09-16 01:17:37 +00:00
|
|
|
|
2021-08-05 16:51:11 +00:00
|
|
|
Bedrock and other formats
|
|
|
|
=========================
|
|
|
|
|
|
|
|
Minecraft Overviewer only supports the world format from the Java edition of Minecraft.
|
|
|
|
Minecraft Bedrock (the Windows 10 version) is not supported by Overviewer, but users
|
|
|
|
have reported success using `Amulet <https://www.amuletmc.com/>`__ to convert
|
|
|
|
Bedrock worlds to the Java format, and then used Overviewer to render the converted
|
|
|
|
worlds.
|
|
|
|
|
2010-08-28 22:02:14 +00:00
|
|
|
Bugs
|
|
|
|
====
|
2010-09-04 23:38:31 +00:00
|
|
|
|
|
|
|
For a current list of issues, visit
|
2011-10-24 20:36:19 +00:00
|
|
|
https://github.com/overviewer/Minecraft-Overviewer/issues
|
2010-09-04 23:38:31 +00:00
|
|
|
|
|
|
|
Feel free to comment on issues, report new issues, and vote on issues that are
|
2011-10-24 20:36:19 +00:00
|
|
|
important to you.
|
2010-09-15 23:07:00 +00:00
|
|
|
|
2016-01-15 21:30:49 +00:00
|
|
|
.. |Build Status| image:: https://secure.travis-ci.org/overviewer/Minecraft-Overviewer.svg?branch=master
|