BlueMap — Plugin zur Generierung einer interaktiven 3D-Weltkarte im Browser für Minecraft

BlueMap — Plugin zur Generierung einer interaktiven 3D-Weltkarte im Browser für Minecraft

BlueMap ist ein Minecraft-Plugin, das Weltdateien liest und aus ihnen ein dreidimensionales Oberflächenmodell erstellt, das über einen integrierten Webserver im Browser zugänglich ist. Der Standard-Client rendert die Welt nur in der Nähe des Spielers und bietet keine Vogelperspektive oder Außenansicht. Das Plugin erstellt eine vollständige Karte mit der Möglichkeit, die Kamera zu drehen, in den perspektivischen oder isometrischen (flachen) Modus zu wechseln und Bauwerke durch einfachen Aufruf einer URL zu betrachten. Es löst ein Hauptproblem: die externe Betrachtung der Serverwelt ohne sich in das Spiel einloggen zu müssen.

Wie das Rendern funktioniert

Das Plugin teilt Chunks in Kacheln auf und generiert zwei Detailebenen: Hires-Modelle mit vollständiger Blockgeometrie und eine Lowres-Karte für die Fernansicht. Hires ist bei starkem Zoom aktiv — dann sind spezifische Blöcke, Texturen und Höhen sichtbar. Bei weiterem Zoom wird eine vereinfachte Ebene mit farbigen Biom-Flecken und der Landschaft geladen.

Der Rendering-Prozess in der Weboberfläche: Kacheln werden beim Zoomen schrittweise geladen. 

Das Rendern wird asynchron in einem separaten Thread-Pool ausgeführt. Der Minecraft-Server-Thread wird dabei nicht blockiert — solange die CPU freie Kerne hat, werden die Spieler keine Verzögerungen durch die Kartenerstellung spüren. Das Plugin verfolgt Änderungen in der Welt selbständig: BlueMap überprüft regelmäßig mca-Dateien, erkennt geänderte Chunks und rendert nur diese neu. Manuelle Befehle wie /bluemap update werden selten benötigt — hauptsächlich zur Diagnose.

Rendern in der Weboberfläche aus der Ego-Perspektive 

Befehle

Das Plugin registriert einen einzigen Stammbefehl /bluemap mit Unterbefehlen. Die meisten Fälle erfordern keinen einzigen Befehl — das Rendern funktioniert automatisch.

Ausführung des Befehls /bluemap 

Konfiguration

Der Plugin-Ordner enthält vier Konfigurationsdateien: core.conf, plugin.conf, webapp.conf, webserver.conf. Sowie drei Unterordner: maps/ (eine .conf pro Welt), packs/ (Ressourcenpakete für das Rendern) und storages/ (file.conf für das Dateisystem, sql.conf für eine SQL-Datenbank).

core.conf

Die Hauptdatei. Der Schlüsselparameter ist accept-download, der für den ersten Start auf true gesetzt werden muss. Der Parameter render-thread-count (standardmäßig 1) legt die Anzahl der Render-Threads fest — ein negativer Wert bedeutet «Anzahl der CPU-Kerne abzüglich des Betrags der Zahl». metrics (true) steuert das Senden anonymer Statistiken.

plugin.conf

Parameter für die Sichtbarkeit von Spielern auf der Karte und das Render-Verhalten:

webapp.conf

Einstellungen der Webanwendung. default-to-flat-view (false) bestimmt die Startansicht — perspektivisch oder isometrisch. Die Schieberegler hires-slider-default (100) und lowres-slider-default (2000) legen die Entfernung für detailliertes und vereinfachtes Rendern in Blöcken fest. resolution-default (1) akzeptiert die Werte 0.5, 1 oder 2. Die Arrays scripts und styles binden benutzerdefinierte JS- und CSS-Dateien ein.

webserver.conf

Integrierter Webserver. enabled (true) — ein- oder ausschalten. port (8100) — Port. webroot ("bluemap/web") — Verzeichnis mit Webanwendungsdateien (muss mit webroot in webapp.conf übereinstimmen). Der Abschnitt log konfiguriert die Aufzeichnung von HTTP-Aktivitäten in eine Datei.

Fazit

BlueMap bietet die Möglichkeit zur externen Betrachtung der Welt im Format eines vollständigen 3D-Modells mit Kamerarotation und freiem Flug. Das Plugin eignet sich für Survival- und RPG-Server, wo es für Spieler wichtig ist, Koordinaten zu teilen und Bauwerke zu inspizieren; für Minispiel-Server ohne dauerhafte Welt ist es überflüssig.