Minecraft-Plugin dynmap

🔌 Über Dynmap

Dynmap ist eine Familie aus Minecraft-Plugins und -Mods, die Echtzeit-Webkarten für Minecraft-Server bereitstellt. Es rendert Kartenkacheln geladener Welten und bietet eine interaktive Kartenoberfläche, die Marker, Bereiche, Linien, Live-Spielerpositionen und Chat-Ballons anzeigen kann. Dynmap unterstützt den Betrieb des internen Webservers oder den Export von Kartendaten für externes Hosting und bietet mehrere Speicher-Backends.

🎯 Zweck

Der Kernzweck von Dynmap besteht darin, Serveradministratoren und Spielern über einen Browser eine Live- und navigierbare Ansicht des Servergeländes und der Aktivitäten zu geben. Es löst das Problem, Weltstrukturen zu visualisieren, Spielerstandorte zu verfolgen, Serverkarten für Nutzer zu veröffentlichen und mit Markern und Regionen kommentierte Karten zu erstellen.

⚙️ Funktionen

• Echtzeit-Kachel-Rendering von Serverwelten (mehrere Kartenansichten und Render-Modi).
• Konfigurierbare Marker, Bereiche und Linien zum Kommentieren von Karten für Spieler oder Teammitglieder.
• Live-Spieler-Tracking und optionale Chat-Ballons / Web-zu-Game-Chat-Integration.
• Mehrere Speicher-Backends: Flatfiles, MySQL/SQLite/PostgreSQL/MariaDB und AWS-S3-Unterstützung für Karten-/Webspeicher.
• Integrierter Webserver zum Bereitstellen der Kartenoberfläche; kann angepasst werden, um statische Website-Inhalte in externen Speicher zu veröffentlichen/hochzuladen.
• Plattformübergreifende Builds: separate Artefakte für Spigot/Paper, Forge und Fabric.

🧩 Für wen es gedacht ist

• Serverbesitzer und Administratoren, die eine durchsuchbare Karte ihrer Welt(en) möchten.
• Öffentliche SMP- und Survival-Server, die Karten für Spieler veröffentlichen.
• Minigame- oder Roleplay-Server, die kommentierte Karten, Spawn-Marker oder Regions-Overlays benötigen.
• Hoster, die flexible Speicher-/Backend-Optionen (SQL oder S3) für große Karten benötigen.

🏗️ Beispielanwendungen

• Eine Live-Overworld-Karte rendern und veröffentlichen, damit Spieler sie online ansehen können.
• Städte, Shops und markante Orte mit benutzerdefinierten Markern und Flächenumrissen kennzeichnen.
• Geplante oder bedarfsorientierte Renderings neu erkundeter Chunks ausführen (Radius- oder Vollwelt-Renderings).

⌨️ Befehle

(Hinweis: Dynmap bietet in der offiziellen Dokumentation einen größeren Satz an Karten- und Konfigurationsbefehlen.)

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Laden Sie das offizielle Dynmap-JAR für Ihre Serverplattform herunter und legen Sie es im Verzeichnis plugins/ (oder mods/ für Forge/Fabric) ab.
• Starten Sie den Server neu und prüfen Sie die Serverkonsole, um zu bestätigen, dass Dynmap geladen wurde und seine Konfigurations- sowie Kartenordner erstellt hat.
• Konfigurieren Sie Karten, Marker, Speicher-Backend und Webserver-Optionen in den bei der ersten Ausführung erstellten Dynmap-Konfigurationsdateien.

📦 Abhängigkeiten

• Dynmap-Builds enthalten Unterstützung für JDBC-Treiber in vielen Spigot/Paper-Distributionen; andere Plattformen benötigen möglicherweise zusätzliche Treiber oder Kompatibilitäts-Mods für SQL-Backends.
• Integrations-Plugins (z. B. WorldGuard, Towny, Citizens) werden über separate Dynmap-Integrationen bereitgestellt; sie sind keine zwingenden Laufzeitabhängigkeiten.

🧾 Konfiguration

• Dynmap verwendet YAML-Konfigurationsdateien, die beim ersten Start erstellt werden. Die Konfiguration steuert Karten, Rendering-Einstellungen, Markersets, Speicher-Backend und das Verhalten des Webservers.
• Unterstützte Speicher-Backends sind Flatfiles, MySQL, SQLite, PostgreSQL, MariaDB und optional AWS-S3-Speicher zum Hosten von Kartendaten.

🧠 Technische Hinweise

• Offizielle Projektquellen bieten plattformspezifische Builds für Spigot/Paper, Forge und Fabric.
• Die Codebasis von Dynmap wird unter der Apache-2.0-Lizenz veröffentlicht.
• Das Projekt unterstützt die Ausführung unter Java 8 zur Laufzeit, während die Build-Anforderungen je nach Ziel variieren und für moderne Builds neuere JDK-Versionen erfordern können.
• Dynmap bietet veröffentlichte APIs (DynmapCoreAPI und dynmap-api), die von Integrations-Plugins verwendet werden; diese sind die stabilen Schnittstellen für Erweiterungen von Drittanbietern.

🤝 Wann dieses Plugin nützlich ist

Wenn Sie eine dauerhafte, durchsuchbare Karte Ihres Minecraft-Servers möchten (für Navigation, Spieler-Tracking oder Community-Karten), bietet Dynmap eine konfigurierbare, plattformübergreifende Lösung mit mehreren Speicher-Backends und einer umfangreichen Auswahl an Rendering- und Marker-Funktionen.