RoodyDonations v1.0.0 is outSee what’s new →
RoodyRestore
v1.0.0 Paper 1.20.4+ Free
Guides · 3 / 16

Backups

Each kind of backup is a category, with its own line in config.yml:

Category When Default
death The player dies on, 50, 60 days
combat-log Killed for leaving in combat (RoodyPvP) on, 20, 30 days
join · quit Joining and leaving on, 10, 7 days
world-change · gamemode-change Changing world or gamemode on, 10, 7 days
ender-chest Closing the ender chest on, 10, 7 days
container-close Closing a chest, barrel, shulker box, hopper... off, 20, 3 days
automatic Every automatic-minutes on, 24, 3 days
command Before the commands of backups.commands (/clear...), and the player named in them on, 10, 14 days
server-stop When the server stops on, 5, 7 days
manual /rr save or the menu on, no limit, forever
pre-restore Right before each restore: restoring one of these is the undo on, 20, 30 days
edited Copies changed in the edit menu on, no limit, forever
categories:
  death: {enabled: true, limit: 50, keep-days: 60}

limit is how many to keep per player (-1 = no limit) and keep-days when to delete them (0 = never). Plugins using the API can add their own categories: add them here to change their limits.

A backup holds the inventory, armour, off hand, ender chest, experience, health, hunger, potion effects, location and gamemode, and for deaths the cause, the killer and the death message.

In backups:

Option What it does
total-limit The most backups per player adding every category (-1 = no limit).
ender-chest Save the ender chest in every backup.
skip-empty Do not save empty backups (manual ones always are).
skip-unchanged These categories are skipped when nothing changed since the player's last backup.
excluded-worlds No backups in these worlds.
automatic-minutes How often the automatic backup runs (spread out so it does not hit one tick).
container-cooldown-seconds At most one container-close or ender-chest backup per player in this time.
commands The commands that make a command backup.

Pinned backups (the pin button) and imported ones are never cleaned up. Backups waiting for a request or a restore are kept too.

Exempt players: roodyrestore.exempt (no backups at all) or roodyrestore.exempt.<category> (only that kind), given on purpose: being OP is not enough.