Minecraft-Plugin BlueMap

🔌 Über BlueMap

BlueMap ist ein Minecraft-Mapping-Tool, das die Weltdateien des Servers liest und 3D-Modelle sowie einen interaktiven Web-Viewer erzeugt. Es kann als Server-Plugin oder Mod laufen (Spigot/Paper- oder Sponge-Plugin, Fabric/Forge-Mod) oder als eigenständiger Renderer über die Kommandozeile. Wenn BlueMap auf einem laufenden Server installiert ist, rendert es asynchron, sodass der Haupt-Server-Thread nicht blockiert wird.

🎯 Zweck

BlueMap bietet eine im Browser zugängliche, dreidimensionale Darstellung einer Minecraft-Welt, damit Administratoren und Spieler das Gelände erkunden, Strukturen finden und Bauten ansehen können, ohne dem Server beizutreten. Es richtet sich an Serverbetreiber, die eine aktuelle visuelle Karte für Verwaltung, Navigation oder zur Präsentation der Community benötigen.

⚙️ Funktionen

• Erstellt 3D-Modelle der Weltoberfläche und stellt sie in einem browserbasierten Web-Viewer bereit.
• Läuft als Plugin/Mod (Spigot/Paper, Sponge, Fabric, Forge) oder als eigenständiges CLI-Tool.
• Asynchrones Rendern, damit der Minecraft-Server-Thread nicht blockiert wird.
• Unterstützt Resource Packs und Data Packs, um Texturen, Blockmodelle und Biomfarben für Renderings anzupassen.
• Unterstützt mehrere Speicher-Backends und Kartenverwaltung per Befehlen (load, unload, list, delete usw.).
• Marker-Unterstützung und eine API, damit Plugins von Drittanbietern Marker auf Karten hinzufügen oder verwalten können.
• Befehle zum Neuladen und zur Laufzeitsteuerung des Renderns (reload, Rendering starten/stoppen, Karten aktualisieren/löschen, Karten einfrieren/auftauen).

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die eine öffentliche oder adminseitige 3D-Karte möchten.
• Creative- oder Showcase-Server, die browserzugängliche Vorschauen von Builds brauchen.
• Serveradministratoren, die Remote-Inspektion und kartenbasierte Navigationstools benötigen.

🏗️ Beispielanwendungen

• Spielern eine öffentlich gehostete 3D-Karte der Welt bereitstellen, um die Navigation zu erleichtern und Builds zu präsentieren.
• Ein Admin findet und prüft von Spielern gebaute Basen oder Claims im Web-Viewer, bevor er sie im Spiel besucht.
• Ein Plugin nutzt die API von BlueMap, um dynamische Marker für Events, Shops oder Teleportpunkte anzuzeigen.

⌨️ Befehle

(Alle oben genannten Befehle sind im Projekt dokumentiert; die genauen Berechtigungsknoten sind in der Projektdokumentation enthalten und werden hier nicht wiederholt.)

⚙️ Installation

📥 Einrichtung

• Lade die passende BlueMap-JAR für deine Plattform herunter (Plugin-JAR für Spigot/Paper/Sponge, Mod-JAR für Fabric/Forge oder eigenständige CLI-Distribution).
• Lege die JAR in den Serverordner plugins/ (für Spigot/Paper/Sponge) oder mods/ (für Fabric/Forge) oder verwende die Dateien der CLI-Distribution für eigenständiges Rendern.
• Starte oder starte den Server neu. Beobachte die Serverkonsole, um zu bestätigen, dass BlueMap und der eingebettete Webserver erfolgreich gestartet wurden.

📦 Abhängigkeiten

• Für das grundlegende Kartenrendering werden keine verpflichtenden externen Plugin-Abhängigkeiten benötigt. Es gibt optionale Integrationen und Add-ons; siehe die Projektdokumentation für Informationen zu Add-ons von Drittanbietern.

🧠 Technische Hinweise

• BlueMap wird als Server-Plugins, Mods und CLI-Tool verteilt; wähle das Artefakt, das zu deinem Setup passt.
• Das Rendern erfolgt asynchron, um den Haupt-Server-Thread nicht zu blockieren.
• Resource Packs und Data Packs können in das konfigurierte Packs-Verzeichnis gelegt werden, um das Aussehen der Karte zu ändern.
• Das Projekt pflegt ein öffentliches Quellcode-Repository und Release-Builds; die Konfiguration ist dateibasiert und kann zur Laufzeit neu geladen werden.

🤝 Wann dieses Plugin nützlich ist

Wenn du eine browserzugängliche, dreidimensionale Ansicht deiner Minecraft-Welt für Navigation, Bauprüfung oder Community-Präsentation brauchst, bietet BlueMap automatisches Rendering, Laufzeitsteuerung und eine API für Marker und Integrationen, ohne dass Spieler dem Server beitreten müssen.