BlueMap-guide: et 3D-webkort til din Minecraft-server

Hvad BlueMap er

BlueMap læser dine verdensfiler, renderer dem til 3D-kortfliser og serverer dem via en lille indbygget webserver. Zoomet ind ser du blokkene i fuld 3D; zoomet ud får du et fladt overblik. Live-markører viser, hvor spillerne er, og kortet opdateres, efterhånden som verdenen ændrer sig.

Det renderer kun verdener fra Java Edition. Den aktuelle udgave, BlueMap 5.29, findes i versioner til:

Til en ældre Minecraft-version skal du hente en ældre BlueMap-udgave, der nævner den. Hver udgave på Modrinth og Hangar viser, hvilke versioner den understøtter.

Installer BlueMap

1. Hent den fil, der passer til din server, fra Modrinth, Hangar eller BlueMaps udgivelser på GitHub: -paper-jar'en til Paper, -fabric til Fabric og så videre.
2. Læg den i mappen plugins (Paper, Spigot) eller mappen mods (Fabric, Forge, NeoForge), og genstart serveren. Upload af plugins er beskrevet i sådan installerer du Minecraft-plugins.
3. BlueMap opretter sin konfiguration i plugins/BlueMap/, eller config/bluemap/ på moddede servere, med et kort til hver af dine verdener allerede sat op.

På dette tidspunkt fortæller konsollen, at BlueMap venter. Det renderer intet, før du accepterer downloaden, som er næste trin.

Accepter downloaden i core.conf

For at tegne blokke skal BlueMap bruge teksturerne og modellerne fra Minecraft-klienten, som det henter fra Mojang. Åbn core.conf og ret:

accept-download: true

Med den indstilling accepterer du Mojangs EULA og bekræfter, at du ejer Minecraft Java Edition. Gem filen og kør /bluemap reload, eller genstart. BlueMap henter ressourcerne og begynder at rendere.

Giv webkortet sin egen port

BlueMaps webserver lytter som standard på port 8100. På din egen maskine åbner du den port og besøger http://your-ip:8100. På hostede servere kan du som regel ikke vælge en port frit, så du bruger en, der er tildelt din server:

1. Få en ekstra port til din server. Hos HytHost åbner du fanen Network i panelet og tilføjer en allokering: panelet vælger en ledig port og åbner den for dig.
2. Åbn webserver.conf og sæt port til det nummer:

   port: 25570

3. Kør /bluemap reload og åbn http://your-server-ip:25570 i en browser.

Brug ikke spilporten; den tilhører Minecraft. Vil du vise kortet på dit eget domæne uden portnummer, så sæt en reverse proxy som nginx foran; BlueMaps dokumentation har færdige eksempler.

BlueMap-kommandoer

Hver kommando har en tilladelse på formen bluemap.<command>, for eksempel bluemap.reload. Det meste af tiden har du ikke brug for nogen af dem: BlueMap opdager ændringer i verdenen og renderer dem selv.

Hold renderingen let

BlueMap renderer i baggrundstråde, ikke i serverens hovedtråd, men renderingen bruger stadig CPU. Den første rendering af en stor verden er den tunge del; derefter tegnes kun ændrede chunks igen.

• Rendertråde: sæt render-thread-count i core.conf. BlueMaps dokumentation foreslår 1 på maskiner med fire kerner eller færre.
• Render, når der er roligt: kør /bluemap stop i travle timer og /bluemap start om natten, mens den første rendering kører.
• Pause, når spillere er online: player-render-limit i plugin.conf stopper renderingen, når så mange spillere er på.
• Sæt en world border. Den forhindrer kortet, og renderarbejdet, i at vokse i det uendelige, mens spillerne udforsker.
• Frys kort, du ikke behøver live, som End, når den er udforsket.

Lager: filer eller en database

Som standard gemmer BlueMap kortet som komprimerede filer i bluemap/web/maps på din servers lager. Kortet vokser med det udforskede område, så hold øje med diskpladsen på en stor verden.

Du kan i stedet flytte et kort til en database. I storages/sql.conf sætter du forbindelsen til MySQL, MariaDB, PostgreSQL eller SQLite, derefter sætter du storage: "sql" i kortets konfigurationsfil og genindlæser:

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

Paper leveres med en MySQL-driver; Spigot, Fabric og Forge skal have en JDBC-driver tilføjet. Alle Minecraft-pakker hos HytHost indeholder MySQL-databaser, som du opretter i panelets fane Databases.