Comment installer Dynmap / BlueMap (carte web interactive)

Dynmap et BlueMap sont des plugins qui créent une carte web interactive de votre monde Minecraft, consultable depuis n'importe quel navigateur. Les joueurs y explorent le monde, voient les positions en temps réel et découvrent les constructions. Ce guide compare les deux, puis montre comment installer Dynmap ou BlueMap sur un serveur Minecraft avec OuiPanel, le panel de jeu. Il explique enfin comment publier la carte sur votre propre nom de domaine.

---

Comparer Dynmap et BlueMap

Critère	Dynmap	BlueMap
Rendu	2D, vue satellite	3D, vue isométrique
Espace disque	moyen	plus élevé
Performances	bonnes	moyennes
Qualité visuelle	bonne	excellente
Configuration	simple	très simple
Extensions	nombreuses	quelques-unes
Ressources	léger	plus gourmand

Dynmap affiche une vue 2D de type satellite, avec un zoom.

┌──────────────────────────────┐
│  Carte 2D façon Google Maps  │
│  - Vue du dessus             │
│  - Zoom sur plusieurs niveaux│
│  - Marqueurs et zones        │
└──────────────────────────────┘

BlueMap affiche une vue 3D isométrique.

┌──────────────────────────────┐
│  Carte 3D isométrique        │
│  - Rotation libre            │
│  - Bâtiments en 3D           │
│  - Très détaillée            │
└──────────────────────────────┘

Fonction	Dynmap	BlueMap
Vue	2D satellite	3D isométrique
Port par défaut	8123	8100
Fichiers de configuration	configuration.txt	core.conf, webserver.conf
Intégrations de plugins	nombreuses	quelques-unes
Consommation de RAM	modérée	élevée
Premier rendu	rapide	plus lent
Qualité visuelle	bonne	excellente
Mise en place	simple	très simple

---

Prérequis

Un serveur compatible

Moteur	Dynmap	BlueMap
Paper	oui	oui
Spigot	oui	oui
Purpur	oui	oui
Fabric	oui (mod)	oui (mod)
Forge	oui (mod)	oui (mod)
Vanilla	non	non

Un port supplémentaire

La carte web a besoin de son propre port HTTP.

Service	Port par défaut
Minecraft	25565
Dynmap	8123
BlueMap	8100

Dans OuiPanel, vous ajoutez ce port dans Configuration › Gestion des ports, comme expliqué plus bas.

---

Installer Dynmap

Télécharger Dynmap

1. Ouvrez la page de Dynmap sur SpigotMC et cliquez sur Download.

2. Prenez la version qui correspond à votre version de Minecraft.

Sous Paper, Spigot ou Purpur, vous pouvez aussi chercher Dynmap dans la page Plugins de OuiPanel, onglet Catalogue, puis cliquer sur Installer.

Déposer le plugin

1. Connectez-vous à OuiPanel et sélectionnez votre serveur Minecraft.

2. Dans le menu latéral, ouvrez Gestionnaire de fichiers, puis le dossier plugins.

3. Glissez le fichier Dynmap-*.jar depuis votre ordinateur sur la page. Il n'y a pas de bouton d'envoi.

Premier démarrage

Dans Console, démarrez le serveur. Attendez que Dynmap crée ses fichiers de configuration.

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

Arrêtez ensuite le serveur pour le configurer.

Ajouter un port pour la carte

1. Dans le menu latéral, ouvrez Configuration › Gestion des ports.

2. Cliquez sur Assigner un nouveau port. Le panel l'ajoute tout de suite, sans fenêtre de confirmation.

3. Notez le numéro attribué.

4. Avec Éditer la note, nommez-le par exemple « Port Dynmap ».

Configurer Dynmap

Dans le Gestionnaire de fichiers, ouvrez le fichier suivant. La fenêtre d'édition s'ouvre au clic, et Sauvegarder enregistre vos changements.

/plugins/dynmap/configuration.txt

Vers la ligne 315, réglez le port du serveur web.

# Adresse d'écoute du serveur web
webserver-bindaddress: 0.0.0.0

# Port du serveur web (remplacez par votre port attribué)
webserver-port: 8123

Remplacez 8123 par le port obtenu dans Gestion des ports.

Pour ne pas surcharger le serveur, baissez la qualité du rendu, vers la ligne 16.

# Qualité du rendu (vlowres, lowres, hires)
deftemplatesuffix: lowres

Qualité	Détails	Espace disque	Performances
vlowres	très basse	minimal	excellentes
lowres	basse	faible	très bonnes
hires	haute	élevé	gourmandes

Commencez en lowres et passez en hires seulement si votre serveur a assez de ressources.

Voici une configuration complète conseillée.

# Qualité de rendu
deftemplatesuffix: lowres

# Messages de rendu dans le chat
renderacceleratethreshold: 60
updaterate: 2000

# Serveur web intégré
webserver-bindaddress: 0.0.0.0
webserver-port: 8123

# Nombre max de tuiles en file
parallelrendercnt: 4
tileupdatedelay: 30

# Chat web
allowwebchat: true
webchat-interval: 5

# Visibilité des joueurs
player-info-protected: false
showplayerfacesinmenu: true

Redémarrer et ouvrir la carte

Démarrez le serveur et attendez ce message.

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

Dans votre navigateur, ouvrez l'adresse suivante, avec l'IP de votre serveur et le port de la carte.

http://VOTRE_IP:VOTRE_PORT

Par exemple http://203.0.113.10:8123. L'IP est celle de l'Adresse principale, dans Vue Globale.

Générer la carte

La carte se remplit à mesure que les joueurs explorent. Pour la générer à la main, lancez cette commande.

/dynmap fullrender world

Un rendu complet peut durer longtemps et consommer beaucoup de ressources. Limitez la zone avec une bordure de monde (/worldborder).

Commandes Dynmap

Commande	Description
/dynmap fullrender [monde]	rend tout le monde
/dynmap cancelrender [monde]	annule le rendu en cours
/dynmap pause all	met tous les rendus en pause
/dynmap pause none	reprend les rendus
/dynmap stats	affiche les statistiques
/dynmap hide	cache votre position sur la carte
/dynmap show	affiche votre position
/dmarker add <nom>	ajoute un marqueur

Dans la console de OuiPanel, tapez ces commandes sans la barre oblique.

---

Installer BlueMap

Télécharger BlueMap

Téléchargez BlueMap sur bluemap.bluecolored.de ou sur Modrinth, dans la version de votre serveur.

Serveur	Fichier
Paper, Spigot	BlueMap-*-spigot.jar
Fabric	BlueMap-*-fabric.jar
Forge	BlueMap-*-forge.jar

Déposer le plugin

Dans le Gestionnaire de fichiers, ouvrez le dossier plugins et glissez-y le fichier BlueMap-*.jar. Sous Paper, vous pouvez aussi passer par la page Plugins.

Premier démarrage

Démarrez le serveur. BlueMap crée ses fichiers et affiche ce message.

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

Arrêtez ensuite le serveur.

Accepter le téléchargement des ressources

1. Ouvrez le dossier /plugins/BlueMap/ (ou /config/bluemap/ sous Fabric).

2. Ouvrez le fichier core.conf.

3. Passez la ligne suivante à true, puis cliquez sur Sauvegarder.

accept-download: true

Ajouter un port pour la carte

Dans Configuration › Gestion des ports, cliquez sur Assigner un nouveau port et notez le numéro attribué, comme pour Dynmap.

Configurer le serveur web

Ouvrez webserver.conf dans /plugins/BlueMap/ et modifiez-le ainsi.

# Activer le serveur web intégré
enabled: true

# Adresse d'écoute
ip: "0.0.0.0"

# Port du serveur web (votre port attribué)
port: 8100

# Connexions maximales
max-connections: 100

Régler les mondes (facultatif)

Ouvrez maps/world.conf pour personnaliser l'affichage.

# Nom affiché sur la carte
name: "Mon Monde"

# Position de départ
start-pos: {x: 0, z: 0}

# Limites de la carte (facultatif)
min-x: -5000
max-x: 5000
min-z: -5000
max-z: 5000

# Rendu des grottes
render-caves: true

# Couleur du ciel
sky-color: "#7dabff"

Redémarrer et ouvrir la carte

Démarrez le serveur et attendez ces messages.

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

Ouvrez ensuite la carte dans votre navigateur.

http://VOTRE_IP:VOTRE_PORT

Commandes BlueMap

Commande	Description
/bluemap render [monde]	lance le rendu d'un monde
/bluemap pause	met le rendu en pause
/bluemap resume	reprend le rendu
/bluemap cancel	annule le rendu en cours
/bluemap reload	recharge la configuration
/bluemap maps	liste les cartes
/bluemap version	affiche la version de BlueMap

---

Publier la carte sur un nom de domaine

Le Proxy Manager de OuiPanel donne accès à la carte par un nom de domaine, en HTTPS, au lieu d'une IP et d'un port.

Sans Proxy Manager	Avec Proxy Manager
http://203.0.113.10:8123	https://carte.monserveur.fr
un port à retenir	une adresse simple
HTTP non chiffré	HTTPS chiffré

1. Dans le menu latéral, ouvrez Proxy Manager.

2. La carte La cible DNS de ce serveur donne l'enregistrement à créer : type A, nom @ et une adresse IP. Chez le bureau d'enregistrement de votre domaine, créez ce même enregistrement pour votre sous-domaine, par exemple carte.

3. Cliquez sur Ajouter un domaine. Le formulaire Nouveau branchement s'ouvre.

4. Saisissez le Nom de domaine complet, par exemple carte.monserveur.fr.

5. Dans Port, choisissez le port de votre carte.

6. Laissez HTTPS coché pour obtenir un certificat Let's Encrypt, renouvelé automatiquement.

7. Cliquez sur Vérifier le DNS. Le panel doit répondre « Le DNS pointe bien ici ».

8. Cliquez sur Créer la redirection.

Le domaine apparaît dans Domaines branchés, avec le bouton Ouvrir le site. La carte est alors accessible à l'adresse https://carte.monserveur.fr. La propagation DNS prend de 5 minutes à 48 heures selon votre bureau d'enregistrement. Le guide Configurer un reverse proxy (Proxy Manager) détaille chaque étape.

---

Personnaliser la carte

Ajouter des marqueurs dans Dynmap

En jeu, ajoutez un marqueur avec /dmarker add.

/dmarker add "Spawn Principal" icon:tower
/dmarker add "Shop" icon:chest
/dmarker add "Arène PvP" icon:skull

Icône	Nom
maison	house
coffre	chest
crâne	skull
tour	tower
wagonnet	minecart
étoile	star
drapeau rouge	redflag

Ajouter des marqueurs dans BlueMap

Créez le fichier /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": "Boutique",
      "position": {"x": 100, "y": 64, "z": -50}
    }
  ]
}

Relier Dynmap à d'autres plugins

Dynmap peut afficher les zones de plugins courants grâce à des extensions.

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

Téléchargez l'extension et placez-la dans /plugins/.

---

Optimiser les performances

Limiter la zone de rendu

Avant un rendu complet, posez une bordure de monde.

/worldborder set 10000

Le monde, et donc le rendu, se limite alors à un carré de 10 000 blocs de côté.

Configuration allégée pour Dynmap

# Réduire la fréquence des mises à jour
updaterate: 3000
tileupdatedelay: 60

# Limiter les rendus parallèles
parallelrendercnt: 2

# Désactiver les fonctions lourdes
smooth-lighting: false
better-grass: false

Configuration allégée pour BlueMap

Dans core.conf, réglez ces valeurs.

# Threads de rendu (à ajuster selon la RAM)
render-threads: 2

# Intervalle de mise à jour (en secondes)
update-interval: 300

---

Si la carte ne s'affiche pas

Cause	Solution
Mauvais port	comparez le port de la configuration avec celui de Gestion des ports
Port absent	ajoutez-le avec Assigner un nouveau port
Serveur web non démarré	lisez les journaux du démarrage dans Console

Erreur « Port already in use »

Le port est déjà pris. Changez le port dans la configuration, ou utilisez un autre port de Gestion des ports.

Carte noire ou vide

La carte n'a pas encore été générée. Explorez le monde en jeu, ou lancez un rendu avec /dynmap fullrender world ou /bluemap render world.

Le serveur lag pendant le rendu

• Passez en qualité lowres ou vlowres.

• Baissez parallelrendercnt à 1 ou 2.

• Augmentez tileupdatedelay.

• Lancez les rendus aux heures creuses.

Espace disque insuffisant

Les cartes en haute définition prennent beaucoup de place.

• Utilisez lowres au lieu de hires.

• Limitez la zone avec une bordure de monde.

• Supprimez les anciens rendus dans /plugins/dynmap/web/tiles/.

Pour aller plus loin, consultez le wiki de Dynmap ou le wiki de BlueMap. Les deux projets ont un Discord (discord.gg/dynmap et discord.gg/bluemap).

---

Besoin d'aide ?

Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.

Ouvrir un ticketDiscord