BlueMap - A 3d-map of your Minecraft worlds view-able in your browser using three.js (WebGL)

#1

This is a discussion topic for the Ore project, BlueMap. View the full project on Ore for downloads and more information.

title-banner
bluemap-title.jpg1000Ă—300

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).

This Sponge-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 still in a really early development state!

Many features are still missing, and some blocks - especially tile-entities - will not render correctly.
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 :slight_smile:

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. 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] bluemap.rendertask.create.world renders the whole world
[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 displays all data bluemap has of a block

Resource-packs

BlueMap tries to load every resource-pack (folder or zip-compressed) it finds in the config/bluemap/resourcepacks-folder in alphabetical order.

If you change resource-packs you will very likely have to delete your web-data folder (bluemap/web/data by default) and completely re-render all your maps. You also might have to clear your browser cache ^^

Read more about this in the wiki!

Mod integration

You can configure bluemap so it can render blocks that have been added by mods!
This feature is in early development, so this might still be a little challenging to do. Read the wiki about how to do this.

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 tile-entities (chests, etc…)
  • render entities
  • configurable markers / regions
  • marker / region API
  • free-flight-controls
  • live player positions
  • shaders for dynamic day/night
  • more configurations
  • better mod-integration-support (or an easy way for modders to do so themselves)
  • BlueMap as spigot plugin
  • BlueMap as forge mod
  • more render-tasks (commands to render parts of your world)
  • ability to display the world-border

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!

4 Likes
#2

A new version has been released for BlueMap, it is available for download here.

Targets:

  • SpongeAPI: 7.1.0

Notes:

This is the first pre-release with absolute basic functionality and currently only as Sponge-Plugin.

Changelog:

–

1 Like
#3

Just saw the demo and it seems pretty epic to me. Is this available for non Sponge too?

#4

Not yet, but the CLI is almost ready to use… Give me a week or so ^^
With that you will be able to render any world-folder from the command-line or start the integrated web-server. The CLI will also support 1.13/1.14 worlds :slight_smile:

#5

Just tried your demo, and especially for an alpha, this is a very cool plugin. So fast.

The biggest problem with world viewers or map generators I’ve had in the past (think: dynmap) is with custom blocks from other mods. Will this accurately display, say, ComputerCraft computers, etc?

Thanks.

#6

Currently: no. :smiley:
In the future: depends on the mod and if the mod is supported…

Basically, to render a block BlueMap needs the full resource for that block, formatted like in a resource pack (…blockstates/block_id.json, …models/block/model_id.json, …/textures/block/texture_id.json) … and for 1.12 BlueMap also needs a mapping (like this) between the numeric block id and meta and the blockstate.

So for 1.13+ BlueMap might be able to extract all the information it needs from the mod.jar in the mods folder of the server if it includes those assets (computercraft does).
For 1.12 however the mapping will have to be added somehow to read those blocks correctly. I will probably add the possibility to configure that mappings in a config or similar.

Also, if the mod does something fancy with it’s blocks that is not represented in those resource-files, BlueMap will not (and most likely never) render that block correctly.

I hope that answers your question :slight_smile:

1 Like
#7

Im gonna try it on my 1.12.2 server

1 Like
#8

So i am very interested in this project! though i have a question.

I use multiple “worlds” as sort of “zones” for my players.
does this have multi/custom word support?

#9

Yes! You can define as much maps for as much worlds as you like in the configuration file :slight_smile:
In the browser application you can then choose between the different maps with a drop-down menu.

1 Like
#10

That is great to know!

Thank you :slight_smile:

1 Like
#11

A new version has been released for BlueMap, it is available for download here.

Targets:

  • CLI
  • SpongeAPI: 7.1.0

Notes:

Added CLI-support! Render your 1.12-1.14 worlds simply from the command-line: java -jar BlueMap-0.1.0.jar.

Improved resource-loading. The SpongePlugin now loads it’s resources async to the server-thread so your server won’t freeze while reloading.

BlueMap also now loads resourcepacks from a specific folder. This is experimental, expect things to go wrong if you use a resourcepack! Also if you change resourcepacks you will very likely need to delete your web-data folder and re-render the whole maps!

Changelog:

  • Added CLI-support
  • Changed some config-keys (v0.0.0 configs should be compatible)
    • Moved web.data to web.web-data
    • Added data
  • Moved the scheduled tiles and tasks save-file to the folder defined by the new data config
  • Moved the downloaded client.jar to the folder defined by the new data config and renamed it to minecraft-client-1.14.4.jar
  • Moved loading the BlueMap-Sponge plugin off the server-thread
  • Fixed a bug where vines were always generated with the block-property top=true on 1.12 worlds
2 Likes
#12

My resource pack is a 64x64 pack.
Is it compatible; and or will it have a large impact on performance?

#13

For the map-rendering the resolution of the resource-pack has no impact on performance at all, except some more ram usage. In the browser there might be a performance impact, but i guess it’s not more than if you have high-resolution textures in minecraft.
If it is compatible i can not tell you, you’ll have to install it, render the map and see if it works.
Don’t forget to remove any existing renders and clear your browser cache if possible :slight_smile:
Since i am working on resourcepacks in this moment, you could also tell me what resource-pack you are using and ill try it myself ^^

1 Like
#14

My resource pack is a custom pack that i am working on.
Here is the (very much incomplete) pack
https://github.com/hellbringer616/Strix-The-Realm/blob/master/Strix_Resource_Pack.zip

#15

Aah, wait! Sorry! I completely forgot to mention that resource-packs currently have to be compatible with the Minecraft 1.14 format for resource-packs!
So this one will unfortunately not load right now… :slightly_frowning_face: sorry

#16

Oh is this a 1.14 plugin??? I had no idea there was even a sponge for 1.14

#17

No, there is no sponge for 1.14 yet, but BlueMap is already designed with 1.13+ in mind and made backwards-compatible for 1.12 worlds. That’s why a lot of things already work “the 1.13+” way. ^^

#18

Good to know! I will be porting to 1.14 once my RPG-API (and Sponge of course) update; until then it’ll be default resources!

1 Like
#19

Hi, I followed the instructions and installed bluemap. I activated the downloaded and completed a render task of the main world but the webpage only shows a black screen with a “loading” sign in the center. what have i done incorrectly and how can i fix it? any ideas?

thanks.

#20

Hmm, I need to add some error handling to the web-app …
Can you open the browser-console and give me any output / errors when loading the webpage?