ResourceWorldResetter
 Download v4.0.1
v4.0.1 — Now Available

Automate Your
Resource World
Resets

A Spigot/Paper plugin that handles scheduled world resets with phase-aware state tracking, an admin GUI, and zero server restarts required.

Download JAR View on GitHub Quick Start →
4.0.1
Latest Version
1.21+
Spigot / Paper
8
Reset Phases
MIT
License
What's Inside

Everything you need for
reliable world resets

No more manual restarts, broken worlds, or confused players. ResourceWorldResetter handles it all automatically.

🔄
Automated Schedules
Set daily, weekly, or monthly reset schedules. The plugin handles everything — countdown warnings, player teleportation, and world recreation — without a server restart.
📊
Phase-Aware State Machine
Resets progress through 8 explicit phases: IDLE → PRECHECK → TELEPORT → UNLOAD → DELETE → RECREATE → VERIFY → COMPLETE. Know exactly where things stand at all times.
🛡️
Preflight Safety Gates
Automatically block resets when TPS drops below threshold, too many players are online, or free disk space is low. Configure each gate to delay, abort, or force.
🖥️
Admin GUI
Full in-game GUI via /rwr gui to change worlds, set schedules, manage regions, and force resets — no manual YAML editing required.
🗺️
Selective Region Resets
Reset specific in-world regions without wiping the entire world. Add regions with /rwr region addhere and manage them from the GUI or command line.
🚀
Safe Player Teleport
Players in the resource world are safely teleported before reset begins. Guarantees solid ground landing with automatic fallback. Use /rwr back to return after.
💾
Reset State Persistence
If the server restarts mid-reset, the plugin resumes from the last safe phase boundary. No guessing, no duplicate resets — deterministic recovery every time.
🔌
Custom Events API
Integrate with other plugins using PreResetEvent, PostResetEvent, RegionPreResetEvent, and RegionPostResetEvent for full lifecycle hooks.
⚡
Async Operations
World deletion and recreation run asynchronously to keep your server's main thread responsive. Region resets use batch chunk unloading (16/tick) to avoid lag spikes.
Reset Pipeline
Phase-aware state machine
v4 Enhancement
IDLE→
PRECHECK→
TELEPORT→
UNLOAD→
DELETE→
RECREATE→
VERIFY→
COMPLETE

If a reset fails, the exact phase and reason are logged. Use /rwr resume to recover or /rwr resume cancel to clear.

Commands & Permissions

One unified command tree

All commands are under /rwr. No more scattered aliases — just one place to learn.

Command Description Permission
/rwr gui Open the admin configuration GUI admin
/rwr reload Reload config from file admin
/rwr reset now Force an immediate reset admin
/rwr resume [cancel] Resume or cancel incomplete reset recovery admin
/rwr status Show current phase, next reset, and failure details admin
/rwr next Show next reset timestamp and countdown admin
/rwr region <sub> Manage region-based resets (enable, disable, list, add, remove, addhere) admin
/rwr tp Open world teleport menu for players .tp (all)
/rwr back Teleport back to previous location .back (all)
/rwr help Show complete in-game help with usage examples all
Getting Started

Up and running
in minutes

Drop the JAR in your plugins folder, restart, and configure through the in-game GUI — no YAML required.

01

Prerequisites

Ensure you have Multiverse-Core 4.3.1+ installed and Java 21+ running on your server. Supports Spigot/Paper 1.21.1+.

02

Download & Deploy

Grab the latest RWR-4.0.1.jar from GitHub Releases. Place it in your server's plugins/ directory.

03

Restart Server

A fresh config.yml is generated automatically. If upgrading from v3, your old config is auto-migrated with a backup created at config.v3.backup.yml.

04

Configure via GUI

Run /rwr gui in-game to select your world, set a schedule, and configure preflight gates. Then verify with /rwr status.

config.yml
configVersion: 4
worldName: "Resources"

schedule:
  mode: "daily" # daily | weekly | monthly
  time:
    hour: 3 # 24-hour (0–23)
  warningMinutes: 5

preflight:
  tps:
    min: 15.0
    onFail: "delay"
  disk:
    freeGB: 5.0
    onFail: "delay"

regions:
  enabled: false

metrics:
  enabled: false
Auto-migrates from v3 Multiverse-Core required Java 21+ Spigot / Paper 1.21+

Ready to automate your
resource world?

Download the latest release and have your first reset scheduled in under 5 minutes.

Download v4.0.1 View on Hangar