BlueMap — un plugin pour générer une carte du monde 3D interactive dans le navigateur pour Minecraft

BlueMap — un plugin pour générer une carte du monde 3D interactive dans le navigateur pour Minecraft

BlueMap est un plugin Minecraft qui lit les fichiers du monde et construit un modèle de surface tridimensionnel à partir de ceux-ci, accessible dans un navigateur via un serveur web intégré. Le client standard ne rend le monde qu'autour du joueur et ne donne pas de vue de dessus ou de l'extérieur. Le plugin forme une carte complète avec la possibilité de faire pivoter la caméra, de passer en mode perspective ou isométrique (plat) et de voir les structures en suivant simplement une URL. Il résout un problème : la visualisation externe du monde du serveur sans avoir besoin de se connecter au jeu.

Comment fonctionne le rendu

Le plugin divise les chunks en tuiles et génère deux couches de détail : des modèles hires avec la géométrie complète des blocs et une carte lowres pour la vue de loin. Hires est actif lors d'un zoom rapproché — on voit alors des blocs spécifiques, des textures et des hauteurs. Avec un zoom plus éloigné, une couche simplifiée avec des taches de couleur des biomes et le paysage est chargée.

Processus de rendu dans l'interface web : les tuiles se chargent progressivement lors du zoom. 

Le rendu est effectué de manière asynchrone dans un pool de threads séparé. Le thread principal du serveur Minecraft n'est pas bloqué — tant que le processeur a des cœurs libres, les joueurs ne ressentiront pas de lags dus à la construction de la carte. Le plugin suit lui-même les changements dans le monde : BlueMap vérifie périodiquement les fichiers mca, repère les chunks modifiés et ne rend que ceux-ci. Les commandes manuelles du type /bluemap update sont rarement nécessaires — principalement pour le diagnostic.

Rendu dans l'interface web à la première personne 

Commandes

Le plugin enregistre une seule commande racine /bluemap avec des sous-commandes. La plupart des cas ne nécessitent aucune commande — le rendu fonctionne automatiquement.

Exécution de la commande /bluemap 

Configuration

Le dossier du plugin contient quatre fichiers de configuration : core.conf, plugin.conf, webapp.conf, webserver.conf. Ainsi que trois sous-dossiers : maps/ (un .conf pour chaque monde), packs/ (packs de ressources pour le rendu) et storages/ (file.conf pour le système de fichiers, sql.conf pour la base SQL).

core.conf

Le fichier principal. Le paramètre clé est accept-download, qui doit être défini sur true pour le premier lancement. Le paramètre render-thread-count (par défaut 1) définit le nombre de threads de rendu — une valeur négative signifie « nombre de cœurs CPU moins la valeur absolue du nombre ». metrics (true) contrôle l'envoi de statistiques anonymes.

plugin.conf

Paramètres de visibilité des joueurs sur la carte et du comportement de rendu :

webapp.conf

Paramètres de l'application web. default-to-flat-view (false) détermine la vue de départ — perspective ou isométrique. Les curseurs hires-slider-default (100) et lowres-slider-default (2000) définissent la distance du rendu détaillé et simplifié en blocs. resolution-default (1) accepte les valeurs 0.5, 1 ou 2. Les tableaux scripts et styles incluent des fichiers JS et CSS personnalisés.

webserver.conf

Serveur web intégré. enabled (true) — activer ou désactiver. port (8100) — le port. webroot ("bluemap/web") — répertoire avec les fichiers de l'application web (doit correspondre au webroot dans webapp.conf). La section log configure l'enregistrement de l'activité HTTP dans un fichier.

Conclusion

BlueMap permet la visualisation externe du monde au format d'un modèle 3D complet avec rotation de la caméra et vol libre. Le plugin convient aux serveurs de survie et RPG, où il est important pour les joueurs de partager des coordonnées et d'inspecter les bâtiments ; pour les serveurs de mini-jeux sans monde permanent, il est inutile.