BlueMap — plugin voor het genereren van een interactieve 3D-wereldkaart in de browser voor Minecraft
Volledige gids voor de BlueMap-plugin voor Minecraft, die een interactieve 3D-kaart van je wereld in de browser maakt. Functies, commando's…
Volledige gids voor de BlueMap-plugin voor Minecraft, die een interactieve 3D-kaart van je wereld in de browser maakt. Functies, commando's en configuratie.
BlueMap — plugin voor het genereren van een interactieve 3D-wereldkaart in de browser voor Minecraft
BlueMap is een Minecraft-plugin die wereld bestanden leest en er een driedimensionaal oppervlaktemodel van bouwt, toegankelijk in een browser via een ingebouwde webserver. De standaard client rendert de wereld alleen rondom de speler en biedt geen bovenaanzicht of buitenaanzicht. De plugin vormt een volledige kaart met de mogelijkheid om de camera te draaien, over te schakelen naar perspectief- of isometrische (platte) modus en structuren te bekijken door simpelweg naar een URL te gaan. Het lost één probleem op: extern bekijken van de serverwereld zonder dat je hoeft in te loggen in het spel.
Hoe rendering werkt
De plugin splitst chunks op in tiles en genereert twee detailniveaus: hires-modellen met volledige blokgeometrie en een lowres-kaart voor weergave op afstand. Hires is actief bij ver inzoomen — dan zijn specifieke blokken, texturen en hoogtes zichtbaar. Bij verder uitzoomen wordt een vereenvoudigde laag met gekleurde bioomvlekken en landschap geladen.
Het renderproces in de webinterface: tiles worden geleidelijk geladen tijdens het inzoomen.
De rendering wordt asynchroon uitgevoerd in een aparte thread pool. De Minecraft-serverthread wordt hierbij niet geblokkeerd — zolang de CPU vrije cores heeft, zullen spelers geen vertraging ondervinden door het bouwen van de kaart. De plugin houdt zelf veranderingen in de wereld bij: BlueMap controleert periodiek mca-bestanden, merkt gewijzigde chunks op en her-rendert alleen deze. Handmatige commando's zoals /bluemap update zijn zelden nodig — voornamelijk voor diagnostiek.
Renderen in de webinterface in first-person
Commando's
De plugin registreert één hoofdcommando /bluemap met subcommando's. In de meeste gevallen is er geen enkel commando nodig — de rendering werkt automatisch.
Commando | Wat het doet | |
| toont de renderstatus en de wachtrij | |
| herlaadt configuraties; | |
| pauzeert en hervat de gehele rendering (blijft behouden na herstart) | |
| bevriest een specifieke kaart (geen updates) | |
| verwijdert de kaartgegevens volledig; zal opnieuw gerenderd worden | |
| forceert een update van gewijzigde chunks binnen de radius | |
| her-rendert alles, zelfs als er geen wijzigingen waren | |
| zoekt naar typische kaartproblemen op het opgegeven punt |
Uitvoeren van het commando /bluemap
Configuratie
De pluginmap bevat vier configuratiebestanden: core.conf, plugin.conf, webapp.conf, webserver.conf. En ook drie submappen: maps/ (één .conf per wereld), packs/ (resource packs voor rendering) en storages/ (file.conf voor het bestandssysteem, sql.conf voor een SQL-database).
core.conf
Het hoofdbestand. De belangrijkste parameter is accept-download, die op true ingesteld moet worden voor de eerste start. De parameter render-thread-count (standaard 1) stelt het aantal render-threads in — een negatieve waarde betekent «aantal CPU-cores minus de absolute waarde van het getal». metrics (true) beheert het verzenden van anonieme statistieken.
plugin.conf
Parameters voor de zichtbaarheid van spelers op de kaart en rendergedrag:
Parameter | Wat het doet |
| stuurt posities van online spelers door naar de webapplicatie |
| modi waarin de speler niet zichtbaar is. Waarden: |
| verbergt spelers die verborgen zijn door een vanish-plugin |
| verbergt spelers met het onzichtbaarheidsdrank-effect |
| verbergt sluipende spelers |
| drempel voor zonlicht; |
| drempel voor bloklicht |
| verwijdert spelers uit een andere wereld van de lijst |
| seconden tussen het opslaan van markers naar opslag; |
| seconden tussen het opslaan van spelerposities |
| downloadt skins van Mojang wanneer een speler deelneemt |
| het aantal online spelers waarbij de rendering stopt; |
| minuten tussen volledige controles op gemiste wijzigingen |
webapp.conf
Webapplicatie instellingen. default-to-flat-view (false) bepaalt de startweergave — perspectief of isometrisch. De schuifregelaars hires-slider-default (100) en lowres-slider-default (2000) stellen de afstand in voor de gedetailleerde en vereenvoudigde rendering in blokken. resolution-default (1) accepteert de waarden 0.5, 1 of 2. De arrays scripts en styles koppelen aangepaste JS- en CSS-bestanden.
webserver.conf
Ingebouwde webserver. enabled (true) — inschakelen of uitschakelen. port (8100) — de poort. webroot ("bluemap/web") — map met de bestanden van de webapplicatie (moet overeenkomen met de webroot in webapp.conf). De sectie log configureert de registratie van HTTP-activiteit naar een bestand.
Conclusie
BlueMap biedt de mogelijkheid om de wereld extern te bekijken in het formaat van een volwaardig 3D-model met camerabeheersing en vrije vlucht. De plugin is geschikt voor survival- en RPG-servers, waar het voor spelers belangrijk is om coördinaten te delen en gebouwen te inspecteren; voor minigame-servers zonder een permanente wereld is het overbodig.
Installatie
Een typische installatie duurt ongeveer 5 minuten. De stappen zijn gelijk; alleen de loader en de bijbehorende build verschillen.
- 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.
