🌍 ResourceWorldResetter v4.0.0

ResourceWorldResetter is a next-generation automated resource world reset plugin for Minecraft servers. It introduces an explicit phase-based reset model, a unified /rwr command tree, and improved operator visibility into reset progress and failures. Seamlessly integrates with Multiverse-Core to regenerate resource worlds with full control and transparency.

✨ Key Features

✔ Explicit Reset Phases – Track resets with 8 distinct phases: IDLE → PRECHECK → TELEPORT → UNLOAD → DELETE → RECREATE → VERIFY → COMPLETE
✔ Unified Command Structure – All functionality under /rwr subcommands with built-in help
✔ Full Operator Visibility – /rwr status shows exact phase, next reset time, and failure reasons
✔ Automatic Resource World Resets – Daily, Weekly, or Monthly schedules
✔ Selective Region Resets – Reset specific areas without deleting the entire world
✔ GUI-Based Configuration – /rwr gui for intuitive, no-YAML setup
✔ Safe Player Teleportation – Guarantees solid ground; automatic fallback if needed
✔ Failure Recovery Controls – Resume or cancel incomplete resets with /rwr resume
✔ Multiverse-Core Integration – Handles world deletion & recreation seamlessly
✔ Graceful Shutdown Handling – Persisted reset state for interrupted recovery
✔ Custom Events – PreResetEvent, PostResetEvent, RegionPreResetEvent, RegionPostResetEvent
✔ Supports Spigot & Paper (1.20.5+) with Java 21+

📌 What's New in v4

Admin GUI

🔄 Phase-Aware Status – /rwr status no longer shows "IN_PROGRESS"; instead, it reports the exact phase.
🎯 Unified /rwr Commands – One command tree for everything (no more /rwrgui, /resetworld, /rwrregion, etc.).
📊 Reset Scheduling Transparency – /rwr next shows countdown to next reset with timestamps.
🛡️ Recovery Options – Control incomplete resets with /rwr resume or /rwr resume cancel.
⚠️ Breaking Change – Old commands no longer exist. See MIGRATION.md for upgrade instructions.

🔧 Commands & Permissions

Command	Description	Permission
`/rwr help`	Show all supported `/rwr` subcommands	`resourceworldresetter.admin`
`/rwr gui`	Open the admin configuration GUI	`resourceworldresetter.admin`
`/rwr reload`	Reload config from file	`resourceworldresetter.admin`
`/rwr status`	Show current phase & next reset	`resourceworldresetter.admin`
`/rwr next`	Show next reset timestamp & countdown	`resourceworldresetter.admin`
`/rwr reset now`	Force an immediate reset	`resourceworldresetter.admin`
`/rwr resume [cancel]`	Resume or cancel incomplete reset recovery	`resourceworldresetter.admin`
`/rwr region <add/remove/list>`	Manage region-based resets	`resourceworldresetter.admin`
`/rwr tp`	Open world teleport menu	`resourceworldresetter.tp`
`/rwr back`	Teleport back to previous location	`resourceworldresetter.back`

Player-facing commands (tp, back) are available to all players by default.

📥 Installation & Setup

1️⃣ Download v4.0.0 from GitHub Releases
2️⃣ Back up your plugin folder and worlds
3️⃣ Place RWR-4.0.0.jar into the plugins/ folder
4️⃣ Ensure Multiverse-Core 4.3.1+ is installed
5️⃣ Restart your server (auto-migration from v3 will run if upgrading)
6️⃣ Create your resource world (e.g., /mv create Resources normal)
7️⃣ Run /rwr gui → Change World to select it
8️⃣ Configure schedule & preflight gates via GUI or config.yml

⚠️ Migration Notice

Upgrading from v3? Your config will be auto-migrated to v4 schema. A backup is saved as config.v3.backup.yml.

BREAKING CHANGES:

/rwrgui → /rwr gui
/reloadrwr → /rwr reload
/resetworld → /rwr reset now
/rwrregion → /rwr region
/rwrresume → /rwr resume

See MIGRATION.md for the full upgrade guide.

🌐 Supported Platforms

✅ Spigot (1.20.5+)
✅ Paper (1.20.5+)
✅ Java 21+ required
✅ Multiverse-Core 4.3.1+ required

🔗 Links & Support

📜 Documentation: README | MIGRATION.md
📥 Download & Updates: GitHub Releases
🐛 Report Issues: GitHub Issues
💬 Join Discord: LozDev Mines
💡 Contributions: Pull requests welcome!

📄 License: MIT
👤 Author: Lozaine