Prégénérer une map Minecraft avec Chunk-Pregenerator

Ce guide vous explique comment utiliser le mod Chunk Pregenerator pour générer votre carte à l'avance, garantissant ainsi une expérience de jeu fluide sans pics de latence CPU.

Introduction

Lorsque vos joueurs explorent de nouvelles zones sur votre serveur Minecraft, le serveur doit générer le terrain en temps réel. Cette opération consomme énormément de ressources CPU et provoque fréquemment des freezes, des chutes de TPS (Ticks Per Second) et une expérience de jeu fortement dégradée.

Chunk-Pregenerator résout ce problème en générant le terrain à l'avance, pendant les périodes creuses. Une fois la zone prégénérée, vos joueurs peuvent explorer librement sans aucun lag lié à la génération de chunks.

Pourquoi prégénérer votre map ?

Avantage	Impact
Exploration fluide	Élimine les freezes lors de la découverte de nouvelles zones
TPS stable	Le serveur maintient un TPS optimal (≥18) même sous forte charge
Réduction CPU	Diminue les pics de charge de 40 à 60% pendant les heures de jeu
Préparation serveur	Permet de configurer correctement la map avant l'ouverture d'une saison
Meilleure jouabilité	Améliore significativement l'expérience utilisateur

Prérequis

Avant de commencer, vérifiez que vous disposez de :

Élément	Description
Serveur Forge ou Fabric	Le mod nécessite un loader de mods (Minecraft 1.7.10 à 1.21+)
Chunk-Pregenerator	Version compatible avec votre serveur (téléchargement CurseForge)
Accès administrateur	Permissions OP ou accès console pour exécuter les commandes
Espace disque suffisant	Prévoir 2 à 8 Go selon la taille de prégénération
Période creuse	Idéalement, effectuer la prégen lorsque le serveur est vide

⚠️ Important : Effectuez toujours une sauvegarde complète de votre monde avant de lancer une prégénération massive.

Compatibilité des versions

Version Minecraft	Version du mod	Syntaxe des commandes
1.7.10 - 1.12.2	Legacy	Syntaxe ancienne (`startradius`)
1.13 - 1.21+	Moderne	Syntaxe nouvelle (`start gen radius`)

Installation du mod

Étape 1 : Téléchargement

Rendez-vous sur CurseForge
Sélectionnez la version correspondant à votre serveur Minecraft
Téléchargez le fichier .jar

Étape 2 : Installation

Connectez-vous à votre espace client VeryCloud
Accédez au gestionnaire de fichiers de votre serveur
Placez le fichier .jar dans le dossier mods/
Redémarrez votre serveur

Étape 3 : Vérification

Vérifiez dans les logs de démarrage que le mod est correctement chargé :

[Server thread/INFO] [FML]: Loaded mod Chunk-Pregenerator version X.X.X

Commandes pour Minecraft 1.13 et versions ultérieures

Méthode 1 : Génération 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_zone`)
`<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 de rayon (noter le 'b')
/pregen start gen radius MainWorld SQUARE 0 0 3000b

Méthode 2 : Génération via WorldBorder

Cette méthode utilise la bordure de monde native de Minecraft pour définir automatiquement la zone à générer.

Étape 1 : Définir le centre de la WorldBorder

/worldborder center <X> <Z>

Exemple :

/worldborder center 0 0

Étape 2 : Définir la taille de la WorldBorder

/worldborder set <diamètre>

💡 Attention : La valeur est un diamètre, pas un rayon. Pour une zone de 3000 blocs autour du spawn, entrez 6000.

Exemple :

# WorldBorder de 6000 blocs de diamètre (3000 blocs dans chaque direction)
/worldborder set 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 définie.

Commandes de contrôle

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 en cours
`/pregen info listen`	Affiche la progression en temps réel dans le chat
`/pregen info unlisten`	Désactive l'affichage de progression

Exemple de workflow complet :

# 1. Lancer la prégénération
/pregen start gen radius Saison1 SQUARE 0 0 3000b

# 2. Surveiller la progression
/pregen info listen

# 3. Mettre en pause si nécessaire (joueurs connectés)
/pregen pause

# 4. Reprendre plus tard
/pregen resume

# 5. Arrêter le suivi une fois terminé
/pregen info unlisten

Commandes pour Minecraft 1.7.10 à 1.12.2

Méthode 1 : Génération 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, avec 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' AVANT le nombre)
/pregen gen startradius square 0 0 b3000

📝 Différence importante : En version legacy, le préfixe b se place avant le nombre (b3000), alors qu'en 1.13+ il se place après (3000b).

Méthode 2 : Génération 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, contre worldborder (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.7.10 - 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`
Mettre en 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 (rayon)	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 (5-10 joueurs)	1500-2000 blocs	Suffisant pour débuter
Survie classique (10-30 joueurs)	3000 blocs	Bon compromis taille/performance
Grande communauté (30+ joueurs)	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
✅ Période de maintenance	Profitez des maintenances planifiées
❌ Heures de pointe	À éviter : la prégen consomme énormément de CPU
❌ Sans sauvegarde	Toujours effectuer un backup complet avant

Surveillance des ressources

Pendant la prégénération, surveillez les ressources via votre espace client VeryCloud :

Ressource	Outil de surveillance	Seuil d'alerte
CPU	Panel VeryCloud	> 90% prolongé
RAM	Panel VeryCloud	> 85%
Disque	Panel VeryCloud	Vérifier l'espace libre régulièrement
TPS	Commande `/tps` en jeu	< 15 TPS

⚠️ Attention : Une prégénération de grande taille peut remplir rapidement votre espace disque. Un monde Minecraft avec 3000 blocs de rayon peut facilement atteindre 4 à 6 Go.

Optimisation de la prégénération

Pour un VPS VeryCloud :

VPS KVM SSD : Prégénération de 1500-2500 blocs recommandée
VPS KVM NVMe : Prégénération jusqu'à 3500 blocs sans problème
VPS KVM Ryzen : Performances optimales, jusqu'à 5000+ blocs

Astuce : Lancez la prégénération pendant la nuit et surveillez les logs le lendemain matin.

Dépannage

La commande ne fonctionne pas

Problème	Solution
Commande inconnue	Vérifiez que le mod est bien installé dans `/mods/` et chargé au démarrage
Permission refusée	Assurez-vous d'être OP (`/op <votre_pseudo>`) ou d'utiliser la console serveur
Mauvaise syntaxe	Vérifiez la version du mod et utilisez la syntaxe correspondante (legacy vs moderne)

La prégénération est très lente

Cause	Solution
Serveur surchargé	Attendez une période creuse ou augmentez les ressources
RAM insuffisante	Augmentez l'allocation mémoire Java dans les paramètres du serveur
Autres plugins lourds	Désactivez temporairement les plugins non essentiels (WorldEdit, Dynmap, etc.)
Stockage SSD lent	Envisagez de migrer vers un VPS NVMe ou Ryzen VeryCloud

Le serveur lag pendant la prégénération

Actions immédiates :

# Mettre en pause la prégénération
/pregen pause

# Vérifier le TPS
/tps

# Si TPS < 15, arrêter la prégen
/pregen stop

Solutions long terme :

Effectuez la prégénération uniquement la nuit
Divisez la prégénération en plusieurs sessions
Upgradez vers un serveur VeryCloud avec plus de CPU/RAM

Estimation du temps de prégénération

Taille	VPS SSD	VPS NVMe	VPS Ryzen
1500 blocs	~30-45 min	~20-30 min	~15-20 min
3000 blocs	~2-3h	~1-2h	~45min-1h
5000 blocs	~6-8h	~4-5h	~2-3h

Estimations basées sur des configurations VeryCloud standards avec allocation RAM optimale

Checklist avant ouverture de serveur

Utilisez cette checklist pour vous assurer que tout est prêt :

Mod Chunk-Pregenerator installé et fonctionnel
Sauvegarde complète du monde effectuée
WorldBorder configurée (si utilisée)
Prégénération lancée pendant une période creuse
Espace disque vérifié (au moins 10 Go libres recommandés)
Progression suivie jusqu'à completion à 100%
Test de TPS effectué après prégénération (/tps > 18)
Test de connexion joueur sur les zones prégénérées

Résumé

Chunk-Pregenerator est un outil indispensable pour tout serveur Minecraft hébergé sur VeryCloud souhaitant offrir une exploration fluide et sans lag. En générant le terrain à l'avance, vous éliminez les freezes, maintenez un TPS stable et offrez une expérience de jeu optimale à votre communauté.

Points clés à retenir :

Toujours effectuer une sauvegarde avant de lancer une prégénération
Choisir une période creuse pour minimiser l'impact sur les joueurs
Surveiller les ressources CPU/RAM via le panel VeryCloud
Adapter la taille de prégénération à la capacité de votre serveur
Tester le TPS après completion pour valider les performances

Besoin d'aide ?

Si vous rencontrez des difficultés avec Chunk-Pregenerator sur votre serveur VeryCloud :

Documentation : docs.verycloud.fr
Support technique 24/7 : Ouvrez un ticket depuis votre espace client
Communauté Discord : Rejoignez notre serveur Discord (600+ membres)
Statut des services : status.verycloud.fr