Purge

Purge

Delete old data safely.

Deletes old entries from the database. At least 24 hours of data always remain (t:1d or more).

Examples

/up purge t:30d                        Everything older than 30 days
/up purge t:30d r:50                   Only within a radius of 50
/up purge t:30d r:#world_nether        Only in this world
/up purge t:30d i:stone                Only entries involving stone
/up purge t:30d a:kill e:villager      Only villager kills
/up purge t:30d #optimize              Then compact the database
/up purge #optimize                    Only compact the database

Parameters

Parameter	Meaning
t:	Entries older than this are deleted (minimum 1d)
r:	Radius or world (r:#world_nether)
i:	Block or item type
a: and e:	For a:kill or a:spawn, e: names the entity type to delete
u:	Only entries of these users

Tags

Tag	Meaning
#optimize	Compacts the database after deleting. Can be used alone
#silent	No output

Automatic purge

Set auto-purge-days: 90 in config.yml. Entries older than 90 days are then deleted automatically, one run after startup and then every 24 hours.

Warning: A purge cannot be undone. Back up your database before large purges.

Compaction

Instead of deleting, /up compact summarises old block entries. Groups of at least 3 entries of the same player, action and block within one chunk and day are replaced by a single summary row (a:agg). The totals stay searchable, the single positions are lost, and summary rows cannot be rolled back. The last 7 days always stay in full detail.

/up compact t:30d #dry     Show what would be replaced
/up compact t:30d          Compact entries older than 30 days

Set retention.aggregate-after-days: 30 in Configuration to run it automatically after startup and then every 24 hours.

---

Related pages: Databases · Configuration