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
.jardans le dossiermods/ - 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
bse 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, 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.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