# **ResourceWorldResetter v4.0.0**<\/p>\n
<\/p>\n
<\/p>\n
Admin GUI \u2014 `\/rwr gui`<\/p>\n
Click the icons in-game to change world, schedule, warnings, region settings, force resets, or reload config.<\/p>\n
Automated Resource World Resets with Phase-Aware Status and Unified \/rwr Commands<\/p>\n
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.<\/p>\n
\u26a0\ufe0f 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.<\/p>\n
What’s New in v4<\/p>\n
\u2713 Explicit Reset Phases
\n– Reset progress is tracked using phases: IDLE \u2192 PRECHECK \u2192 TELEPORT \u2192 UNLOAD \u2192 DELETE \u2192 RECREATE \u2192 VERIFY \u2192 COMPLETE (or FAILED on error)
\n– `\/rwr status` reports the exact phase for in-progress or failed resets
\n– Reset state metadata is persisted for better operational visibility<\/p>\n
\u2713 Unified Command Structure
\n– All functionality is grouped under `\/rwr` subcommands
\n– Built-in help: `\/rwr` or `\/rwr help`
\n– Legacy command aliases are intentionally removed in v4<\/p>\n
Built-in help: `\/rwr help` now shows a complete, command-by-command help page with usage examples and permission notes for every subcommand.<\/p>\n
\u2713 Full Operator Visibility
\n– `\/rwr status` \u2014 shows exact phase, next reset time, resume phase, and last failure reason
\n– `\/rwr next` \u2014 displays next reset timestamp, warning timestamp, and countdown in server timezone
\n– No more guessing whether a reset is stuck, blocked, or progressing<\/p>\n
Key Features<\/p>\n
Core Features:
\n– Automatic Resource World Resets \u2014 daily, weekly, monthly schedules
\n– Selective Region Resets \u2014 reset specific areas without deleting the entire world
\n– GUI-Based Configuration \u2014 no manual YAML editing needed
\n– Multiverse-Core Integration \u2014 handles world deletion and recreation<\/p>\n
Safety & Reliability:
\n– State Machine Foundation \u2014 explicit phases and persisted state tracking
\n– Failure Recovery Controls \u2014 resume and cancel controls for incomplete reset handling
\n– Failure Visibility \u2014 phase and failure details exposed in status output
\n– Safe Player Teleportation \u2014 guarantees solid ground; automatic fallback if no safe spot exists
\n– Graceful Shutdown Handling \u2014 incomplete reset state is detected and can be managed with `\/rwr resume`<\/p>\n
Operator Experience:
\n– Phase-Level Status Reporting \u2014 `\/rwr status` shows exact phase, not just “IN_PROGRESS”
\n– Reset Scheduling Transparency \u2014 `\/rwr next` shows countdown to next reset
\n– Recovery Options \u2014 `\/rwr resume` and `\/rwr resume cancel` for interrupted resets<\/p>\n
Player Experience:
\n– World Teleport GUI \u2014 `\/rwr tp` for easy world navigation; `\/rwr back` to return
\n– Configurable Warnings \u2014 countdown broadcasts before scheduled resets
\n– Region Throttling \u2014 batch chunk unloading prevents lag spikes
\n– Custom Events \u2014 plugin integration via PreResetEvent, PostResetEvent, RegionPreResetEvent, RegionPostResetEvent<\/p>\n
v4.0.0 Breaking Changes<\/p>\n
Old commands no longer exist: What is automatic: What admins must do: See **MIGRATION.md** for the full upgrade guide.<\/p>\n Commands & Permissions<\/p>\n | Command | Description | Permission | ## Permissions<\/p>\n 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.<\/p>\n **Player-Facing Commands (available to all by default):** **Admin-Only Commands:** 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.<\/p>\n Supported Versions Installation How It Works Important Information<\/p>\n Time Zone Awareness: The plugin schedules resets based on the server’s local system time.<\/p>\n 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.<\/p>\n 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+.<\/p>\n Reset Phases: Monitor `\/rwr status` to see which phase the current or last reset reached. Phase information is essential for troubleshooting reset failures.<\/p>\n Issues & Support: Author & License Download v4.0.0 Now \u2014 Breaking Change Release with Better Commands and Phase Visibility<\/p>\n","protected":false},"excerpt":{"rendered":" ResourceWorldResetter is a Minecraft plugin designed to automate the resetting of a resource world at scheduled intervals.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"resourceworldresetter","_minecraft_project_id":"PjsJlPJ9","_minecraft_author":"Lozaine","_minecraft_license":"MIT","_minecraft_downloads":406,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"resourceworldresetter.zip","_minecraft_size_bytes":259617,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T10:57:01.115053Z","_minecraft_date_created":"2025-03-27T22:12:48.006503Z","_minecraft_date_modified":"2026-05-06T11:45:27.076883Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/resourceworldresetter","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T19:44:04+00:00","_minecraft_import_hash":"74afb334d60df0c30ef32fa5265cbb44","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129,92,159],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-132601","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-worldgen","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– `\/rwrgui` \u2192 use `\/rwr gui`
\n– `\/reloadrwr` \u2192 use `\/rwr reload`
\n– `\/resetworld` \u2192 use `\/rwr reset now`
\n– `\/rwrregion` \u2192 use `\/rwr region
\n– `\/rwrresume` \u2192 use `\/rwr resume [cancel]`<\/p>\n
\n– Config is auto-migrated from v3 schema to v4 on first startup
\n– A backup is created as `config.v3.backup.yml`
\n– Old reset-state format is archived<\/p>\n
\n1. Update all scripts and automation to `\/rwr` subcommands
\n2. Update permission nodes in your permission plugin
\n3. Run `\/rwr status` to verify setup
\n4. Test with `\/rwr reset now` during low activity<\/p>\n
\n|—|—|—|
\n| \/rwr help | Show all supported `\/rwr` subcommands | resourceworldresetter.admin |
\n| \/rwr gui | Open the admin configuration GUI | resourceworldresetter.admin |
\n| \/rwr reload | Reload config from file | resourceworldresetter.admin |
\n| \/rwr status | Show current phase, next reset, and failure\/resume details | resourceworldresetter.admin |
\n| \/rwr next | Show next reset timestamp, warning timestamp, and countdown | resourceworldresetter.admin |
\n| \/rwr reset now | Force an immediate reset | resourceworldresetter.admin |
\n| \/rwr resume [cancel] | Resume or cancel incomplete reset recovery | resourceworldresetter.admin |
\n| \/rwr region
\n| \/rwr tp | Open world teleport menu | resourceworldresetter.admin |
\n| \/rwr back | Teleport back to previous location | resourceworldresetter.admin |<\/p>\n
\n– `resourceworldresetter.tp` \u2014 Allows `\/rwr tp` to open the world selection GUI. Default: `true` (all players).
\n– `resourceworldresetter.back` \u2014 Allows `\/rwr back` to teleport back to your last recorded location. Default: `true` (all players).<\/p>\n
\n– All other subcommands (`gui`, `reload`, `reset`, `resume`, `region`, `status`, `next`) are protected by `resourceworldresetter.admin` (default: `op` only).<\/p>\n
\n– Minecraft: 1.20.5+ (Spigot API 26.1+)
\n– Java: 25 or newer
\n– Multiverse-Core: 4.3.1+ (fully compatible with v5)
\n– Tested on: Spigot 26.1, 26.1.1, 26.1.2<\/p>\n
\n1. Download the latest v4 release from GitHub Releases
\n2. Back up your plugin folder and worlds
\n3. Place ResourceWorldResetter.jar into `plugins\/`
\n4. Ensure Multiverse-Core 4.3.1+ is installed
\n5. Restart your server (auto-migration will run if upgrading from v3)
\n6. Create your resource world (e.g., `\/mv create Resources normal`)
\n7. Run `\/rwr gui` and click Change World to select it
\n8. Configure schedule and preflight gates via GUI or `config.yml`<\/p>\n
\n1. Admin configures target world and reset schedule via `\/rwr gui`
\n2. On scheduled reset, plugin enters phase-based flow: PRECHECK \u2192 TELEPORT \u2192 UNLOAD \u2192 DELETE \u2192 RECREATE \u2192 VERIFY \u2192 COMPLETE
\n4. Players are safely teleported to a fallback world with visual warnings
\n5. World is deleted and regenerated by Multiverse-Core
\n6. Status is visible at any time via `\/rwr status` (exact phase reported)
\n7. If reset fails, admins can inspect failure reason and control recovery with `\/rwr resume`<\/p>\n
\n– Report bugs: Issues
\n– Contributions welcome: Pull requests accepted<\/p>\n
\nAuthor: TamaWish
\nLicense: MIT License<\/p>\n