This is a discussion topic for the Ore project, BlueMap. View the full project on Ore for downloads and more information.
BlueMap is a tool that generates 3d-maps of your Minecraft worlds and displays them in your browser. Take a look at this demo. It is really easy to set up - almost plug-and-play - if you use the integrated web-server (optional).
The Sponge/Spigot-Plugin automatically updates your map as soon as something changes in your world, as well as rendering newly generated terrain and managing the render-tasks.
BlueMap is currently in an early development state!
A lot of features are still missing, and some blocks - especially some tile-entities - will not render correctly/at all. See below for a list of what is planned for future releases.
Getting started
BlueMap is mostly plug-and-play. Just install it like every other Sponge-Plugin and start your server. BlueMap will then generate a config-file for you in the ./config/bluemap/ folder. Here you can configure your maps and the web-server.
Please read the wiki for more information!
If you need help with the setup, feel free to join the Discord-server, i’ll be happy to help you there!
Metrics and Webserver
Bluemap uses bStats and an own metrics-system and is hosting a web-server!
Metrics are really useful to keep track of how the plugin is used and helps me stay motivated! Please turn them on 
bStats: All data collected by bStats can be viewed here: https://bstats.org/plugin/sponge/BlueMap. bStats data-collection is controlled by the metrics-setting set in sponges configuration! (Turned off by default)
own metrics: Additionally to bStats, BlueMap is sending a super small report, containing only the implementation-name and the version of the BlueMap-plugin to my server (https://metrics.bluecolored.de/bluemap). I do this, because there are some other implementations for BlueMap (like the CLI) that are not supported by bStats. Here is an example report:
{
"implementation": "Sponge",
"version": "0.0.0"
}
This data-collection is also controlled by the metrics-setting set in sponges configuration! (Turned off by default)
web-server: The web-server is a core-functionality of this plugin. So it is enabled by default but can be disabled in the plugin-config. By default the web-server is bound to the standard ip-address on port 8100 and is hosting the content of the ./bluemap/web/-folder.
Commands and Permissions
| command | permission | description |
|---|---|---|
| /bluemap | bluemap.status | displays BlueMaps render status |
| /bluemap reload | bluemap.reload | reloads all resources, configuration-files and the web-server |
| /bluemap pause | bluemap.pause | pauses all rendering |
| /bluemap resume | bluemap.resume | resumes all paused rendering |
| /bluemap render [world] [block-radius] | bluemap.rendertask.create.world | renders the whole world or optionally a defined radius around the player |
| [clickable command in /bluemap] | bluemap.rendertask.prioritize | prioritizes the clicked render-task |
| [clickable command in /bluemap] | bluemap.rendertask.remove | removes the clicked render-task |
| /bluemap debug | bluemap.debug | prints some debug info about the blocks at the players position |
Todo / planned features
Here is an (surely incomplete) list of things that i want to include in future versions. (They are not in any specific order. There is no guarantee that any of those things will ever be included.)
- render more tile-entities (banners, shulker-chests, etc…)
- render entities (armor-stands, item-frames, maybe even cows and such…)
- configurable markers / regions
- marker / region API
- free-flight-controls
- live player positions
- more configurations
- easier mod-integration
- BlueMap as forge mod
- ability to display the world-border
- animated textures (if feasible)
- add support for models in obj format (if feasible)
Issues / Suggestions
You found a bug, have another issue or a suggestion? Please create an issue on GitHub!
You are also very welcome to join the Discord-server!
sorry