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 |
Lookup parameters
Section titled “Lookup parameters”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.
Rolling back
Section titled “Rolling back”/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:#worldandr:#globalneedxrewind.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:containeralone 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 applyor/xr cancel. - Changed your mind?
/xr undoputs every block back as it was before your last rollback or restore./xr restorewith 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.