BlueMap-guide: en 3D-webbkarta för din Minecraft-server

Vad BlueMap är

BlueMap läser dina världsfiler, renderar dem till 3D-kartrutor och levererar dem via en liten inbyggd webbserver. Inzoomat ser du blocken i full 3D; utzoomat får du en platt översikt. Livemarkörer visar var spelarna är, och kartan uppdateras i takt med att världen förändras.

Det renderar bara världar från Java Edition. Den aktuella versionen, BlueMap 5.29, finns för:

För en äldre Minecraft-version laddar du ner en äldre BlueMap-version som listar den. Varje version på Modrinth och Hangar visar vilka versioner den stöder.

Installera BlueMap

1. Ladda ner filen som passar din server från Modrinth, Hangar eller BlueMaps releaser på GitHub: -paper-jarfilen för Paper, -fabric för Fabric och så vidare.
2. Lägg den i mappen plugins (Paper, Spigot) eller mappen mods (Fabric, Forge, NeoForge) och starta om servern. Hur du laddar upp plugins går vi igenom i så installerar du Minecraft-plugins.
3. BlueMap skapar sin konfiguration i plugins/BlueMap/, eller config/bluemap/ på moddade servrar, med en karta för var och en av dina världar redan uppsatt.

Nu säger konsolen att BlueMap väntar. Det renderar ingenting förrän du godkänner nedladdningen, vilket är nästa steg.

Godkänn nedladdningen i core.conf

För att rita block behöver BlueMap texturerna och modellerna från Minecraft-klienten, som det laddar ner från Mojang. Öppna core.conf och ändra:

accept-download: true

Genom att ställa in det godkänner du Mojangs EULA och bekräftar att du äger Minecraft Java Edition. Spara filen och kör /bluemap reload, eller starta om. BlueMap laddar ner resurserna och börjar rendera.

Ge webbkartan en egen port

BlueMaps webbserver lyssnar som standard på port 8100. På din egen maskin öppnar du den porten och går till http://your-ip:8100. På hostade servrar kan du oftast inte välja port fritt, så du använder en som är tilldelad din server:

1. Skaffa en extra port till din server. Hos HytHost öppnar du fliken Network i panelen och lägger till en allokering: panelen väljer en ledig port och öppnar den åt dig.
2. Öppna webserver.conf och sätt port till det numret:

   port: 25570

3. Kör /bluemap reload och öppna http://your-server-ip:25570 i en webbläsare.

Använd inte spelporten; den är Minecrafts. Vill du visa kartan på din egen domän utan portnummer, sätt en reverse proxy som nginx framför; BlueMaps dokumentation har färdiga exempel.

BlueMap-kommandon

Varje kommando har en behörighet i formen bluemap.<command>, till exempel bluemap.reload. För det mesta behöver du inget av dem: BlueMap märker ändringar i världen och renderar dem på egen hand.

Håll renderingen lätt

BlueMap renderar i bakgrundstrådar, inte på serverns huvudtråd, men renderingen använder ändå CPU. Den första renderingen av en stor värld är den tunga delen; efter det ritas bara ändrade chunks om.

• Rendertrådar: ställ in render-thread-count i core.conf. BlueMaps dokumentation föreslår 1 på maskiner med fyra kärnor eller färre.
• Rendera när det är lugnt: kör /bluemap stop under hektiska timmar och /bluemap start på natten medan den första renderingen pågår.
• Pausa när spelare är online: player-render-limit i plugin.conf stoppar renderingen när så många spelare är inne.
• Sätt en world border. Den hindrar kartan, och renderarbetet, från att växa i all oändlighet när spelarna utforskar.
• Frys kartor du inte behöver live, som End när den är utforskad.

Lagring: filer eller en databas

Som standard sparar BlueMap kartan som komprimerade filer i bluemap/web/maps, i serverns lagring. Kartan växer med det utforskade området, så håll koll på diskutrymmet i en stor värld.

Du kan i stället flytta en karta till en databas. I storages/sql.conf ställer du in anslutningen till MySQL, MariaDB, PostgreSQL eller SQLite, sedan sätter du storage: "sql" i kartans konfigurationsfil och läser in igen:

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

Paper levereras med en MySQL-drivrutin; Spigot, Fabric och Forge behöver en JDBC-drivrutin tillagd. Alla Minecraft-paket hos HytHost innehåller MySQL-databaser, som du skapar i panelens flik Databases.