BlueMap — plugin pro generování interaktivní 3D mapy světa v prohlížeči pro Minecraft

BlueMap — plugin pro generování interaktivní 3D mapy světa v prohlížeči pro Minecraft

BlueMap je plugin pro Minecraft, který čte soubory světa a vytváří z nich trojrozměrný model povrchu, přístupný v prohlížeči přes vestavěný webový server. Standardní klient renderuje svět pouze kolem hráče a neposkytuje pohled shora nebo zvenčí. Plugin vytváří kompletní mapu s možností otáčet kamerou, přepínat do perspektivního nebo izometrického (plochého) režimu a prohlížet struktury pouhým přechodem na URL. Řeší jeden úkol: externí prohlížení serverového světa bez nutnosti přihlašovat se do hry.

Jak funguje renderování

Plugin rozděluje chunky na dlaždice a generuje dvě úrovně detailů: hires modely s plnou geometrií bloků a lowres mapu pro vzdálený pohled. Hires je aktivní při blízkém přiblížení — tehdy jsou vidět konkrétní bloky, textury a výšky. Při větším oddálení se načte zjednodušená vrstva s barevnými skvrnami biomů a krajinou.

Proces renderování ve webovém rozhraní: dlaždice se při přiblížení načítají postupně. 

Renderování probíhá asynchronně v samostatném fondu vláken. Vlákno serveru Minecraft se přitom neblokuje — dokud má procesor volná jádra, hráči nepocítí žádné zpoždění ze sestavování mapy. Plugin sám sleduje změny ve světě: BlueMap pravidelně kontroluje soubory mca, všímá si změněných chunků a přerenderovává pouze je. Ruční příkazy jako /bluemap update jsou potřeba zřídka — hlavně pro diagnostiku.

Renderování ve webovém rozhraní z pohledu první osoby 

Příkazy

Plugin registruje jeden kořenový příkaz /bluemap s dílčími příkazy. Většina případů nevyžaduje žádný příkaz — renderování funguje automaticky.

Provedení příkazu /bluemap 

Konfigurace

Složka pluginu obsahuje čtyři konfigurační soubory: core.conf, plugin.conf, webapp.conf, webserver.conf. Dále tři podsložky: maps/ (jeden .conf pro každý svět), packs/ (balíčky zdrojů pro renderování) a storages/ (file.conf pro souborový systém, sql.conf pro SQL databázi).

core.conf

Hlavní soubor. Klíčovým parametrem je accept-download, který je nutné při prvním spuštění nastavit na true. Parametr render-thread-count (výchozí 1) nastavuje počet renderovacích vláken — záporná hodnota znamená «počet jader CPU minus absolutní hodnota čísla». metrics (true) řídí odesílání anonymních statistik.

plugin.conf

Parametry viditelnosti hráčů na mapě a chování renderování:

webapp.conf

Nastavení webové aplikace. default-to-flat-view (false) určuje počáteční zobrazení — perspektivní nebo izometrické. Posuvníky hires-slider-default (100) a lowres-slider-default (2000) nastavují vzdálenost pro detailní a zjednodušené renderování v blocích. resolution-default (1) přijímá hodnoty 0.5, 1 nebo 2. Pole scripts a styles připojují vlastní soubory JS a CSS.

webserver.conf

Vestavěný webový server. enabled (true) — zapnout nebo vypnout. port (8100) — port. webroot ("bluemap/web") — adresář se soubory webové aplikace (musí se shodovat s webroot ve webapp.conf). Sekce log konfiguruje záznam HTTP aktivity do souboru.

Závěr

BlueMap dává možnost externího prohlížení světa ve formátu plnohodnotného 3D modelu s rotací kamery a volným letem. Plugin je vhodný pro survival a RPG servery, kde je pro hráče důležité sdílet souřadnice a prohlížet si budovy; pro minigame servery bez stálého světa je zbytečný.