Skip to content

Commands

Every command is /xrewind <subcommand>, or /xr for short. Each has its own permission, all given to operators by default, so you can hand staff only the ones they need.

Command What it does Permission
/xr inspect (i) Turns the inspector on or off. Left-click a block to see its history, or place a block to see what was at that spot. Nothing is broken or placed while it’s on. xrewind.inspect
/xr lookup <params> (l) Searches the history, newest first, 7 to a page. xrewind.lookup
/xr page <number> Another page of your last lookup. xrewind.lookup
/xr near What changed within 5 blocks in the last 3 days. xrewind.lookup
/xr rollback <params> (rb) Undoes matching changes. Needs t:. Add #preview to see it first. xrewind.rollback
/xr restore <params> (rs) Puts back what a rollback undid. xrewind.restore
/xr apply, /xr cancel Apply or drop your preview. xrewind.rollback
/xr undo Reverts your last rollback or restore. xrewind.rollback
/xr lookup a:chat, a:command Chat and commands, where they’re logged. xrewind.lookup.chat
/xr purge t:<time> Deletes history older than the time, at least a day. xrewind.purge
/xr import coreprotect Imports CoreProtect’s history: see Switching from CoreProtect. xrewind.admin
/xr status Where the history is kept, how much has been saved and is waiting, and any problem. xrewind.status
/xr reload, /xr info Reload the config, or show the version and settings. xrewind.admin

The same as CoreProtect’s, so what you know already works. Combine as many as you like: /xr l u:Steve t:2h r:20 a:-block.

Parameter Means Examples
u: Who: players, or sources like #tnt and #creeper. Several with commas. u:Steve, u:Steve,Alex, u:#tnt
t: How far back, in w d h m s. t:30m, t:2w3d
r: How far from you, in blocks; or #world for the whole world, #global for every world. Without it, your whole world. r:20, r:#global
a: What kind of change. Without it: blocks, containers and kills. a:block, a:+block (placed), a:-block (broken), a:container, a:+container (put in), a:-container (taken), a:kill, a:click, a:sign, a:chat, a:command, a:session
i: Only these blocks (what was broken, or what was placed) or items. i:diamond_ore,chest
e: Leave out these blocks or players. e:dirt,stone, e:Steve
w: Another world than yours. w:world_nether
#count Only how many changes match.
#preview Rollback and restore: show the result to you only, then /xr apply or /xr cancel.
#silent Rollback and restore: no progress or summary.

From the console there’s no “you” to measure from, so add w:<world> or r:#global.

/xr rollback u:Griefer t:2h r:30
  • A time is required, so a rollback never reaches further back than you meant.
  • Without r:, it covers 10 blocks around you (rollback.default-radius). Anything past 100 blocks (rollback.max-radius), r:#world and r:#global need xrewind.rollback.global.
  • What a broken block held comes back with it: a chest’s items, a sign’s text. Items taken out of containers are put back, and items put in are taken out (a:container alone does just that).
  • Each block is set once. A block changed 200 times goes straight back to how it was before the first matching change, and blocks are set without physics, so nothing falls or flows on the way.
  • It doesn’t freeze the server. Chunks are loaded in the background and blocks are set 10 milliseconds per tick (rollback.ms-per-tick), or region by region on Folia. Your action bar shows the progress.
  • Preview it with #preview: only you see the result, until /xr apply or /xr cancel.
  • Changed your mind? /xr undo puts every block back as it was before your last rollback or restore. /xr restore with the same parameters re-applies what a rollback undid.
  • Rolled-back changes stay in the history, struck through in lookups.
  • One rollback runs at a time, so two can’t fight over the same blocks.