BlueMap-guide: et 3D-nettkart for Minecraft-serveren din

Hva BlueMap er

BlueMap leser verdensfilene dine, rendrer dem til 3D-kartfliser og leverer dem via en liten innebygd webserver. Zoomet inn ser du blokkene i full 3D; zoomet ut får du en flat oversikt. Live-markører viser hvor spillerne er, og kartet oppdateres etter hvert som verdenen endrer seg.

Det rendrer kun verdener fra Java Edition. Gjeldende utgivelse, BlueMap 5.29, finnes i versjoner for:

For en eldre Minecraft-versjon laster du ned en eldre BlueMap-utgivelse som oppgir den. Hver utgivelse på Modrinth og Hangar viser hvilke versjoner den støtter.

Installer BlueMap

1. Last ned filen som passer serveren din fra Modrinth, Hangar eller BlueMaps utgivelser på GitHub: -paper-jarfilen for Paper, -fabric for Fabric og så videre.
2. Legg den i mappen plugins (Paper, Spigot) eller mappen mods (Fabric, Forge, NeoForge) og start serveren på nytt. Opplasting av plugins dekkes i slik installerer du Minecraft-plugins.
3. BlueMap lager konfigurasjonen sin i plugins/BlueMap/, eller config/bluemap/ på moddede servere, med et kart for hver av verdenene dine allerede satt opp.

Nå forteller konsollen at BlueMap venter. Det rendrer ingenting før du godtar nedlastingen, som er neste steg.

Godta nedlastingen i core.conf

For å tegne blokker trenger BlueMap teksturene og modellene fra Minecraft-klienten, som det laster ned fra Mojang. Åpne core.conf og endre:

accept-download: true

Ved å sette dette godtar du Mojangs EULA og bekrefter at du eier Minecraft Java Edition. Lagre filen og kjør /bluemap reload, eller start på nytt. BlueMap laster ned ressursene og begynner å rendre.

Gi nettkartet sin egen port

BlueMaps webserver lytter som standard på port 8100. På din egen maskin åpner du den porten og går til http://your-ip:8100. På hostede servere kan du som regel ikke velge port fritt, så du bruker en som er tildelt serveren din:

1. Skaff en ekstra port til serveren. Hos HytHost åpner du fanen Network i panelet og legger til en allokering: panelet velger en ledig port og åpner den for deg.
2. Åpne webserver.conf og sett port til det nummeret:

   port: 25570

3. Kjør /bluemap reload og åpne http://your-server-ip:25570 i en nettleser.

Ikke bruk spillporten; den tilhører Minecraft. Vil du vise kartet på ditt eget domene uten portnummer, setter du en reverse proxy som nginx foran; BlueMaps dokumentasjon har ferdige eksempler.

BlueMap-kommandoer

Hver kommando har en tillatelse på formen bluemap.<command>, for eksempel bluemap.reload. Som oftest trenger du ingen av dem: BlueMap merker endringer i verdenen og rendrer dem selv.

Hold renderingen lett

BlueMap rendrer i bakgrunnstråder, ikke på serverens hovedtråd, men renderingen bruker likevel CPU. Den første renderingen av en stor verden er den tunge delen; etter det tegnes bare endrede chunks på nytt.

• Rendertråder: sett render-thread-count i core.conf. BlueMaps dokumentasjon foreslår 1 på maskiner med fire kjerner eller færre.
• Rendre når det er rolig: kjør /bluemap stop i travle timer og /bluemap start om natten mens den første renderingen pågår.
• Pause når spillere er pålogget: player-render-limit i plugin.conf stopper renderingen når så mange spillere er inne.
• Sett en world border. Den hindrer kartet, og renderarbeidet, i å vokse i det uendelige mens spillerne utforsker.
• Frys kart du ikke trenger live, som End når den er utforsket.

Lagring: filer eller en database

Som standard lagrer BlueMap kartet som komprimerte filer i bluemap/web/maps, i serverens lagring. Kartet vokser med det utforskede området, så følg med på diskplassen i en stor verden.

Du kan i stedet flytte et kart til en database. I storages/sql.conf setter du opp tilkoblingen til MySQL, MariaDB, PostgreSQL eller SQLite, deretter setter du storage: "sql" i kartets konfigurasjonsfil og laster inn på nytt:

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 trenger en JDBC-driver lagt til. Alle Minecraft-pakker hos HytHost inkluderer MySQL-databaser, som du oppretter i panelets fane Databases.