UnclaimedChunkRegen

🇺🇸 Description complète EN

🧹 Unclaimed Chunks Regenerator

The server mod that automatically cleans and regenerates unclaimed chunks so your Minecraft world always looks as good as day one.

❓ Why this mod?

On a multiplayer server, players explore, mine, dig holes, chop down forests… and then disappear. The result: a world full of craters, abandoned mines and devastation that nobody ever cleans up. Unclaimed Chunks Regenerator handles it automatically.

When an unclaimed chunk hasn't been visited for a configurable amount of time, the mod purges it from disk. On the next load, Minecraft regenerates it naturally as if it were a brand new chunk. No holes, no lag, no manual intervention.

✨ Features

• Automatic purge on restart — Expired chunks are deleted from disk (.mca) before the server restarts. Minecraft regenerates them cleanly on next load.
• Full FTB Chunks compatibility — Claimed chunks and their protection margin are never touched.
• Configurable frequency per dimension — Overworld every 24h, Nether every 3 days, End every week… You decide.
• Console command checknow — Perfect for scheduled tasks (cron) before an automatic restart.
• 100% server-side — No client mod required. Zero impact on players.

📦 Installation

1. Place unclaimedchunkregen-1.0.0-neoforge-1.21.1.jar in the mods/ folder of your NeoForge 1.21.1 server.
2. Start the server once to generate config/unclaimed_chunk_regen.json.
3. Configure your frequencies and dimensions as needed.
4. Optional: create a scheduled task chunkregen checknow 1 minute before your daily restart.

📋 Commands

• /chunkregen status — Shows mod status and active dimensions.
• /chunkregen reload — Reloads the config without restarting.
• /chunkregen checknow — Immediately runs the cleanup sweep on all dimensions.
• /chunkregen infohere — Shows info about the chunk you're standing in (claim, age, rule).

⚙️ Recommended setup

For a server that restarts daily at 6:00 AM:

• checkIntervalMinutes: 1440 (24h) — No scanning during play hours.
• Cron task at 5:59 AM: chunkregen checknow
• Cron task at 6:00 AM: server restart.

⚠️ Important notes

• Requires NeoForge 21.1.231+ and Java 21.
• Compatible with FTB Chunks (auto-detected, works even without FTB Chunks installed).
• Claimed chunks are never deleted regardless of last visit date.

🇫🇷 Description complète FR

🧹 Unclaimed Chunks Regenerator

Le mod serveur qui nettoie et régénère automatiquement les zones non claim pour que votre monde Minecraft reste toujours aussi beau que le jour 1.

❓ Pourquoi ce mod ?

Sur un serveur multijoueur, les joueurs explorent, minent, creusent des trous, abattent des forêts… et disparaissent. Le résultat : un monde parsemé de ravages, de mines abandonnées et de cratères que personne ne nettoie jamais. Unclaimed Chunks Regenerator s'en charge automatiquement.

Quand un chunk non claim n'a pas été visité depuis un certain temps (configurable), le mod le purge du disque. Au prochain chargement, Minecraft le régénère naturellement comme si c'était un chunk jamais exploré. Zéro trou, zéro lag, zéro intervention manuelle.

✨ Fonctionnalités

• Purge automatique au redémarrage — Les chunks expirés sont supprimés du disque (.mca) avant que le serveur ne redémarre. Minecraft les régénère proprement au chargement suivant.
• Respect total des claims FTB Chunks — Les chunks claim et leur marge de protection ne sont jamais touchés.
• Fréquence configurable par dimension — Overworld toutes les 24h, Nether tous les 3 jours, End toutes les semaines… Vous décidez.
• Commande console checknow — Parfaite pour les tâches planifiées (cron) avant un redémarrage automatique.
• 100% côté serveur — Aucun mod requis côté client. Zéro impact sur les joueurs.
• Messages et logs en français — Tous les messages en jeu et logs serveur sont en français.

📦 Installation

1. Placez le fichier unclaimedchunkregen-1.0.0-neoforge-1.21.1.jar dans le dossier mods/ de votre serveur NeoForge 1.21.1.
2. Démarrez le serveur une première fois pour générer config/unclaimed_chunk_regen.json.
3. Configurez vos fréquences et dimensions selon vos besoins.
4. Optionnel : créez une tâche planifiée chunkregen checknow 1 minute avant votre redémarrage quotidien.

📋 Commandes

• /chunkregen status — Affiche l'état du mod et des dimensions actives.
• /chunkregen reload — Recharge la configuration sans redémarrer.
• /chunkregen checknow — Lance immédiatement le nettoyage sur toutes les dimensions.
• /chunkregen infohere — Affiche les infos du chunk où vous êtes (claim, âge, règle).

⚙️ Configuration recommandée

Pour un serveur qui redémarre tous les jours à 6h00 :

• checkIntervalMinutes : 1440 (24h) — Aucun scan pendant les heures de jeu.
• Tâche cron à 5h59 : chunkregen checknow
• Tâche cron à 6h00 : redémarrage du serveur.

⚠️ Notes importantes

• Nécessite NeoForge 21.1.231+ et Java 21.
• Compatible FTB Chunks (détection automatique, fonctionne même si FTB Chunks n'est pas installé).
• Les chunks claim ne sont jamais supprimés, quelle que soit leur date de dernière visite.