BlueMap — plugin för att generera en interaktiv 3D-världskarta i webbläsaren för Minecraft
En komplett guide till BlueMap-pluginen för Minecraft, som skapar en interaktiv 3D-karta över din värld i webbläsaren. Funktioner…
En komplett guide till BlueMap-pluginen för Minecraft, som skapar en interaktiv 3D-karta över din värld i webbläsaren. Funktioner, kommandon och konfiguration.
BlueMap — plugin för att generera en interaktiv 3D-världskarta i webbläsaren för Minecraft
BlueMap är en Minecraft-plugin som läser världens filer och bygger en tredimensionell ytmodell av dem, tillgänglig i en webbläsare via en inbyggd webbserver. Standardklienten renderar världen bara runt spelaren och ger ingen vy uppifrån eller utifrån. Pluginen skapar en komplett karta med möjlighet att rotera kameran, växla till perspektiv- eller isometriskt (platt) läge och se strukturer genom att helt enkelt gå till en webbadress. Den löser ett problem: extern visning av servervärlden utan att behöva logga in i spelet.
Hur renderingen fungerar
Pluginen delar upp chunks i tiles och genererar två detaljnivåer: hires-modeller med fullständig blockgeometri och en lowres-karta för vy på avstånd. Hires är aktivt vid nära inzoomning — då är specifika block, texturer och höjder synliga. Vid längre utzoomning laddas ett förenklat lager med färgade biomfläckar och landskap.
Renderingsprocessen i webbgränssnittet: tiles laddas gradvis under inzoomning.
Rendering utförs asynkront i en separat trådpool. Minecrafts servertråd blockeras inte — så länge processorn har lediga kärnor kommer spelarna inte att uppleva lagg från kartbygget. Pluginen spårar ändringar i världen själv: BlueMap letar regelbundet i mca-filer, upptäcker ändrade chunks och renderar bara om dem. Manuella kommandon som /bluemap update behövs sällan — främst för diagnostik.
Rendering i webbgränssnittet i förstaperson
Kommandon
Pluginen registrerar ett enda rotkommando /bluemap med underkommandon. De flesta fall kräver inget kommando alls — renderingen fungerar automatiskt.
Kommando | Vad det gör | |
| visar renderingsstatus och kön | |
| laddar om konfigurationer; | |
| pausar och återupptar all rendering (sparas efter omstart) | |
| fryser en specifik karta (inga uppdateringar) | |
| tar bort kartdata helt; kommer att renderas om | |
| tvingar en uppdatering av ändrade chunks inom radien | |
| renderar om allt, även om det inte har skett några ändringar | |
| söker efter typiska kartproblem på den angivna punkten |
Utförande av kommandot /bluemap
Konfiguration
Pluginmappen innehåller fyra konfigurationsfiler: core.conf, plugin.conf, webapp.conf, webserver.conf. Samt tre undermappar: maps/ (en .conf per värld), packs/ (resurspaket för rendering) och storages/ (file.conf för filsystemet, sql.conf för en SQL-databas).
core.conf
Huvudfilen. Nyckelparametern är accept-download, som måste ställas in på true vid första starten. Parametern render-thread-count (standard 1) anger antalet renderingstrådar — ett negativt värde betyder «antalet CPU-kärnor minus det absoluta värdet av siffran». metrics (true) styr sändningen av anonym statistik.
plugin.conf
Parametrar för spelares synlighet på kartan och renderingsbeteende:
Parameter | Vad den gör |
| överför positionerna för onlinespelare till webbapplikationen |
| lägen där spelaren inte är synlig. Värden: |
| döljer spelare som gömts av en vanish-plugin |
| döljer spelare med osynlighetseffekten |
| döljer smygande spelare |
| tröskel för solljus; |
| tröskel för blockljus |
| tar bort spelare i en annan värld från listan |
| sekunder mellan lagring av markörer till lagring; |
| sekunder mellan lagring av spelarpositioner |
| laddar ner skins från Mojang när en spelare loggar in |
| antal onlinespelare då renderingen stannar; |
| minuter mellan fulla sökningar efter missade ändringar |
webapp.conf
Webbapplikationens inställningar. default-to-flat-view (false) bestämmer startvyn — perspektiv eller isometrisk. Skjutreglagen hires-slider-default (100) och lowres-slider-default (2000) ställer in avståndet för detaljerad och förenklad rendering i block. resolution-default (1) accepterar värdena 0.5, 1 eller 2. Fältet scripts och styles ansluter anpassade JS- och CSS-filer.
webserver.conf
Inbyggd webbserver. enabled (true) — aktivera eller inaktivera. port (8100) — porten. webroot ("bluemap/web") — katalog med webbapplikationens filer (måste matcha webroot i webapp.conf). Avsnittet log konfigurerar inspelningen av HTTP-aktivitet till en fil.
Slutsats
BlueMap ger möjlighet till extern visning av världen i form av en fullfjädrad 3D-modell med kamerarotation och fri flygning. Pluginen passar utmärkt för överlevnads- och RPG-servrar, där det är viktigt för spelare att dela koordinater och inspektera byggnader; för minispel-servrar utan en permanent värld är det onödigt.
Installation
En typisk installation tar ungefär 5 minuter. Flödet är detsamma; bara Loader och den matchande builden skiljer sig.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
