Config server wipe.yml - BeestoXd/UltimateDonutSMP-V2 GitHub Wiki
Configuration for a full season reset. /serverwipe deletes and regenerates the worlds
listed in RESET-WORLDS and clears plugin data, which is exactly as final as it sounds.
The safety mechanisms are the part to understand before enabling this. PROTECTED-WORLDS
can never be wiped regardless of the rest of the file, and TOKEN-TTL-SECONDS bounds the
confirmation token the command issues, so a wipe cannot be triggered by a stray command
days later. A wipe also suppresses the normal shutdown save so that in-memory data is not
written back over the fresh state, and progress is tracked in server-wipe-pending.yml so
an interrupted wipe resumes on the next boot.
Comment at the top of the shipped file:
UltimateDonutSMP V2 - Server Wipe (Season Reset) Configuration
| On disk | plugins/UltimateDonutSmp2/server-wipe.yml |
| Commands | /serverwipe |
| Player-facing text | Edit CONFIG.SERVER_WIPE in languages/<locale>.yml — not this file |
| Reload | /ultimatedonutsmp2 reload |
| Section | Type | Contents |
|---|---|---|
ENABLED |
boolean | true |
RESET-WORLDS |
list | 0 entries |
PROTECTED-WORLDS |
list | 0 entries |
TOKEN-TTL-SECONDS |
integer | 300 |
BACKUP-DIRECTORY |
string | server-wipe-backups |
MESSAGES |
section | 2 keys |
Enable or disable the season reset / server wipe feature (true / false)
| Option path | Type | Accepted values | Default | What it does |
|---|---|---|---|---|
ENABLED |
boolean |
true, false
|
true |
Enable or disable the season reset / server wipe feature (true / false) |
Default ENABLED block as shipped
# Enable or disable the season reset / server wipe feature (true / false)
ENABLED: trueList of world names to be reset during a server wipe (e.g., ["world", "world_nether", "world_the_end"])
A list of 0 values:
RESET-WORLDS:Default RESET-WORLDS block as shipped
# List of world names to be reset during a server wipe (e.g., ["world", "world_nether", "world_the_end"])
RESET-WORLDS: []List of world names protected from being reset during a server wipe (e.g., ["spawn", "lobby"])
A list of 0 values:
PROTECTED-WORLDS:Default PROTECTED-WORLDS block as shipped
# List of world names protected from being reset during a server wipe (e.g., ["spawn", "lobby"])
PROTECTED-WORLDS: []Time-to-live duration in seconds for admin confirmation tokens before expiration
| Option path | Type | Accepted values | Default | What it does |
|---|---|---|---|---|
TOKEN-TTL-SECONDS |
integer |
Any integer | 300 |
Time-to-live duration in seconds for admin confirmation tokens before expiration |
Default TOKEN-TTL-SECONDS block as shipped
# Time-to-live duration in seconds for admin confirmation tokens before expiration
TOKEN-TTL-SECONDS: 300Subfolder path where world backups are saved before wiping
| Option path | Type | Accepted values | Default | What it does |
|---|---|---|---|---|
BACKUP-DIRECTORY |
string |
Any text | server-wipe-backups |
Subfolder path where world backups are saved before wiping |
Default BACKUP-DIRECTORY block as shipped
# Subfolder path where world backups are saved before wiping
BACKUP-DIRECTORY: server-wipe-backupsNotification messages broadcast during server reset maintenance
| Option path | Type | Accepted values | Default | What it does |
|---|---|---|---|---|
MESSAGES.MAINTENANCE |
string |
Any text | &cthe server is preparing a season reset. try again after… |
Maintenance message shown when players attempt to log in during a wipe |
MESSAGES.KICK |
string |
Any text | &ca season reset is starting. the server will restart sho… |
Kick message shown to all online players when a wipe sequence begins |
Default MESSAGES block as shipped
# Notification messages broadcast during server reset maintenance
MESSAGES:
# Maintenance message shown when players attempt to log in during a wipe
MAINTENANCE: '&cthe server is preparing a season reset. try again after the restart.'
# Kick message shown to all online players when a wipe sequence begins
KICK: '&ca season reset is starting. the server will restart shortly.'Defaults above match the file shipped in the jar.