
BetterReset
Minecraft plugin that lets you safely reset a world’s Overworld, Nether, and End while the server is running, with player protection, async deletion, and full regeneration in one command or GUI.
- Загрузки
- 936
- Подписчики
- 4
- Обновлён
- 14 мая 2026 г.
- Лицензия
- MIT
Опубликован 14 сентября 2025 г.
🚀 BetterReset 🚀
The Definitive Live World Reset Tool
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 ControlManage every aspect of the plugin—resets, archives, and all configuration settings—from a sleek, intuitive in-game interface. |
⚡ Instant-Feel ResetsNew worlds are pre-generated during the countdown, allowing for a near-instantaneous switch with zero post-reset lag. |
🛡️ Force Unload EngineAggressively unloads stubborn worlds by retrying, re-teleporting, and even kicking stuck players to guarantee the reset never fails. |
🔄 Total Player ResetProvide a true "Fresh Start." All online players have their inventories, XP, health, and hunger wiped clean upon reset. |
🗄️ Intelligent Archive SystemOld worlds are automatically archived with detailed tooltips showing total playtime and estimated storage size. |
⚙️ Live Config EditorTweak 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
- Download the latest
betterreset-1.2.X.jar. - Place the JAR file into your server’s
plugins/folder. - Restart your server to generate files.
- Type
/betterresetand use the Settings GUI to configure everything instantly.
Requirements: PaperMC or Spigot 1.21+ and Java 17+.
Ченджлог
1.2.9Релиз1.21.9, 1.21.10, 1.21.11 · 14 мая 2026 г.
BetterReset 1.2.9 Changelog
- Fixed world spawns sometimes being placed underground or inside caves after a reset.
- Added shared safe surface spawn detection using Bukkit heightmaps.
- Full resets now prefer the seed’s natural spawn area, then search nearby for a playable surface.
- Spawn checks now verify safe ground plus clear feet/head space before saving the spawn.
- Respawn protection now uses the same safe surface logic.
- Player return-to-spawn after reset/restore now uses the same safe surface logic.
- End portal return handling now uses the same safe surface logic.
- Added configurable spawn search settings:
- spawn.searchRadius: 512
- spawn.searchStep: 8
Verification:
- Tested on Paper 1.21.11.
- Tested with Multiverse-Core 5.6.2.
1.2.8Релиз1.21.9, 1.21.10, 1.21.11 · 12 мая 2026 г.
BetterReset 1.2.8
- Added full Multiverse-Core 5.x support using the current
getApi().getWorldManager()API, while keeping legacy reflection-based support for older Multiverse installs. - Improved spawn handling after overworld regeneration: BetterReset now finds a safe fresh spawn near
0,0, sets the Bukkit world spawn, and synchronizes that spawn with Multiverse to avoid stale spawn locations. - Implemented standalone portal routing for
<world>,<world>_nether, and<world>_the_endso portals behave correctly even without Multiverse-NetherPortals. - Added graceful Multiverse-NetherPortals integration: when
Multiverse-NetherPortalsis present, BetterReset defers portal behavior to it by default. - Clarified default-world limitation: documented that the server’s default
level-nameworld cannot be fully unloaded and reset live; for example, uselevel-name=lobbyand resetsandboxinstead of makingsandboxthe main world. - Fixed misleading warnings for fresh worlds that legitimately have no
playerdatafolder after regeneration.- Tested with Multiverse-Core 5.6.2 using
level-name=lobbyand a resettablesandboxworld, confirming seed and spawn persistence and clean logs (noERROR/SEVERE/compat warnings).
- Tested with Multiverse-Core 5.6.2 using
1.2.7Релиз1.21.9, 1.21.10, 1.21.11 · 12 мая 2026 г.
BetterReset v1.2.7 Changelog
Fixed
- Fixed an issue where BetterReset could teleport players into a preloaded world like
brprep_sandboxduring a reset. - Fixed reset failures caused by trying to unload or move a preloaded world while players were inside it.
- Fixed unsafe behavior when Paper refuses to unload the server’s main/default world.
- Fixed an offline-player reset issue caused by the background worker not being ready early enough.
- Fixed thread-safety issues with chat-based GUI/config editing.
Changed
- BetterReset now refuses to use temporary worlds like
brprep_*orbetterreset_safe_*as fallback worlds. - If a world cannot be unloaded safely, the reset now aborts cleanly instead of deleting live world files.
- Temporary fallback worlds are now cleaned up after safe aborts.
- Preload state is now cleared after swaps so future resets can preload cleanly.
Safety
- BetterReset no longer deletes
region,playerdata,level.dat, or other world files while the world is still loaded. - Main/default worlds that Paper refuses to unload are now protected from unsafe reset attempts.
Notes
- If your target world is the server’s main/default world, Paper may still refuse to unload it live. In that case BetterReset will safely abort instead of risking world damage.
- For best results, use a separate fallback/lobby world or teleport mode when resetting the main/default world.
1.2.6Релиз1.21.9, 1.21.10, 1.21.11 · 15 февраля 2026 г.
BetterReset 1.2.6
Added
New Chunk Trim system for partial world cleanup without full resets.
New command
/betterreset trimchunks <base> [--overworld] [--nether] [--end] [--all]
Use this to trim chunks in specific dimensions or all at once.
New config section: chunkReset
chunkReset.enabledchunkReset.backupBeforeTrimchunkReset.inactive.enabledchunkReset.inactive.dayschunkReset.endDistance.enabledchunkReset.endDistance.minDistanceBlocks
GUI support for chunk trimming
- "Trim Chunks Now" action in the reset menu
- Dedicated confirmation GUI before the trim executes
- New settings toggles/cycles for chunk trim rules
Chunk Trim Behavior
Can delete region files based on:
- Inactive age – regions older than the configured number of days
- End distance – regions beyond the configured radius from
0,0in End worlds
Additional behavior:
- Protects currently loaded regions from deletion
- Supports optional backup snapshot before trim
- Reports per-world trim summary (scanned / deleted / skipped) to the command sender
1.2.5Релиз1.21.9, 1.21.10, 1.21.11 · 17 декабря 2025 г.
- Fixed World unloading bug and the nether not working.
1.2.4Релиз1.21.9, 1.21.10, 1.21.11 · 15 декабря 2025 г.
What Was Wrong:
- After the plugin reset the world, it saved some info in memory.
- When the server restarted, that info was GONE.
- So, when you joined, the plugin didn't know the world was just reset.
- You spawned at your old location, but that location was now inside blocks → you died 💀.
What I Fixed:
- The plugin now saves this info to a file.
- Even after a server restart, it remembers "hey this world was just reset".
- Now it will teleport you to a safe spawn instead of your old spot
1.2.3Релиз1.21.9, 1.21.10, 1.21.11 · 14 декабря 2025 г.
Fixed the API breaking change in Minecraft 1.21.11 when Attribute.GENERIC_MAX_HEALTH was renamed. Making it work on this version now.
1.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 13 декабря 2025 г.
- New feature allowing the plugin too reset players who are offline aswell, this is set to true by default and can be changed in the config and GUI.
Some other changes:
Better thread safety (avoiding Bukkit API calls off main thread) Better code organization (smaller focused methods) Fixed GUI layout conflicts
Комментарии
Загружаем…