BetterReset

<div align="center"> # 🚀 BetterReset 🚀 ### The Definitive Live World Reset Tool </div> <div align="center"> !(https://img.shields.io/badge/Minecraft-1.21.x%2B-28A745?style=for-the-badge&logo=minecraft) !(https://img.shields.io/badge/API-Paper%2FSpigot-2875D7?style=for-the-badge) !(https://img.shields.io/badge/Java-17%2B-E86F00?style=for-the-badge&logo=openjdk) !(https://img.shields.io/badge/Version-1.2.1-8A2BE2?style=for-the-badge) !(https://img.shields.io/badge/Status-Production_Ready-34C759?style=for-the-badge) </div> > **A complete, all-in-one solution for safely resetting worlds while your server is running. Featuring a powerful GUI, an intelligent archive system, and a robust force-unload engine to guarantee a flawless, instant, and safe experience.** --- ## ✨ Core Features <table> <tr> <td width="50%" align="center"> <h3>🖥️ Full GUI Control</h3> Manage every aspect of the plugin—resets, archives, and all configuration settings—from a sleek, intuitive in-game interface. </td> <td width="50%" align="center"> <h3>⚡ Instant-Feel Resets</h3> New worlds are pre-generated during the countdown, allowing for a near-instantaneous switch with zero post-reset lag. </td> </tr> <tr> <td width="50%" align="center"> <h3>🛡️ Force Unload Engine</h3> Aggressively unloads stubborn worlds by retrying, re-teleporting, and even kicking stuck players to guarantee the reset never fails. </td> <td width="50%" align="center"> <h3>🔄 Total Player Reset</h3> Provide a true "Fresh Start." All online players have their inventories, XP, health, and hunger wiped clean upon reset. </td> </tr> <tr> <td width="50%" align="center"> <h3>🗄️ Intelligent Archive System</h3> Old worlds are automatically archived with detailed tooltips showing <strong>total playtime</strong> and <strong>estimated storage size</strong>. </td> <td width="50%" align="center"> <h3>⚙️ Live Config Editor</h3> Tweak every plugin setting from the in-game Settings GUI. Changes are applied instantly without needing restarts or file edits. </td> </tr> </table> --- ## 🖥️ The All-in-One Control Panel The `/betterreset` command is your gateway to complete control. - **Main Manager**: The central hub to access all plugin functions. - **Reset Worlds**: A clean, focused view that shows **only your current base world**. Select dimensions (Overworld, Nether, End) and start the reset with confidence. No clutter, no confusion. - **Archive Explorer**: Browse, restore, or delete previous world snapshots. - **Detailed Tooltips**: Hover over any archive to see its creation date, total player playtime, and estimated file size. - **Smart Management**: Use "Prune Now" to clear old archives while keeping the most recent, or use "Delete ALL" to wipe them completely. - **Live Settings Editor**: An incredibly powerful panel to toggle features like **force-unload**, **preloading**, and **fresh-start**, and tweak numerical values on the fly. --- <details> <summary><strong>Click to view the full Command List & Configuration Details</strong></summary> ### 🕹️ Commands | Command | Description | Permission | | :---------------------------------- | :----------------------------------------------------- | :-------------------------- | | `/betterreset` | Opens the main control panel GUI. | `betterreset.gui` | | `/betterreset fullreset <world>` | The core CLI command to reset a world. | `betterreset.use` | | `/betterreset prune ` | Manually triggers an archive prune. | `betterreset.prune` | | `/betterreset deleteallbackups ` | Deletes all archives for a specific or all bases. | `betterreset.deleteallbackups`| | `/betterreset preload <on\|off>` | Toggles the world preloading feature. | `betterreset.preload` | | `/betterreset testreset <base>` | Runs a safe performance test of the reset process. | `betterreset.test` | ### ⚙️ Configuration While all settings are editable in the GUI, here are some key options in `config.yml`: ```yaml archive: enabled: true pruneNowKeepPerBase: 2 unload: force: true maxAttempts: 12 kickAtFinalAttempt: true players: freshStartOnReset: true freshStartAffectsAll: true preload: enabled: true autoDisableHighLag: true tpsThreshold: 18.0 ``` </details> --- ## 📥 Installation 1. Download the latest `betterreset-1.2.X.jar`. 2. Place the JAR file into your server’s `plugins/` folder. 3. Restart your server to generate files. 4. Type `/betterreset` and use the **Settings** GUI to configure everything instantly. **Requirements**: PaperMC or Spigot 1.21+ and Java 17+. --- <div align