Guide BlueMap : une carte web 3D pour votre serveur Minecraft

Qu'est-ce que BlueMap

BlueMap lit les fichiers de votre monde, en fait des tuiles de carte en 3D et les sert via un petit serveur web intégré. En zoom rapproché, vous voyez les blocs en 3D complète ; en zoom éloigné, une vue d'ensemble à plat. Des marqueurs en direct montrent où se trouvent les joueurs, et la carte se met à jour au fil des changements du monde.

Il ne rend que les mondes Java Edition. La version actuelle, BlueMap 5.29, existe pour :

Pour une version plus ancienne de Minecraft, téléchargez une ancienne version de BlueMap qui la mentionne. Chaque version sur Modrinth et Hangar indique les versions qu'elle prend en charge.

Installer BlueMap

1. Téléchargez le fichier correspondant à votre serveur sur Modrinth, Hangar ou les releases GitHub de BlueMap : le jar -paper pour Paper, -fabric pour Fabric, et ainsi de suite.
2. Placez-le dans le dossier plugins (Paper, Spigot) ou mods (Fabric, Forge, NeoForge) et redémarrez le serveur. L'envoi de plugins est expliqué dans comment installer des plugins Minecraft.
3. BlueMap crée sa configuration dans plugins/BlueMap/, ou config/bluemap/ sur les serveurs moddés, avec une carte déjà prête pour chacun de vos mondes.

À ce stade, la console indique que BlueMap est en attente. Il ne rendra rien tant que vous n'aurez pas accepté le téléchargement, ce qui est l'étape suivante.

Accepter le téléchargement dans core.conf

Pour dessiner les blocs, BlueMap a besoin des textures et des modèles du client Minecraft, qu'il télécharge depuis Mojang. Ouvrez core.conf et modifiez :

accept-download: true

Ce faisant, vous acceptez l'EULA de Mojang et confirmez posséder Minecraft Java Edition. Enregistrez le fichier et lancez /bluemap reload, ou redémarrez. BlueMap télécharge les ressources et commence le rendu.

Donner un port dédié à la carte web

Le serveur web de BlueMap écoute par défaut sur le port 8100. Sur votre propre machine, ouvrez ce port et rendez-vous sur http://your-ip:8100. Sur un serveur hébergé, vous ne pouvez généralement pas choisir librement un port ; vous utilisez donc un port attribué à votre serveur :

1. Obtenez un second port pour votre serveur. Chez HytHost, ouvrez l'onglet Network du panel et ajoutez une allocation : le panel choisit un port libre et l'ouvre pour vous.
2. Ouvrez webserver.conf et réglez port sur ce numéro :

   port: 25570

3. Lancez /bluemap reload et ouvrez http://your-server-ip:25570 dans un navigateur.

N'utilisez pas le port du jeu : c'est celui de Minecraft. Pour afficher la carte sur votre propre domaine sans numéro de port, placez un reverse proxy comme nginx devant ; la documentation de BlueMap propose des exemples prêts à l'emploi.

Commandes BlueMap

Chaque commande a une permission de la forme bluemap.<command>, par exemple bluemap.reload. La plupart du temps, vous n'en avez besoin d'aucune : BlueMap détecte les changements dans le monde et les rend tout seul.

Garder un rendu léger

BlueMap effectue le rendu dans des threads en arrière-plan, pas sur le thread principal du serveur, mais le rendu consomme tout de même du CPU. Le premier rendu d'un grand monde est la partie lourde ; ensuite, seuls les chunks modifiés sont redessinés.

• Threads de rendu : réglez render-thread-count dans core.conf. La documentation de BlueMap conseille 1 sur les machines de quatre cœurs ou moins.
• Rendre aux heures calmes : lancez /bluemap stop aux heures de pointe et /bluemap start la nuit pendant le premier rendu.
• Mettre en pause quand des joueurs sont connectés : player-render-limit dans plugin.conf arrête le rendu dès que ce nombre de joueurs est atteint.
• Définissez une bordure du monde. Elle empêche la carte, et le travail de rendu, de grandir sans fin à mesure que les joueurs explorent.
• Gelez les cartes qui n'ont pas besoin d'être en direct, comme l'End une fois exploré.

Stockage : fichiers ou base de données

Par défaut, BlueMap stocke la carte sous forme de fichiers compressés dans bluemap/web/maps, dans l'espace de votre serveur. La carte grossit avec la zone explorée ; surveillez donc l'espace disque sur un grand monde.

Vous pouvez plutôt déplacer une carte vers une base de données. Dans storages/sql.conf, configurez la connexion à MySQL, MariaDB, PostgreSQL ou SQLite, puis mettez storage: "sql" dans le fichier de configuration de la carte et rechargez :

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

Paper embarque un pilote MySQL ; Spigot, Fabric et Forge nécessitent l'ajout d'un pilote JDBC. Chaque offre Minecraft HytHost inclut des bases de données MySQL, que vous créez dans l'onglet Databases du panel.