BlueMap — un plugin per generare una mappa del mondo 3D interattiva nel browser per Minecraft
Guida completa al plugin BlueMap per Minecraft, che crea una mappa 3D interattiva nel browser. Funzionalità, comandi e configurazione.
Guida completa al plugin BlueMap per Minecraft, che crea una mappa 3D interattiva nel browser. Funzionalità, comandi e configurazione.
BlueMap — un plugin per generare una mappa del mondo 3D interattiva nel browser per Minecraft
BlueMap è un plugin per Minecraft che legge i file del mondo e ne ricava un modello di superficie tridimensionale, accessibile in un browser tramite un server web integrato. Il client standard renderizza il mondo solo attorno al giocatore e non fornisce una vista dall'alto o dall'esterno. Il plugin forma una mappa completa con la possibilità di ruotare la fotocamera, passare alla modalità prospettica o isometrica (piatta) e vedere le strutture semplicemente seguendo un URL. Risolve un problema: la visualizzazione esterna del mondo del server senza la necessità di accedere al gioco.
Come funziona il rendering
Il plugin divide i chunk in tile e genera due livelli di dettaglio: modelli hires con l'intera geometria dei blocchi e una mappa lowres per la visualizzazione a distanza. Hires è attivo con uno zoom ravvicinato — in questo modo sono visibili blocchi specifici, texture e altezze. Ad uno zoom maggiore, viene caricato un livello semplificato con macchie di colore per i biomi e il paesaggio.
Processo di rendering nell'interfaccia web: i tile vengono caricati gradualmente durante lo zoom.
Il rendering viene eseguito in modo asincrono in un pool di thread separato. Il thread principale del server Minecraft non viene bloccato — finché la CPU ha core liberi, i giocatori non avvertiranno ritardi dovuti alla costruzione della mappa. Il plugin tiene traccia da solo dei cambiamenti nel mondo: BlueMap controlla periodicamente i file mca, rileva i chunk modificati e li renderizza nuovamente. I comandi manuali come /bluemap update sono necessari raramente — principalmente per la diagnostica.
Rendering nell'interfaccia web in prima persona
Comandi
Il plugin registra un singolo comando radice /bluemap con sottocomandi. La maggior parte dei casi non richiede alcun comando — il rendering funziona automaticamente.
Comando | Cosa fa | |
| mostra lo stato del rendering e la coda | |
| ricarica le configurazioni; | |
| mette in pausa e riprende tutto il rendering (salvato dopo il riavvio) | |
| congela una mappa specifica (nessun aggiornamento) | |
| elimina completamente i dati della mappa; verrà renderizzata di nuovo | |
| forza l'aggiornamento dei chunk modificati nel raggio | |
| renderizza tutto di nuovo, anche se non ci sono stati cambiamenti | |
| cerca problemi tipici della mappa nel punto specificato |
Esecuzione del comando /bluemap
Configurazione
La cartella del plugin contiene quattro file di configurazione: core.conf, plugin.conf, webapp.conf, webserver.conf. Oltre a tre sottocartelle: maps/ (un .conf per ogni mondo), packs/ (resource pack per il rendering) e storages/ (file.conf per il file system, sql.conf per un database SQL).
core.conf
Il file principale. Il parametro chiave è accept-download, che deve essere impostato su true per il primo avvio. Il parametro render-thread-count (predefinito 1) imposta il numero di thread di rendering — un valore negativo significa «numero di core CPU meno il valore assoluto del numero». metrics (true) controlla l'invio di statistiche anonime.
plugin.conf
Parametri per la visibilità dei giocatori sulla mappa e il comportamento di rendering:
Parametro | Cosa fa |
| trasmette le posizioni dei giocatori online all'applicazione web |
| modalità in cui il giocatore non è visibile. Valori: |
| nasconde i giocatori celati da un plugin vanish |
| nasconde i giocatori con l'effetto della pozione di invisibilità |
| nasconde i giocatori furtivi |
| soglia della luce solare; |
| soglia della luce del blocco |
| rimuove dalla lista i giocatori che si trovano in un altro mondo |
| secondi tra la scrittura dei marker nell'archiviazione; |
| secondi tra la scrittura delle posizioni dei giocatori |
| scarica le skin da Mojang quando il giocatore entra |
| numero di giocatori online al quale si interrompe il rendering; |
| minuti tra controlli completi per modifiche non rilevate |
webapp.conf
Impostazioni dell'applicazione web. default-to-flat-view (false) determina la vista iniziale — prospettica o isometrica. Gli slider hires-slider-default (100) e lowres-slider-default (2000) impostano la distanza del rendering dettagliato e semplificato in blocchi. resolution-default (1) accetta valori 0.5, 1 o 2. Gli array scripts e styles integrano file JS e CSS personalizzati.
webserver.conf
Il server web integrato. enabled (true) — per abilitarlo o disabilitarlo. port (8100) — la porta. webroot ("bluemap/web") — directory con i file dell'applicazione web (deve corrispondere al webroot in webapp.conf). La sezione log configura la registrazione dell'attività HTTP in un file.
Conclusione
BlueMap permette la visualizzazione esterna del mondo sotto forma di un modello 3D completo con rotazione della fotocamera e volo libero. Il plugin è ideale per i server survival e RPG, dove è importante che i giocatori condividano le coordinate e ispezionino gli edifici; per i server di minigiochi senza un mondo permanente è superfluo.
Installazione
Un'installazione tipica richiede circa 5 minuti. Il procedimento è lo stesso; cambiano solo il loader e la build corrispondente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
