BlueMap-Anleitung: eine 3D-Webkarte für deinen Minecraft-Server

Was BlueMap ist

BlueMap liest deine Weltdateien, rendert sie zu 3D-Kartenkacheln und stellt sie über einen kleinen eingebauten Webserver bereit. Nah herangezoomt siehst du die Blöcke in vollem 3D, weit herausgezoomt eine flache Übersicht. Live-Marker zeigen, wo Spieler sind, und die Karte aktualisiert sich, wenn sich die Welt verändert.

Es rendert nur Welten der Java Edition. Die aktuelle Version, BlueMap 5.29, gibt es für:

Für eine ältere Minecraft-Version lädst du eine ältere BlueMap-Version herunter, die sie aufführt. Jede Version auf Modrinth und Hangar zeigt, welche Versionen sie unterstützt.

BlueMap installieren

1. Lade die passende Datei für deinen Server von Modrinth, Hangar oder den GitHub-Releases von BlueMap herunter: die -paper-jar für Paper, -fabric für Fabric und so weiter.
2. Lege sie in den Ordner plugins (Paper, Spigot) oder mods (Fabric, Forge, NeoForge) und starte den Server neu. Wie du Plugins hochlädst, steht in Minecraft-Plugins installieren.
3. BlueMap legt seine Konfiguration in plugins/BlueMap/ an, auf Modded-Servern in config/bluemap/, mit einer bereits eingerichteten Karte für jede deiner Welten.

Jetzt meldet die Konsole, dass BlueMap wartet. Es rendert nichts, bis du den Download akzeptierst – das ist der nächste Schritt.

Den Download in core.conf akzeptieren

Um Blöcke darzustellen, braucht BlueMap die Texturen und Modelle aus dem Minecraft-Client, die es bei Mojang herunterlädt. Öffne core.conf und ändere:

accept-download: true

Damit akzeptierst du die EULA von Mojang und bestätigst, dass du Minecraft Java Edition besitzt. Speichere die Datei und führe /bluemap reload aus oder starte neu. BlueMap lädt die Ressourcen herunter und beginnt zu rendern.

Der Webkarte einen eigenen Port geben

Der Webserver von BlueMap lauscht standardmäßig auf Port 8100. Auf deinem eigenen Rechner öffnest du diesen Port und rufst http://your-ip:8100 auf. Auf gehosteten Servern kannst du meist keinen Port frei wählen, also nutzt du einen, der deinem Server zugewiesen ist:

1. Besorge dir einen zweiten Port für deinen Server. Bei HytHost öffnest du im Panel den Tab Network und fügst eine Zuweisung hinzu: Das Panel wählt einen freien Port und öffnet ihn für dich.
2. Öffne webserver.conf und setze port auf diese Nummer:

   port: 25570

3. Führe /bluemap reload aus und öffne http://your-server-ip:25570 im Browser.

Nutze nicht den Spielport – der gehört Minecraft. Um die Karte ohne Portnummer unter deiner eigenen Domain zu zeigen, setze einen Reverse Proxy wie nginx davor; die Dokumentation von BlueMap hat fertige Beispiele.

BlueMap-Befehle

Jeder Befehl hat eine Berechtigung der Form bluemap.<command>, zum Beispiel bluemap.reload. Meistens brauchst du keinen davon: BlueMap bemerkt Änderungen in der Welt und rendert sie von selbst.

Das Rendern leicht halten

BlueMap rendert in Hintergrund-Threads, nicht im Haupt-Thread des Servers, aber Rendern kostet trotzdem CPU. Der erste Render einer großen Welt ist der aufwendige Teil; danach werden nur geänderte Chunks neu gezeichnet.

• Render-Threads: Setze render-thread-count in core.conf. Die Dokumentation von BlueMap empfiehlt 1 auf Maschinen mit vier Kernen oder weniger.
• Rendern, wenn es ruhig ist: Führe zu Stoßzeiten /bluemap stop aus und nachts /bluemap start, solange der erste Render läuft.
• Pausieren, wenn Spieler online sind: player-render-limit in plugin.conf stoppt das Rendern, sobald so viele Spieler online sind.
• Setze eine Weltbarriere. Sie verhindert, dass die Karte – und die Renderarbeit – endlos wächst, während Spieler erkunden.
• Friere Karten ein, die du nicht live brauchst, etwa das End, sobald es erkundet ist.

Speicher: Dateien oder eine Datenbank

Standardmäßig speichert BlueMap die Karte als komprimierte Dateien in bluemap/web/maps, im Speicher deines Servers. Die Karte wächst mit dem erkundeten Gebiet, behalte bei einer großen Welt also den Speicherplatz im Auge.

Du kannst eine Karte stattdessen in eine Datenbank verlegen. Lege in storages/sql.conf die Verbindung zu MySQL, MariaDB, PostgreSQL oder SQLite fest, setze dann storage: "sql" in der Konfigurationsdatei der Karte und lade neu:

connection-url: "jdbc:mysql://DB_HOST:3306/DB_NAME"
connection-properties: {
    user: "DB_USER",
    password: "DB_PASSWORD"
}

Paper bringt einen MySQL-Treiber mit; für Spigot, Fabric und Forge musst du einen JDBC-Treiber hinzufügen. Jedes HytHost Minecraft-Paket enthält MySQL-Datenbanken, die du im Tab Databases des Panels anlegst.