Prégénérer une map Minecraft avec Chunk-Pregenerator
Introduction
Lorsque vos joueurs explorent de nouvelles zones, le serveur doit générer le terrain en temps réel. Cette opération est très gourmande en ressources et provoque souvent des freezes, des chutes de TPS et une expérience de jeu dégradée.
Chunk-Pregenerator résout ce problème en générant le terrain à l'avance. Une fois la zone prégénérée, les joueurs peuvent explorer sans aucun lag lié à la génération de chunks.
Pourquoi prégénérer sa map ?
| Avantage | Description |
|---|---|
| Exploration fluide | Plus de freezes lors de la découverte de nouvelles zones |
| TPS stable | Le serveur n'a plus à calculer le terrain à la volée |
| Préparation serveur | Idéal avant l'ouverture d'une nouvelle saison |
| Réduction CPU | Moins de pics de charge pendant les heures de jeu |
Prérequis
| Élément | Description |
|---|---|
| Serveur Forge ou Fabric | Le mod nécessite un loader de mods |
| Chunk-Pregenerator | Téléchargé depuis CurseForge |
| Accès console/OP | Droits administrateur pour exécuter les commandes |
| Espace disque | Prévoir suffisamment de stockage selon la taille de prégen |
⚠️ Important : Effectuez une sauvegarde de votre monde avant toute prégénération massive.
Compatibilité des versions
| Version Minecraft | Version du mod | Syntaxe des commandes |
|---|---|---|
| 1.7.x - 1.12.2 | Legacy | Ancienne syntaxe |
| 1.13 - 1.21+ | Moderne | Nouvelle syntaxe |
Téléchargement officiel : https://www.curseforge.com/minecraft/mc-mods/chunkpregenerator
Installation du mod
- Téléchargez la version correspondant à votre serveur sur CurseForge
- Placez le fichier
.jardans le dossiermodsde votre serveur - Redémarrez le serveur
- Vérifiez que le mod est chargé dans les logs
Commandes pour Minecraft 1.13+ et versions ultérieures
Générer une zone par rayon
Syntaxe complète :
/pregen start gen radius <nom> <forme> <X> <Z> <taille>
Paramètres détaillés :
| Paramètre | Description | Valeurs possibles |
|---|---|---|
<nom> | Identifiant unique de la tâche | Texte libre (ex: spawn_pregen) |
<forme> | Forme de la zone à générer | SQUARE (carré) ou CIRCLE (cercle) |
<X> | Coordonnée X du centre | Nombre entier (ex: 0) |
<Z> | Coordonnée Z du centre | Nombre entier (ex: 0) |
<taille> | Rayon de la zone | En chunks ou en blocs avec suffixe b |
Exemples concrets :
# Générer un carré de 100 chunks autour du spawn
/pregen start gen radius SpawnZone SQUARE 0 0 100
# Générer un cercle de 50 chunks centré en 500, 500
/pregen start gen radius BaseZone CIRCLE 500 500 50
# Générer un carré de 3000 blocs (noter le 'b' à la fin)
/pregen start gen radius MainWorld SQUARE 0 0 3000b Générer via WorldBorder (1.13+)
Cette méthode utilise la bordure de monde vanilla pour définir la zone à générer.
Étape 1 : Définir le centre de la WorldBorder
/worldborder center <X> <Z>
| Paramètre | Description |
|---|---|
<X> | Coordonnée X du centre |
<Z> | Coordonnée Z du centre |
Exemple :
/worldborder center 0 0
Étape 2 : Définir la taille de la WorldBorder
/worldborder set <diamètre>
| Paramètre | Description |
|---|---|
<diamètre> | Taille totale en blocs (diamètre, pas rayon) |
Exemple :
# WorldBorder de 6000 blocs de diamètre (3000 blocs dans chaque direction)
/worldborder set 6000
💡 Attention : La valeur est un diamètre, pas un rayon. Pour une zone de 3000 blocs autour du spawn, entrez
6000.
Étape 3 : Lancer la prégénération
/pregen start gen worldborder
Cette commande génère automatiquement tous les chunks à l'intérieur de la WorldBorder.
Commandes de contrôle (1.13+)
| Commande | Action |
|---|---|
/pregen pause | Met la génération en pause |
/pregen resume | Reprend une génération en pause |
/pregen stop | Arrête définitivement la génération |
/pregen info listen | Affiche la progression en temps réel |
/pregen info unlisten | Désactive l'affichage de progression |
Exemple de workflow :
# Lancer la prégen
/pregen start gen radius MapSaison1 SQUARE 0 0 3000b
# Surveiller la progression
/pregen info listen
# Mettre en pause si besoin (joueurs connectés)
/pregen pause
# Reprendre plus tard
/pregen resume
# Arrêter le suivi une fois terminé
/pregen info unlisten
Commandes pour Minecraft 1.4.3 à 1.12.2
Générer une zone par rayon (legacy)
Syntaxe complète :
/pregen gen startradius <forme> <X> <Z> <taille>
Paramètres détaillés :
| Paramètre | Description | Valeurs possibles |
|---|---|---|
<forme> | Forme de la zone | square (carré) ou circle (cercle) |
<X> | Coordonnée X du centre | Nombre entier |
<Z> | Coordonnée Z du centre | Nombre entier |
<taille> | Rayon en chunks ou blocs | Nombre, préfixe b pour les blocs |
Exemples concrets :
# Générer un carré de 100 chunks autour du spawn
/pregen gen startradius square 0 0 100
# Générer un cercle de 50 chunks
/pregen gen startradius circle 0 0 50
# Générer une zone de 3000 blocs (noter le 'b' devant le nombre)
/pregen gen startradius square 0 0 b3000
📝 Différence avec 1.13+ : En legacy, le préfixe
bse place avant le nombre (b3000), alors qu'en 1.13+ il se place après (3000b).
Générer via WorldBorder (legacy)
Étape 1 : Configurer la WorldBorder
/worldborder center <X> <Z>
/worldborder set <diamètre>
Étape 2 : Lancer la génération
/pregen gen startWorldBorder
⚠️ Attention : La commande s'écrit
startWorldBorder(avec majuscules) en legacy, contreworldborder(minuscules) en 1.13+.
Commandes de contrôle (legacy)
| Commande | Action |
|---|---|
/pregen stop | Arrête la génération |
/pregen continue | Reprend une génération arrêtée |
/pregen clear | Arrête et supprime complètement la tâche |
/pregen info listen | Affiche la progression |
/pregen info unlisten | Masque la progression |
Tableau comparatif des commandes
| Action | Minecraft 1.13+ | Minecraft 1.4.3 - 1.12.2 |
|---|---|---|
| Générer par rayon | /pregen start gen radius <nom> <forme> <X> <Z> <taille> | /pregen gen startradius <forme> <X> <Z> <taille> |
| Générer via WorldBorder | /pregen start gen worldborder | /pregen gen startWorldBorder |
| Pause | /pregen pause | N/A |
| Reprendre | /pregen resume | /pregen continue |
| Arrêter | /pregen stop | /pregen stop |
| Supprimer tâche | N/A | /pregen clear |
| Suivre progression | /pregen info listen | /pregen info listen |
| Distance en blocs | Suffixe b après (3000b) | Préfixe b avant (b3000) |
Calculer la taille de prégénération
Correspondance chunks / blocs
| Chunks | Blocs (diamètre) | Surface approximative |
|---|---|---|
| 50 | 800 | ~640 000 blocs² |
| 100 | 1 600 | ~2,5 millions blocs² |
| 185 | 3 000 | ~9 millions blocs² |
| 250 | 4 000 | ~16 millions blocs² |
| 375 | 6 000 | ~36 millions blocs² |
💡 Rappel : 1 chunk = 16 blocs de côté
Recommandations selon l'usage
| Type de serveur | Rayon conseillé | Remarque |
|---|---|---|
| Petite survie | 1500-2000 blocs | Suffisant pour le début |
| Survie classique | 3000 blocs | Bon compromis taille/performance |
| Grande communauté | 5000+ blocs | Prévoir espace disque conséquent |
| Map limitée (saison) | Selon WorldBorder | Générez exactement la zone jouable |
Bonnes pratiques
Quand lancer une prégénération ?
| Moment | Recommandation |
|---|---|
| ✅ Serveur vide | Idéal : tôt le matin ou tard la nuit |
| ✅ Avant ouverture | Préparez la map avant d'accueillir les joueurs |
| ❌ Heures de pointe | À éviter : la prégen consomme beaucoup de CPU |
| ❌ Sans sauvegarde | Toujours backup avant une grosse prégen |
Surveillance des ressources
Pendant la prégénération, surveillez :
| Ressource | Outil | Seuil d'alerte |
|---|---|---|
| CPU | Panel hébergeur ou htop | > 90% prolongé |
| RAM | Panel hébergeur | > 85% |
| Disque | Panel hébergeur | Vérifier l'espace libre régulièrement |
| TPS | /tps en jeu | < 15 TPS |
⚠️ Attention : Une prégen de grande taille peut remplir rapidement votre espace disque. Un monde Minecraft avec 3000 blocs de rayon peut facilement atteindre plusieurs Go.
Dépannage
La commande ne fonctionne pas
| Problème | Solution |
|---|---|
| Commande inconnue | Vérifiez que le mod est bien installé et chargé |
| Permission refusée | Assurez-vous d'être OP ou d'utiliser la console |
| Mauvaise syntaxe | Vérifiez la version du mod et utilisez la bonne syntaxe |
La prégen est très lente
| Cause | Solution |
|---|---|
| Serveur surchargé | Attendez une période creuse |
| RAM insuffisante | Augmentez l'allocation mémoire |
| Autres plugins lourds | Désactivez temporairement les plugins non essentiels |
Le serveur lag pendant la prégen
| Action | Commande |
|---|---|
| Mettre en pause | /pregen pause (1.13+) |
| Arrêter | /pregen stop |
| Reprendre plus tard | /pregen resume ou /pregen continue |
Récapitulatif des captures d'écran
| N° | Contenu de la capture |
|---|---|
| 1 | Dossier mods avec le fichier Chunk-Pregenerator visible |
| 2 | Console serveur avec commande pregen et message de confirmation |
| 3 | Vue en jeu de la WorldBorder (effet visuel aux bordures) |
Résumé
Chunk-Pregenerator est un outil indispensable pour tout serveur Minecraft souhaitant offrir une exploration fluide. En générant le terrain à l'avance, vous éliminez les freezes et maintenez un TPS stable, même avec une communauté active qui explore dans toutes les directions.
Checklist avant ouverture :
- [ ] Mod installé et fonctionnel
- [ ] Sauvegarde du monde effectuée
- [ ] WorldBorder configurée (optionnel)
- [ ] Prégénération lancée en période creuse
- [ ] Espace disque vérifié
- [ ] Progression suivie jusqu'à completion

