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

Un joueur qui part à 3000 blocs du spawn peut faire tomber un serveur à 8 TPS si les chunks n'existent pas encore. La prégénération crée ces zones avant l'ouverture, quand personne ne subit les pics CPU et disque. Vous obtenez une bordure déjà calculée, des déplacements plus propres, et une facture disque que vous savez lire avant de cliquer sur démarrer.

Installer Chunk-Pregenerator sur un serveur Minecraft 2026

Vérifiez d'abord le couple version, loader, Java. Minecraft 1.20.6 et 1.21.x tournent en pratique sous Java 21 côté serveur. Un ancien jar compilé pour Java 17 peut encore démarrer sur certaines installations, mais un serveur récent renvoie vite UnsupportedClassVersionError si le runtime ne suit pas. Tapez la commande avant de déplacer un fichier.

java -version

Sur Paper, placez le fichier du plugin dans plugins/, puis redémarrez le serveur. Sur Fabric ou Forge, mettez le jar dans le dossier mods, avec la version du loader qui correspond à la version Minecraft. Ne mélangez pas les familles. Un jar Fabric dans un serveur Paper ne se charge pas. Un jar Paper dans Fabric ne fait rien. Il ajoute seulement dix minutes de lecture de console.

Le port 25565 ne change rien à la prégénération. Il sert aux connexions. Le travail lourd se passe dans le thread serveur, dans les fichiers region, et sur le disque. Sur une offre 4 Go, Paper 1.21.x avec dix à vingt joueurs accepte une prégénération modérée si la map reste fermée. Avec 8 Go, vous gagnez surtout de la marge pour le cache et les plugins. Ce n'est pas un bouton magique pour générer 100000 blocs en une heure.

Sur le panel Starmine, l'installation évite surtout la manipulation FTP du jar, le redémarrage à la main, et les logs ouverts dans trois endroits. Pour cette opération, vous gardez la console, les fichiers du monde et l'arrêt planifié au même endroit. Quand une tâche dure plusieurs heures, ce détail fait gagner du temps.

Calculer le rayon de prégénération sans exploser le disque

Vous choisissez un rayon en blocs, mais le serveur écrit des chunks de 16 blocs. Un carré de 5000 blocs autour de 0 0 couvre 10000 blocs par 10000 blocs, soit 625 chunks par côté. Cela fait environ 390625 chunks à créer dans l'Overworld. Le chiffre calme vite les envies de map infinie.

Comptez large pour le disque. Un chunk vide ne pèse presque rien. Un chunk avec biomes, grottes, villages, structures, données de lumière et entités de bloc finit souvent entre 4 Ko et 20 Ko dans les fichiers region. Une prégénération carrée de 5000 blocs finit souvent entre 2 Go et 8 Go selon la version, le seed, les datapacks et les mods de génération. Avec Terralith, Biomes O' Plenty ou des structures lourdes, la borne haute arrive plus vite.

Un rayon de 10000 blocs n'est pas deux fois plus lourd que 5000. Il couvre quatre fois plus de surface. C'est l'erreur classique. Vous payez le carré de la distance, pas la distance affichée dans le chat.

Lancer une prégénération Overworld proprement

Fermez le serveur aux joueurs avant le premier lancement. Une whitelist active et un restart propre valent mieux qu'un message Discord envoyé trop tard. La prégénération remplit le même monde que les joueurs utilisent. Si quelqu'un explore pendant la tâche, vous mélangez génération, sauvegarde, entités et téléportations dans le même budget de 50 ms par tick. Le serveur choisit rarement la partie qui vous arrange.

1. Arrêtez le serveur depuis le panel ou la console. Vérifiez que le dossier world existe et que le seed est le bon dans server.properties. Changer le seed après une prégénération crée des frontières laides entre anciens et nouveaux chunks.
2. Démarrez le serveur. Attendez Done dans la console. Ce message confirme que les dimensions sont chargées et que les commandes répondent.
3. Lancez la commande depuis la console, pas depuis le chat d'un joueur. La console évite les problèmes de permissions LuckPerms, d'opérateurs oubliés, et de déconnexion pendant la saisie.

/pregen gen startradius square 0 0 5000 minecraft:overworld

Cette commande génère un carré centré sur X 0, Z 0, avec un rayon de 5000 blocs dans l'Overworld. Le carré colle mieux à une worldborder carrée. Si votre bordure est ronde, choisissez une forme circle si votre build de Chunk-Pregenerator la propose dans l'aide de commande. Ne recopiez pas une syntaxe écrite pour une autre branche du plugin. En cas de doute, /pregen help donne la grammaire chargée par votre jar, pas celle d'une capture de 2021.

Régler la vitesse de génération sans tomber à 5 TPS

La vitesse se lit dans les TPS et le MSPT. À 20 TPS, un tick tient dans 50 ms. Si la console affiche régulièrement 80 à 120 ms pendant la prégénération, le serveur prend du retard. Le message Can't keep up! Is the server overloaded? Running 5000ms or 100 ticks behind n'est pas décoratif. Il dit que le serveur empile cinq secondes de retard.

Laissez max-tick-time à 60000 pendant les tests. Le mettre à -1 évite certains crashs de watchdog, mais masque aussi une tâche bloquée. C'est une mauvaise idée sur un serveur que vous ne surveillez pas. Un crash propre avec un rapport vaut mieux qu'un Java qui consomme 100 % CPU pendant huit heures.

La pause sert vraiment. Utilisez /pregen pause avant une sauvegarde manuelle, un rendu de carte ou une maintenance. Relancez avec /pregen resume quand le disque redescend. Sur un serveur 4 Go, ne lancez pas BlueMap, une sauvegarde compressée et Chunk-Pregenerator en même temps. Les trois lisent ou écrivent massivement les mêmes dossiers, souvent au moment où les fichiers region grossissent le plus.

Prégénérer Nether et End avec des rayons réalistes

Le Nether ne demande pas le même rayon que l'Overworld. Un bloc dans le Nether correspond à huit blocs de déplacement en Overworld pour les portails. Si votre Overworld est préparé à 5000 blocs, un rayon Nether de 625 blocs couvre déjà le lien de voyage direct. En pratique, mettez 1000 à 1500 blocs pour les forteresses, les bastions et les erreurs de portail. Au-delà de 3000 blocs, vous remplissez surtout du netherrack que personne ne verra.

/pregen gen startradius square 0 0 1250 minecraft:the_nether

L'End se traite autrement. Le spawn central tient dans un rayon faible, mais les villes de l'End commencent loin, souvent au-delà de 1000 blocs après les portails. Pour une communauté qui chasse les élytres, un rayon de 4000 à 6000 blocs se défend. Pour un serveur privé, 2000 blocs suffisent souvent, puis vous ouvrez plus tard si les joueurs vident la zone.

Sur disque, les dossiers de dimensions séparées comptent. L'Overworld écrit dans world/region, le Nether dans world/DIM-1/region, l'End dans world/DIM1/region sur beaucoup de serveurs Paper. Une sauvegarde zip de 12 Go peut devenir 20 Go après rendu de carte, car les tuiles BlueMap ou dynmap doublent parfois le volume utile. Si votre quota est 25 Go, gardez 5 Go libres. En dessous, l'erreur No space left on device arrive au pire moment, pendant une sauvegarde ou une fermeture.

Vérifier la map générée et réparer une prégénération ratée

Ne validez pas une prégénération parce que la commande ne tourne plus. Validez-la avec trois preuves. La console doit afficher une fin de tâche, souvent Task completed ou Generation finished selon le build. Le dossier region doit contenir de nouveaux fichiers mca avec une date récente. Un trajet en spectator à 500, 2000 puis 4800 blocs du centre doit rester proche de 20 TPS, sans pics de génération visibles dans la console.

Si le serveur redémarre au milieu, ouvrez d'abord latest.log. Cherchez OutOfMemoryError, Watchdog, Can't keep up et No space left on device. Ces quatre messages couvrent la majorité des soirées perdues. La mémoire manque rarement seule. Le disque saturé et les réglages de vitesse trop agressifs causent plus de dégâts, surtout avec des datapacks de structures.

Supprimer des fichiers region détruit les chunks concernés. Les constructions, coffres, entités, villages modifiés et changements de terrain dans cette zone disparaissent. Faites une sauvegarde complète du dossier du monde avant de retirer un seul fichier mca.

Pour arrêter une tâche qui part mal, utilisez /pregen stop, attendez la confirmation, puis stoppez le serveur proprement. Ne tuez pas le processus Java pendant une écriture disque, sauf blocage total. Les fichiers region supportent mal les coupures au milieu d'une sauvegarde. Un arrêt sale peut transformer une génération ratée en restauration complète.

Gardez une règle fixe : rayon documenté, seed noté, version Minecraft notée, date de génération notée. Le jour où vous passez de 1.21.4 à 1.21.8, vous savez quelles zones datent de l'ancien générateur. C'est ce détail qui évite les tickets impossibles trois semaines après l'ouverture.

Guides

Est-ce que les joueurs peuvent jouer pendant la prégénération ?

Oui, techniquement, mais ce n'est pas propre. Gardez la whitelist active pendant les gros rayons, surtout au-dessus de 5000 blocs. Les déplacements des joueurs ajoutent de la génération et des sauvegardes pendant la tâche, exactement au moment où vous cherchez une charge stable.

Pourquoi mon serveur lag encore alors que la map est prégénérée ?

La prégénération supprime surtout le coût de création des chunks. Elle ne corrige pas les fermes à entités, les hoppers, les plugins lourds, une view-distance à 12 ou un rendu de carte lancé en même temps.

Combien de temps prend un rayon de 5000 blocs ?

Sur un serveur récent, comptez souvent de 2 à 8 heures pour l'Overworld selon le CPU, le disque, les structures et les datapacks. Si les MSPT dépassent 80 ms pendant plusieurs minutes, baissez la vitesse au lieu de laisser finir dans de mauvaises conditions.

Faut-il prégénérer avant ou après installer les datapacks de génération ?

Toujours avant ouverture, mais après installation des datapacks qui changent le terrain. Si vous ajoutez un datapack de biomes après coup, les anciens chunks gardent l'ancien terrain et les nouveaux créent des coupures visibles.