Guida a BlueMap: una mappa web 3D per il tuo server Minecraft

Che cos'è BlueMap

BlueMap legge i file del tuo mondo, li renderizza in tile di mappa 3D e li serve tramite un piccolo web server integrato. Da vicino vedi i blocchi in 3D completo; allontanandoti, una panoramica piatta. I marker dal vivo mostrano dove si trovano i giocatori e la mappa si aggiorna man mano che il mondo cambia.

Renderizza solo mondi Java Edition. La versione attuale, BlueMap 5.29, è disponibile per:

Per una versione di Minecraft più vecchia, scarica una release precedente di BlueMap che la supporti. Ogni release su Modrinth e Hangar indica le versioni supportate.

Installare BlueMap

1. Scarica il file adatto al tuo server da Modrinth, Hangar o dalle release di BlueMap su GitHub: il jar -paper per Paper, -fabric per Fabric e così via.
2. Mettilo nella cartella plugins (Paper, Spigot) o nella cartella mods (Fabric, Forge, NeoForge) e riavvia il server. Il caricamento dei plugin è spiegato in come installare i plugin di Minecraft.
3. BlueMap crea la sua configurazione in plugins/BlueMap/, oppure in config/bluemap/ sui server moddati, con una mappa già pronta per ciascuno dei tuoi mondi.

A questo punto la console ti dice che BlueMap è in attesa. Non renderizzerà nulla finché non accetti il download, che è il passaggio successivo.

Accettare il download in core.conf

Per disegnare i blocchi, BlueMap ha bisogno delle texture e dei modelli del client di Minecraft, che scarica da Mojang. Apri core.conf e modifica:

accept-download: true

Impostandolo accetti l'EULA di Mojang e confermi di possedere Minecraft Java Edition. Salva il file ed esegui /bluemap reload, oppure riavvia. BlueMap scarica le risorse e inizia il rendering.

Dare alla mappa web una porta tutta sua

Il web server di BlueMap è in ascolto sulla porta 8100 per impostazione predefinita. Sulla tua macchina, apri quella porta e visita http://your-ip:8100. Sui server in hosting di solito non puoi scegliere una porta liberamente, quindi ne usi una assegnata al tuo server:

1. Ottieni una seconda porta per il tuo server. Su HytHost, apri la scheda Network nel pannello e aggiungi un'allocazione: il pannello sceglie una porta libera e la apre per te.
2. Apri webserver.conf e imposta port su quel numero:

   port: 25570

3. Esegui /bluemap reload e apri http://your-server-ip:25570 in un browser.

Non usare la porta del gioco: quella è di Minecraft. Per mostrare la mappa sul tuo dominio senza numero di porta, mettici davanti un reverse proxy come nginx; la documentazione di BlueMap ha esempi pronti.

Comandi di BlueMap

Ogni comando ha un permesso nella forma bluemap.<command>, per esempio bluemap.reload. Nella maggior parte dei casi non te ne serve nessuno: BlueMap rileva le modifiche nel mondo e le renderizza da solo.

Mantenere leggero il rendering

BlueMap renderizza in thread in background, non nel thread principale del server, ma il rendering usa comunque la CPU. Il primo rendering di un mondo grande è la parte pesante; dopo, vengono ridisegnati solo i chunk modificati.

• Thread di rendering: imposta render-thread-count in core.conf. La documentazione di BlueMap consiglia 1 sulle macchine con quattro core o meno.
• Renderizza nei momenti tranquilli: esegui /bluemap stop nelle ore di punta e /bluemap start di notte mentre gira il primo rendering.
• Pausa con giocatori online: player-render-limit in plugin.conf ferma il rendering quando è online quel numero di giocatori.
• Imposta un bordo del mondo. Evita che la mappa, e il lavoro di rendering, crescano all'infinito mentre i giocatori esplorano.
• Congela le mappe che non ti servono dal vivo, come l'End una volta esplorato.

Storage: file o database

Per impostazione predefinita BlueMap salva la mappa come file compressi in bluemap/web/maps, nello spazio del tuo server. La mappa cresce con l'area esplorata, quindi tieni d'occhio lo spazio su disco in un mondo grande.

In alternativa puoi spostare una mappa in un database. In storages/sql.conf, imposta la connessione a MySQL, MariaDB, PostgreSQL o SQLite, poi imposta storage: "sql" nel file di configurazione della mappa e ricarica:

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

Paper include un driver MySQL; Spigot, Fabric e Forge richiedono l'aggiunta di un driver JDBC. Ogni piano Minecraft di HytHost include database MySQL, che crei nella scheda Databases del pannello.