Перейти к содержимому
Mineforgian

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

Minecraft API Java Version Status

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


🙌 Support The Creator

This plugin is developed with passion and maintained for the community. If you find it useful, consider supporting its future development!

Donate

Developed by muj3b

Ченджлог

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_end so portals behave correctly even without Multiverse-NetherPortals.
  • Added graceful Multiverse-NetherPortals integration: when Multiverse-NetherPortals is present, BetterReset defers portal behavior to it by default.
  • Clarified default-world limitation: documented that the server’s default level-name world cannot be fully unloaded and reset live; for example, use level-name=lobby and reset sandbox instead of making sandbox the main world.
  • Fixed misleading warnings for fresh worlds that legitimately have no playerdata folder after regeneration.
    • Tested with Multiverse-Core 5.6.2 using level-name=lobby and a resettable sandbox world, confirming seed and spawn persistence and clean logs (no ERROR/SEVERE/compat warnings).
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_sandbox during 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_* or betterreset_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.enabled
  • chunkReset.backupBeforeTrim
  • chunkReset.inactive.enabled
  • chunkReset.inactive.days
  • chunkReset.endDistance.enabled
  • chunkReset.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,0 in 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

Комментарии

Загружаем…