## **ResourceWorldResetter v4.0.0** ![https://files.catbox.moe/we4uve.png](https://files.catbox.moe/we4uve.png) **Admin GUI — `/rwr gui`** Click the icons in-game to change world, schedule, warnings, region settings, force resets, or reload config. ### **Automated Resource World Resets with Phase-Aware Status and Unified /rwr Commands** **ResourceWorldResetter v4** is the next generation of automatic resource world resets. It introduces an explicit **phase-based reset model**, a unified **/rwr command tree**, and improved **operator visibility** into reset progress and failures. **⚠️ BREAKING CHANGE:** v4 introduces a new unified `/rwr` command structure. Old commands (`/rwrgui`, `/resetworld`, `/rwrregion`, `/rwrresume`, etc.) no longer exist. Server owners must update scripts and permissions. Auto-migration is provided for configs. ### **What's New in v4** **✓ Explicit Reset Phases** - Reset progress is tracked using phases: IDLE → PRECHECK → TELEPORT → UNLOAD → DELETE → RECREATE → VERIFY → COMPLETE (or FAILED on error) - `/rwr status` reports the exact phase for in-progress or failed resets - Reset state metadata is persisted for better operational visibility **✓ Unified Command Structure** - All functionality is grouped under `/rwr` subcommands - Built-in help: `/rwr` or `/rwr help` - Legacy command aliases are intentionally removed in v4 Built-in help: `/rwr help` now shows a complete, command-by-command help page with usage examples and permission notes for every subcommand. **✓ Full Operator Visibility** - `/rwr status` — shows exact phase, next reset time, resume phase, and last failure reason - `/rwr next` — displays next reset timestamp, warning timestamp, and countdown in server timezone - No more guessing whether a reset is stuck, blocked, or progressing ### **Key Features** **Core Features:** - **Automatic Resource World Resets** — daily, weekly, monthly schedules - **Selective Region Resets** — reset specific areas without deleting the entire world - **GUI-Based Configuration** — no manual YAML editing needed - **Multiverse-Core Integration** — handles world deletion and recreation **Safety & Reliability:** - **State Machine Foundation** — explicit phases and persisted state tracking - **Failure Recovery Controls** — resume and cancel controls for incomplete reset handling - **Failure Visibility** — phase and failure details exposed in status output - **Safe Player Teleportation** — guarantees solid ground; automatic fallback if no safe spot exists - **Graceful Shutdown Handling** — incomplete reset state is detected and can be managed with `/rwr resume` **Operator Experience:** - **Phase-Level Status Reporting** — `/rwr status` shows exact phase, not just "IN_PROGRESS" - **Reset Scheduling Transparency** — `/rwr next` shows countdown to next reset - **Recovery Options** — `/rwr resume` and `/rwr resume cancel` for interrupted resets **Player Experience:** - **World Teleport GUI** — `/rwr tp` for easy world navigation; `/rwr back` to return - **Configurable Warnings** — countdown broadcasts before scheduled resets - **Region Throttling** — batch chunk unloading prevents lag spikes - **Custom Events** — plugin integration via PreResetEvent, PostResetEvent, RegionPreResetEvent, RegionPostResetEvent ### **v4.0.0 Breaking Changes** **Old commands no longer exist:** - `/rwrgui` → use `/rwr gui` - `/reloadrwr` → use `/rwr reload` - `/resetworld` → use `/rwr reset now` - `/rwrregion` → use `/rwr region ` - `/rwrresume` → use `/rwr resume [cancel]` **What is automatic:** - Config is auto-migrated from v3 schema to v4 on first startup - A backup is created as `config.v3.backup.yml` - Old reset-state format is archived **What admins must do:** 1. Update all scripts and automation to `/rwr` subcommands 2. Update permission nodes in your permission plugin 3. Run `/rwr status` to verify setup 4. Test with `/rwr reset now` during low activity See [MIGRATION.md](https://github.com/tamawish/resourceworldresetter/blob/master/migration.md) for the full upgrade guide. ### **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, and failure/resume details | resourceworldresetter.admin | | /rwr next | Show next reset timestamp, warning timestamp, and 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 | Manage region-based resets | resourceworldresetter.admin | | /rwr tp | Open world teleport menu | resourceworldresetter.admin | | /rwr back | Teleport back to previous location | resourceworldresetter.admin | ### **Permissions** The plugin exposes granular permission nodes for player-facing teleport commands so servers can allow them to non-admin players while keeping admin operations restricted. **Player-Facing Commands (available to all by default):** - `resourceworldresetter.tp` — Allows `/rwr tp` to open the world selection GUI. Default: `true` (all players). - `resourceworldresetter.back` — Allows `/rwr back` to teleport back to your last recorded location. Default: `true` (all players). **Admin-Only Commands:** - All other subcommands (`gui`, `reload`, `reset`, `resume`, `region`, `status`, `next`) are protected by `resourceworldresetter.admin` (default: `op` only). The root `/rwr` command has no permission gate; Spigot allows all users to execute it, and permission checks happen per subcommand. This enables non-admins to use player-facing commands while keeping administration features restricted. ### **Configuration (v4 Schema)** ```yaml # configVersion: 4 Schema version # worldName: "Resources" Target resource world schedule: # mode: "daily" daily, weekly, or monthly time: # hour: 3 24-hour format (0-23) # warningMinutes: 5 Minutes before reset for warnings # day: 1 For weekly: 1-7 (Mon-Sun); For monthly: 1-31 # preflight: Reserved for v4.1+ production hardening tps: # min: 15.0 Abort if TPS drops below this (0 = disabled) # onFail: "delay" delay, abort, or force players: # max: 0 Abort if more players online (0 = disabled) onFail: "delay" disk: # freeGB: 5.0 Abort if free disk falls below this (0 = disabled) onFail: "delay" regions: # enabled: false Enable selective region resets # populated via /rwr region add metrics: # enabled: false Optional anonymous telemetry ``` ### **Supported Versions** - **Minecraft:** 1.20.5+ (Spigot API 26.1+) - **Java:** 25 or newer - **Multiverse-Core:** 4.3.1+ (fully compatible with v5) - **Tested on:** Spigot 26.1, 26.1.1, 26.1.2 ### **Installation** 1. **Download** the latest v4 release from [GitHub Releases](https://github.com/tamawish/resourceworldresetter/releases) 2. **Back up** your plugin folder and worlds 3. Place **RWR-4.0.0.jar** into `plugins/` 4. Ensure **Multiverse-Core 4.3.1+** is installed 5. **Restart** your server (auto-migration will run if upgrading from v3) 6. Create your resource world (e.g., `/mv create Resources normal`) 7. Run `/rwr gui` and click **Change World** to select it 8. Configure schedule and preflight gates via GUI or `config.yml` ### **How It Works** 1. Admin configures target world and reset schedule via `/rwr gui` 2. On scheduled reset, plugin enters phase-based flow: PRECHECK → TELEPORT → UNLOAD → DELETE → RECREATE → VERIFY → COMPLETE 4. Players are safely teleported to a fallback world with visual warnings 5. World is deleted and regenerated by Multiverse-Core 6. Status is visible at any time via `/rwr status` (exact phase reported) 7. If reset fails, admins can inspect failure reason and control recovery with `/rwr resume` ### **Important Information** **Time Zone Awareness:** The plugin schedules resets based on the server's local system time. **Data Loss Warning:** Once a world is reset, **all data within it is permanently deleted**, including player structures and inventories. Back up your world files before configuring and using this plugin. **Preflight Gates:** v4.0.0 includes preflight configuration keys (TPS, players, disk) in the schema for forward compatibility. Full gate enforcement and policy controls are targeted for v4.1+. **Reset Phases:** Monitor `/rwr status` to see which phase the current or last reset reached. Phase information is essential for troubleshooting reset failures. ### **Support & Documentation** **Full Guides:** - **[README]([https://github.com/TamaWish/ResourceWorldResetter)**](https://github.com/TamaWish/ResourceWorldResetter)**) — overview, features, and configuration **Issues & Support:** - Report bugs: [GitHub Issues](https://github.com/tamawish/resourceworldresetter/issues) - Join Discord: [LozDev Mines](https://discord.gg/y3uug7xu9x) - Contributions welcome: Pull requests accepted ### **Author & License** **Author:** Lozaine **GitHub:** [TamaWish](https://github.com/tamawish) **Discord:** [LozDev Mines](https://discord.gg/y3uug7xu9x) **License:** [MIT License](https://github.com/tamawish/resourceworldresetter-v3.0.0/blob/master/license) ### **Download v4.0.0 Now — Breaking Change Release with Better Commands and Phase Visibility**

Lozaine

Lozaine's Plugins

ResourceWorldResetter by Lozaine

Lozaine's Organizations

Stars

Watching

ResourceWorldResetter by