Chunk Reset Scheduler

<h2>Chunk Reset Scheduler</h2> <p>Automatically reset defined chunk areas on a real-world schedule. Perfect for regenerating mines, resource zones, story locations or farming areas without relying on in-game time.</p> <hr /> <h3>✨ Features</h3> <ul> <li>Real-world time scheduling (not affected by in-game time or server restarts)</li> <li>Configurable reset zones (center + radius)</li> <li>Custom reset frequency (every X days)</li> <li>Precise reset time (hour + minute)</li> <li>Automatic warning messages (30, 15, 5, 1 minute before reset)</li> <li>Safe execution on main thread</li> </ul> <hr /> <h3>⚙️ Configuration</h3> <p>The config file is located at:</p> <pre>chunkresetscheduler.json</pre> <p>Example configuration:</p> <pre>{ "EnableReset": true, "ChunkResets": [ { "Name": "Spawn Mine", "ChunkX": 0, "ChunkZ": 0, "Radius": 3, "ResetEveryXDays": 7, "ResetAtHour": 3, "ResetAtMinute": 30 } ] }</pre> <h4>Field Explanation</h4> <ul> <li><strong>Name</strong> &ndash; Display name used in warnings</li> <li><strong>ChunkX / ChunkZ</strong> &ndash; Center chunk coordinates (use Ctrl + F3 in-game)</li> <li><strong>Radius</strong> &ndash; Number of chunks around the center to reset</li> <li><strong>ResetEveryXDays</strong> &ndash; Real-world days between resets</li> <li><strong>ResetAtHour</strong> &ndash; Hour of reset (0&ndash;23)</li> <li><strong>ResetAtMinute</strong> &ndash; Minute of reset (0&ndash;59)</li> </ul> <hr /> <h3>⏰ Time &amp; Timezones</h3> <p>This mod uses <strong>server system time</strong>, not in-game time.</p> <ul> <li>If your server runs in UTC, your reset times are also UTC</li> <li>If your server uses a local timezone, resets follow that timezone</li> </ul> <p>If times don&rsquo;t match your expectations, verify your server timezone or adjust your configuration accordingly.</p> <hr /> <h3>🔔 Warnings</h3> <p>Players will receive warnings before a reset:</p> <ul> <li>30 minutes</li> <li>15 minutes</li> <li>5 minutes</li> <li>1 minute</li> </ul> <p>Warnings are sent in chat and are designed to prevent accidental item loss.</p> <hr /> <h3>⚠️ Important Notes</h3> <ul> <li>Chunks are deleted and regenerated when reloaded</li> <li>If players are inside the area during reset, regeneration will be cancelled until next planned reset. A warning is also sent mentionning this.</li> <li>It is recommended to leave the area before reset</li> </ul> <hr /> <h3>💡 Use Cases</h3> <ul> <li>Regenerating mining areas</li> <li>Resetting farming zones</li> <li>Maintaining renewable resource regions</li> <li>Resetting story locations so admins do not have to do it themselves on a consistent basis</li> <li>Server economy balancing</li> </ul> <hr /> <h3>🛠️ Installation</h3> <ol> <li>Download the mod</li> <li>Place it in your server <code>/Mods</code> folder</li> <li>Start the server once to generate the config</li> <li>Edit <code>chunkresetscheduler.json</code></li> <li>Restart the server</li> </ol> <hr /> <h3>📌 Tips</h3> <ul> <li>Use small radii first to test behavior. The more zones you schedule, the more taxing it is for the server stability. Same thing for the radius.</li> <li>Double-check your timezone before going live</li> <li>Watch server logs for scheduled execution</li> </ul> <hr /> <h3>🚨 Disclaimer</h3> <p>By using this mod, you acknowledge that <strong>chunk resets are destructive</strong>.</p> <ul> <li>All blocks, items, and structures within a reset zone will be permanently lost</li> <li>No data is stored or backed up by this mod</li> <li>Lost items, builds, or terrain <strong>cannot be recovered</strong></li> <li>I am <strong>not responsible</strong> for accidental resets, misconfiguration, or resulting data loss</li> </ul> <p>Ensure your configuration is correct and that players are properly informed before enabling automatic resets.</p> <p>Built for server owners who want reliable, automated world maintenance without relying on in-game time.</p> <hr />