Parameters and Tags

Parameters and Tags

Filter syntax for lookup, rollback, restore and purge.

Every parameter has a short and a long form. Both are identical.

Parameters

Short	Long	Meaning	Example
u:	user:	Users, comma separated, also #tnt and similar	u:Steve,Alex
t:	time:	Time span back from now	t:2d12h
r:	radius:	Radius in blocks or a world	r:20, r:#world_nether, r:#global
a:	action:	Action type, see Actions	a:+block
i:	include:	Only these blocks, items or entities	i:stone,dirt
e:	exclude:	Exclude these	e:grass_block
f:	filter:	Text prefix filter for chat, commands, signs	f:/home, f:-/msg
p:	page:	Page number	p:2

Time

Units: s seconds, m minutes, h hours, d days, w weeks. They can be combined: t:1w2d, t:3h30m. A number without unit counts as seconds.

Radius

Value	Meaning
20	20 blocks around you (not available in the console)
#world_nether	The whole world. Several worlds: #world,#world_nether
#global	Everywhere

Defaults: lookup uses #global, rollback and restore use 10 blocks, near uses 5.

Pages and lines

/up lookup 1:10        Page 1 with 10 lines
/up page 3             Jump to page 3
/up page 2:25          Page 2 with 25 lines

Text filter f:

Only for a:chat, a:command and a:sign. A prefix shows only matching texts, a leading - excludes them:

/up lookup a:command f:/home     Only commands starting with /home
/up lookup a:chat f:-hello       Chat without messages starting with "hello"

Tags

Tag	Works with	Meaning
#preview	rollback, restore	Show a preview instead of changing anything
#count	lookup	Only show the number of results
#summary	lookup	Summary by player and action
#verbose	lookup, rollback	More detailed output
#silent	lookup, rollback, purge	No output to the sender
#optimize	purge	Compact the database after deleting

More tags

Tag	Works with	Meaning
#command	rollback, restore, lookup	Only changes made by /fill, /setblock and /clone
#dry	compact	Simulate and report, change nothing
#<entity>	timeline	Only entries involving this entity, for example #enderman

#command and the radius

With #command, rollback and restore search the whole server (#global) unless you set r:. The user is optional: without u: the commands of all players are affected, with u:Steve only Steve's. See Rollback and Restore.

Other commands

• /up timeline <player|#entity> takes t: (default 24 hours), a: and p:.
• /up audit takes t: (default 7 days), u: (a staff member) and p:.
• /up investigate takes r: (default 15, at most 150) and t: (default 2 hours).
• /up compact needs t: of at least 7 days.

Fabric: World names are dimension IDs. Use #the_nether, #overworld and #the_end instead of #world_nether, #world and #world_the_end. See Platforms.

---

Related pages: Actions · Lookup Examples · Rollback and Restore