Come installare Dynmap / BlueMap (mappa web interattiva)

Dynmap e BlueMap sono plugin che creano una mappa web interattiva del tuo mondo Minecraft, consultabile da qualsiasi browser. I giocatori esplorano il mondo, vedono le posizioni in tempo reale e scoprono le costruzioni. Questa guida confronta i due e ti mostra come installare Dynmap o BlueMap su un server Minecraft con OuiPanel, il pannello di gioco. Alla fine, pubblichi la mappa sul tuo nome di dominio.

---

Confrontare Dynmap e BlueMap

Criterio	Dynmap	BlueMap
Resa	2D, vista satellitare	3D, vista isometrica
Spazio su disco	medio	più alto
Prestazioni	buone	medie
Qualità visiva	buona	eccellente
Configurazione	semplice	molto semplice
Estensioni	numerose	alcune
Risorse	leggero	più esigente

Dynmap mostra una vista 2D in stile satellite, con zoom.

┌──────────────────────────────┐
│  Mappa 2D stile Google Maps  │
│  - Vista dall'alto           │
│  - Zoom su più livelli       │
│  - Indicatori e zone         │
└──────────────────────────────┘

BlueMap mostra una vista 3D isometrica.

┌──────────────────────────────┐
│  Mappa 3D isometrica         │
│  - Rotazione libera          │
│  - Edifici in 3D             │
│  - Molto dettagliata         │
└──────────────────────────────┘

Funzione	Dynmap	BlueMap
Vista	2D satellitare	3D isometrica
Porta predefinita	8123	8100
File di configurazione	configuration.txt	core.conf, webserver.conf
Integrazioni con plugin	numerose	alcune
Consumo di RAM	moderato	alto
Primo rendering	rapido	più lento
Qualità visiva	buona	eccellente
Messa in opera	semplice	molto semplice

---

Requisiti

Un server compatibile

Software	Dynmap	BlueMap
Paper	sì	sì
Spigot	sì	sì
Purpur	sì	sì
Fabric	sì (mod)	sì (mod)
Forge	sì (mod)	sì (mod)
Vanilla	no	no

Una porta in più

La mappa web ha bisogno di una propria porta HTTP.

Servizio	Porta predefinita
Minecraft	25565
Dynmap	8123
BlueMap	8100

In OuiPanel, questa porta si aggiunge in Configurazione › Gestione porte, come spiegato più sotto.

---

Installare Dynmap

Scaricare Dynmap

1. Apri la pagina di Dynmap su SpigotMC e clicca su Download.

2. Prendi la versione adatta alla tua versione di Minecraft.

Con Paper, Spigot o Purpur, puoi anche cercare Dynmap nella pagina Plugin di OuiPanel, scheda Catalogo, e cliccare su Installa.

Mettere il plugin sul server

1. Accedi a OuiPanel e seleziona il tuo server Minecraft.

2. Nel menu laterale, apri Gestione file, poi la cartella plugins.

3. Trascina il file Dynmap-*.jar dal computer sulla pagina. Non c'è un pulsante di invio.

Primo avvio

In Console, avvia il server. Attendi che Dynmap crei i suoi file di configurazione.

[INFO]: [dynmap] Loaded 3 maps of world 'world'
[INFO]: [dynmap] Enabled
[INFO]: [dynmap] Web server started on address 0.0.0.0:8123

Poi ferma il server per configurarlo.

Aggiungere una porta per la mappa

1. Nel menu laterale, apri Configurazione › Gestione porte.

2. Clicca su Assegna una nuova porta. Il pannello la aggiunge subito, senza finestra di conferma.

3. Annota il numero assegnato.

4. Con Modifica nota, dalle un nome, per esempio «Porta Dynmap».

Configurare Dynmap

In Gestione file, apri il file seguente. La finestra di modifica si apre con un clic e Salva registra le modifiche.

/plugins/dynmap/configuration.txt

Verso la riga 315, imposta la porta del server web.

# Indirizzo di ascolto del server web
webserver-bindaddress: 0.0.0.0

# Porta del server web (sostituiscila con la porta assegnata)
webserver-port: 8123

Sostituisci 8123 con la porta ottenuta in Gestione porte.

Per non sovraccaricare il server, abbassa la qualità del rendering, verso la riga 16.

# Qualità del rendering (vlowres, lowres, hires)
deftemplatesuffix: lowres

Qualità	Dettaglio	Spazio su disco	Prestazioni
vlowres	molto bassa	minimo	eccellenti
lowres	bassa	ridotto	molto buone
hires	alta	elevato	esigenti

Inizia con lowres e passa a hires solo se il server ha risorse sufficienti.

Ecco una configurazione completa consigliata.

# Qualità del rendering
deftemplatesuffix: lowres

# Messaggi di rendering in chat
renderacceleratethreshold: 60
updaterate: 2000

# Server web integrato
webserver-bindaddress: 0.0.0.0
webserver-port: 8123

# Numero massimo di tessere in coda
parallelrendercnt: 4
tileupdatedelay: 30

# Chat web
allowwebchat: true
webchat-interval: 5

# Visibilità dei giocatori
player-info-protected: false
showplayerfacesinmenu: true

Riavviare e aprire la mappa

Avvia il server e attendi questo messaggio.

[INFO]: [dynmap] Web server started on address 0.0.0.0:8123

Nel browser, apri l'indirizzo seguente, con l'IP del tuo server e la porta della mappa.

http://TUO_IP:TUA_PORTA

Per esempio http://203.0.113.10:8123. L'IP è quello dell'Indirizzo principale, in Vista Globale.

Generare la mappa

La mappa si riempie man mano che i giocatori esplorano. Per generarla a mano, lancia questo comando.

/dynmap fullrender world

Un rendering completo può durare a lungo e consumare molte risorse. Limita la zona con un bordo del mondo (/worldborder).

Comandi di Dynmap

Comando	Descrizione
/dynmap fullrender [mondo]	esegue il rendering di tutto il mondo
/dynmap cancelrender [mondo]	annulla il rendering in corso
/dynmap pause all	mette in pausa tutti i rendering
/dynmap pause none	riprende i rendering
/dynmap stats	mostra le statistiche
/dynmap hide	nasconde la tua posizione sulla mappa
/dynmap show	mostra la tua posizione
/dmarker add <nome>	aggiunge un indicatore

Nella console di OuiPanel, digita questi comandi senza la barra.

---

Installare BlueMap

Scaricare BlueMap

Scarica BlueMap da bluemap.bluecolored.de o da Modrinth, nella versione per il tuo server.

Server	File
Paper, Spigot	BlueMap-*-spigot.jar
Fabric	BlueMap-*-fabric.jar
Forge	BlueMap-*-forge.jar

Mettere il plugin sul server

In Gestione file, apri la cartella plugins e trascinaci il file BlueMap-*.jar. Con Paper puoi anche usare la pagina Plugin.

Primo avvio

Avvia il server. BlueMap crea i suoi file e mostra questo messaggio.

[BlueMap] BlueMap needs to download some resources from Mojang.
[BlueMap] Please accept the Minecraft EULA and change 'accept-download' to 'true' in config.

Poi ferma il server.

Accettare il download delle risorse

1. Apri la cartella /plugins/BlueMap/ (o /config/bluemap/ con Fabric).

2. Apri il file core.conf.

3. Imposta la riga seguente su true, poi clicca su Salva.

accept-download: true

Aggiungere una porta per la mappa

In Configurazione › Gestione porte, clicca su Assegna una nuova porta e annota il numero, come per Dynmap.

Configurare il server web

Apri webserver.conf in /plugins/BlueMap/ e modificalo così.

# Attivare il server web integrato
enabled: true

# Indirizzo di ascolto
ip: "0.0.0.0"

# Porta del server web (la porta assegnata)
port: 8100

# Connessioni massime
max-connections: 100

Impostare i mondi (facoltativo)

Apri maps/world.conf per personalizzare la visualizzazione.

# Nome mostrato sulla mappa
name: "Il Mio Mondo"

# Posizione di partenza
start-pos: {x: 0, z: 0}

# Limiti della mappa (facoltativo)
min-x: -5000
max-x: 5000
min-z: -5000
max-z: 5000

# Rendering delle grotte
render-caves: true

# Colore del cielo
sky-color: "#7dabff"

Riavviare e aprire la mappa

Avvia il server e attendi questi messaggi.

[BlueMap] WebServer started!
[BlueMap] Loaded 1 map(s)

Poi apri la mappa nel browser.

http://TUO_IP:TUA_PORTA

Comandi di BlueMap

Comando	Descrizione
/bluemap render [mondo]	avvia il rendering di un mondo
/bluemap pause	mette in pausa il rendering
/bluemap resume	riprende il rendering
/bluemap cancel	annulla il rendering in corso
/bluemap reload	ricarica la configurazione
/bluemap maps	elenca le mappe
/bluemap version	mostra la versione di BlueMap

---

Pubblicare la mappa su un nome di dominio

Il Proxy Manager di OuiPanel dà accesso alla mappa con un nome di dominio in HTTPS, invece che con un IP e una porta.

Senza Proxy Manager	Con Proxy Manager
http://203.0.113.10:8123	https://mappa.mioserver.it
una porta da ricordare	un indirizzo semplice
HTTP non cifrato	HTTPS cifrato

1. Nel menu laterale, apri Proxy Manager.

2. La scheda La destinazione DNS di questo server indica il record da creare: tipo A, nome @ e un indirizzo IP. Presso il registrar del tuo dominio, crea lo stesso record per il tuo sottodominio, per esempio mappa.

3. Clicca su Aggiungi un dominio. Si apre il modulo Nuovo collegamento.

4. Inserisci il Nome di dominio completo, per esempio mappa.mioserver.it.

5. In Porta, scegli la porta della mappa.

6. Lascia HTTPS spuntato per ottenere un certificato Let's Encrypt, rinnovato automaticamente.

7. Clicca su Verifica il DNS. Il pannello deve rispondere «Il DNS punta qui».

8. Clicca su Crea il reindirizzamento.

Il dominio compare in Domini collegati, con il pulsante Apri il sito. La mappa è allora raggiungibile su https://mappa.mioserver.it. La propagazione DNS richiede da 5 minuti a 48 ore secondo il registrar. La guida Come configurare un reverse proxy (Proxy Manager) spiega ogni passaggio.

---

Personalizzare la mappa

Aggiungere indicatori in Dynmap

In gioco, aggiungi un indicatore con /dmarker add.

/dmarker add "Spawn Principale" icon:tower
/dmarker add "Negozio" icon:chest
/dmarker add "Arena PvP" icon:skull

Icona	Nome
casa	house
baule	chest
teschio	skull
torre	tower
carrello da miniera	minecart
stella	star
bandiera rossa	redflag

Aggiungere indicatori in BlueMap

Crea il file /plugins/BlueMap/markers/markers.json.

{
  "markers": [
    {
      "id": "spawn",
      "type": "poi",
      "label": "Spawn",
      "position": {"x": 0, "y": 64, "z": 0},
      "icon": "assets/poi.svg"
    },
    {
      "id": "shop",
      "type": "poi",
      "label": "Negozio",
      "position": {"x": 100, "y": 64, "z": -50}
    }
  ]
}

Collegare Dynmap ad altri plugin

Dynmap può mostrare le zone dei plugin più diffusi tramite estensioni.

Plugin	Estensione Dynmap
WorldGuard	Dynmap-WorldGuard
Towny	Dynmap-Towny
Factions	Dynmap-Factions
GriefPrevention	Dynmap-GriefPrevention
Residence	Dynmap-Residence

Scarica l'estensione e mettila in /plugins/.

---

Ottimizzare le prestazioni

Limitare la zona di rendering

Prima di un rendering completo, imposta un bordo del mondo.

/worldborder set 10000

Il mondo, e quindi il rendering, si limita a un quadrato di 10.000 blocchi di lato.

Configurazione alleggerita per Dynmap

# Ridurre la frequenza degli aggiornamenti
updaterate: 3000
tileupdatedelay: 60

# Limitare i rendering paralleli
parallelrendercnt: 2

# Disattivare le funzioni pesanti
smooth-lighting: false
better-grass: false

Configurazione alleggerita per BlueMap

In core.conf, imposta questi valori.

# Thread di rendering (da regolare secondo la RAM)
render-threads: 2

# Intervallo di aggiornamento (in secondi)
update-interval: 300

---

Se la mappa non si apre

Causa	Soluzione
Porta sbagliata	confronta la porta della configurazione con quella di Gestione porte
Porta assente	aggiungila con Assegna una nuova porta
Server web non avviato	leggi il registro di avvio in Console

Errore «Port already in use»

La porta è già occupata. Cambia la porta nella configurazione, oppure usa un'altra porta di Gestione porte.

Mappa nera o vuota

La mappa non è ancora stata generata. Esplora il mondo in gioco, oppure lancia un rendering con /dynmap fullrender world o /bluemap render world.

Il server va in lag durante il rendering

• Passa alla qualità lowres o vlowres.

• Abbassa parallelrendercnt a 1 o 2.

• Aumenta tileupdatedelay.

• Pianifica i rendering nelle ore tranquille.

Spazio su disco insufficiente

Le mappe ad alta definizione occupano molto spazio.

• Usa lowres invece di hires.

• Limita la zona con un bordo del mondo.

• Elimina i vecchi rendering in /plugins/dynmap/web/tiles/.

Per approfondire, consulta la wiki di Dynmap o la wiki di BlueMap. Entrambi i progetti hanno un Discord (discord.gg/dynmap e discord.gg/bluemap).

---

Hai bisogno di aiuto?

Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.

Apri un ticketDiscord