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

🖥️ Full GUI Control Manage every aspect of the plugin—resets, archives, and all configuration settings—from a sleek, intuitive in-game interface.	⚡ Instant-Feel Resets New worlds are pre-generated during the countdown, allowing for a near-instantaneous switch with zero post-reset lag.
🛡️ Force Unload Engine Aggressively unloads stubborn worlds by retrying, re-teleporting, and even kicking stuck players to guarantee the reset never fails.	🔄 Total Player Reset Provide a true "Fresh Start." All online players have their inventories, XP, health, and hunger wiped clean upon reset.
🗄️ Intelligent Archive System Old worlds are automatically archived with detailed tooltips showing total playtime and estimated storage size.	⚙️ Live Config Editor Tweak every plugin setting from the in-game Settings GUI. Changes are applied instantly without needing restarts or file edits.

---

🖥️ 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.

---

Click to view the full Command List & Configuration Details

🕹️ 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 [base]	Manually triggers an archive prune.	betterreset.prune
/betterreset deleteallbackups [base]	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:

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

---

📥 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+.

---