BlueMap — plugin til generering af et interaktivt 3D-verdenskort i browseren til Minecraft
Komplet guide til BlueMap-pluginnet til Minecraft, der skaber et interaktivt 3D-kort over din verden i browseren. Funktioner, kommandoer og…
Komplet guide til BlueMap-pluginnet til Minecraft, der skaber et interaktivt 3D-kort over din verden i browseren. Funktioner, kommandoer og konfiguration.
BlueMap — plugin til generering af et interaktivt 3D-verdenskort i browseren til Minecraft
BlueMap er et Minecraft-plugin, der læser verdensfiler og bygger en tredimensionel overflademodel ud fra dem, tilgængelig i en browser via en indbygget webserver. Den normale klient renderer kun verden omkring spilleren og giver ikke noget overblik oppefra eller udefra. Pluginnet danner et komplet kort med mulighed for at rotere kameraet, skifte til perspektivisk eller isometrisk (flad) tilstand og se strukturer ved blot at gå til en URL. Det løser én opgave: ekstern visning af serververdenen uden behov for at logge ind i spillet.
Hvordan rendering fungerer
Pluginnet opdeler chunks i tiles og genererer to detaljeringsniveauer: hires-modeller med fuld blokgeometri og et lowres-kort til fjernvisning. Hires er aktivt ved tæt zoom — så er specifikke blokke, teksturer og højder synlige. Ved længere zoom indlæses et forenklet lag med farvede biompletter og landskab.
Renderingsprocessen i webgrænsefladen: tiles indlæses gradvist under zoom.
Rendering udføres asynkront i en separat trådpulje. Minecraft-servertråden blokeres ikke — så længe CPU'en har ledige kerner, vil spillerne ikke opleve lag fra kortgenereringen. Pluginnet sporer selv ændringer i verden: BlueMap kontrollerer jævnligt mca-filer, opdager ændrede chunks og gen-renderer kun dem. Manuelle kommandoer som /bluemap update er sjældent nødvendige — primært til diagnosticering.
Rendering i webgrænsefladen i førsteperson
Kommandoer
Pluginnet registrerer en enkelt rodkommando /bluemap med underkommandoer. De fleste tilfælde kræver ingen kommando overhovedet — rendering fungerer automatisk.
Kommando | Hvad den gør | |
| viser renderingsstatus og køen | |
| genindlæser konfigurationer; | |
| sætter på pause og genoptager al rendering (bevares efter genstart) | |
| fryser et bestemt kort (ingen opdateringer) | |
| sletter kortdata fuldstændigt; vil blive gen-renderet | |
| gennemtvinger en opdatering af ændrede chunks inden for radius | |
| gen-renderer alt, selvom der ikke har været ændringer | |
| søger efter typiske kortproblemer på det angivne punkt |
Udførelse af kommandoen /bluemap
Konfiguration
Plugin-mappen indeholder fire konfigurationsfiler: core.conf, plugin.conf, webapp.conf, webserver.conf. Samt tre undermapper: maps/ (en .conf pr. verden), packs/ (ressourcepakker til rendering) og storages/ (file.conf til filsystemet, sql.conf til en SQL-database).
core.conf
Hovedfilen. Nøgleparameteren er accept-download, som skal indstilles til true ved første start. Parameteren render-thread-count (standard 1) angiver antallet af renderingstråde — en negativ værdi betyder «antal CPU-kerner minus tallets numeriske værdi». metrics (true) styrer afsendelsen af anonym statistik.
plugin.conf
Parametre for spilleres synlighed på kortet og renderingsadfærd:
Parameter | Hvad den gør |
| overfører online spilleres positioner til webapplikationen |
| tilstande, hvor spilleren ikke er synlig. Værdier: |
| skjuler spillere, der er skjult af et vanish-plugin |
| skjuler spillere med usynlighedseffekten |
| skjuler snigende spillere |
| tærskel for sollys; |
| tærskel for bloklys |
| fjerner spillere fra en anden verden fra listen |
| sekunder mellem gemning af markører i opbevaringen; |
| sekunder mellem gemning af spillerpositioner |
| downloader skins fra Mojang, når en spiller tilslutter sig |
| antal online spillere, hvor rendering stopper; |
| minutter mellem fulde tjek for missede ændringer |
webapp.conf
Indstillinger for webapplikation. default-to-flat-view (false) bestemmer startvisningen — perspektivisk eller isometrisk. Skydeknapperne hires-slider-default (100) og lowres-slider-default (2000) angiver afstanden for detaljeret og forenklet rendering i blokke. resolution-default (1) accepterer værdierne 0.5, 1 eller 2. Arraysene scripts og styles forbinder brugerdefinerede JS- og CSS-filer.
webserver.conf
Indbygget webserver. enabled (true) — aktiver eller deaktiver. port (8100) — porten. webroot ("bluemap/web") — bibliotek med webapplikationsfiler (skal matche webroot i webapp.conf). Sektionen log konfigurerer registreringen af HTTP-aktivitet til en fil.
Konklusion
BlueMap giver mulighed for ekstern visning af verden i form af en fuldgyldig 3D-model med kamerarotation og fri flyvning. Pluginnet er velegnet til survival- og RPG-servere, hvor det er vigtigt for spillerne at dele koordinater og inspicere bygninger; til minigame-servere uden en permanent verden er det overflødigt.
Installation
En typisk installation tager omkring 5 minutter. Forløbet er det samme; kun Loader og den matchende build er forskellige.
- 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.
