BlueMap-handleiding: een 3D-webkaart voor je Minecraft-server

Wat BlueMap is

BlueMap leest je wereldbestanden, rendert ze tot 3D-kaarttegels en serveert die via een kleine ingebouwde webserver. Ingezoomd zie je de blokken volledig in 3D; uitgezoomd een plat overzicht. Live markeringen tonen waar spelers zijn, en de kaart wordt bijgewerkt terwijl de wereld verandert.

Het rendert alleen Java Edition-werelden. De huidige release, BlueMap 5.29, is er in versies voor:

Voor een oudere Minecraft-versie download je een oudere BlueMap-release die die versie vermeldt. Elke release op Modrinth en Hangar laat zien welke versies hij ondersteunt.

BlueMap installeren

1. Download het bestand dat bij je server past van Modrinth, Hangar of de BlueMap-releases op GitHub: de -paper-jar voor Paper, -fabric voor Fabric, enzovoort.
2. Zet het in de map plugins (Paper, Spigot) of de map mods (Fabric, Forge, NeoForge) en herstart de server. Plugins uploaden wordt uitgelegd in Minecraft-plugins installeren.
3. BlueMap maakt zijn configuratie aan in plugins/BlueMap/, of config/bluemap/ op gemodde servers, met voor elk van je werelden al een kaart ingesteld.

Op dit moment meldt de console dat BlueMap wacht. Het rendert niets totdat je de download accepteert, en dat is de volgende stap.

De download accepteren in core.conf

Om blokken te tekenen heeft BlueMap de textures en modellen van de Minecraft-client nodig, die het bij Mojang downloadt. Open core.conf en wijzig:

accept-download: true

Door dit in te stellen accepteer je de EULA van Mojang en bevestig je dat je Minecraft Java Edition bezit. Sla het bestand op en voer /bluemap reload uit, of herstart. BlueMap downloadt de bestanden en begint met renderen.

Geef de webkaart een eigen poort

De webserver van BlueMap luistert standaard op poort 8100. Op je eigen machine open je die poort en ga je naar http://your-ip:8100. Op gehoste servers kun je meestal niet vrij een poort kiezen, dus gebruik je er een die aan je server is toegewezen:

1. Regel een tweede poort voor je server. Bij HytHost open je het tabblad Network in het panel en voeg je een allocatie toe: het panel kiest een vrije poort en opent die voor je.
2. Open webserver.conf en zet port op dat nummer:

   port: 25570

3. Voer /bluemap reload uit en open http://your-server-ip:25570 in een browser.

Gebruik niet de gamepoort; die is van Minecraft. Wil je de kaart op je eigen domein tonen zonder poortnummer, zet er dan een reverse proxy zoals nginx voor; de documentatie van BlueMap heeft kant-en-klare voorbeelden.

BlueMap-commando's

Elk commando heeft een permissie in de vorm bluemap.<command>, bijvoorbeeld bluemap.reload. Meestal heb je er geen enkele nodig: BlueMap merkt wijzigingen in de wereld op en rendert ze zelf.

Houd het renderen licht

BlueMap rendert in achtergrondthreads, niet op de hoofdthread van de server, maar renderen kost nog steeds CPU. De eerste render van een grote wereld is het zware deel; daarna worden alleen gewijzigde chunks opnieuw getekend.

• Renderthreads: stel render-thread-count in core.conf in. De documentatie van BlueMap raadt 1 aan op machines met vier cores of minder.
• Render als het rustig is: voer /bluemap stop uit tijdens drukke uren en /bluemap start 's nachts terwijl de eerste render loopt.
• Pauzeer met spelers online: player-render-limit in plugin.conf stopt het renderen zodra er zoveel spelers online zijn.
• Stel een world border in. Die voorkomt dat de kaart, en het renderwerk, eindeloos groeit terwijl spelers verkennen.
• Bevries kaarten die je niet live nodig hebt, zoals het End zodra dat verkend is.

Opslag: bestanden of een database

Standaard slaat BlueMap de kaart op als gecomprimeerde bestanden in bluemap/web/maps, binnen de opslag van je server. De kaart groeit mee met het verkende gebied, dus houd bij een grote wereld de schijfruimte in de gaten.

Je kunt een kaart ook naar een database verplaatsen. Stel in storages/sql.conf de verbinding met MySQL, MariaDB, PostgreSQL of SQLite in, zet daarna storage: "sql" in het configbestand van de kaart en laad opnieuw:

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

Paper levert een MySQL-driver mee; voor Spigot, Fabric en Forge moet je een JDBC-driver toevoegen. Elk Minecraft-pakket van HytHost bevat MySQL-databases, die je aanmaakt in het tabblad Databases van het panel.