Moderator Tutorial to Ledger

Ledger is a powerful moderating tool that is used to rollback griefs and inspect who placed or broke a block. It serves an identical purpose to the well known plugin CoreProtect.

Ledger has an alias command, /lg.

All commands below work with /lg instead of /ledger.

Inspecting

Command:
/ledger inspect or /ledger i

How to use it:

Run the command to toggle it on and off
Left-clicking on a placed block will show who placed it and the time they placed it
Placing a block where one was broken will show who removed it and the time they removed it

Notes:

The results are ordered chronologically; they appear from newest at the top to oldest at the bottom.
Click the two little double arrows (<< or >>) surrounding the [Page x of x] to go back or forward a page.
If a result is shown as crossed out, it has been rolled back already.
Make sure to toggle it off after finishing, as you will not be able to break or place blocks.
When placing a block, it will not consume it from your inventory, and if it does show it as being used, open your inventory and click the stack to get it back.

Rolling back

Do NOT rollback a grief without inspecting it first.

Take extreme care when typing the command and double check before running it, as a single typo can do a lot of damage. Alternatively, preview it before running to see what it would do.

Never use creative to rollback, unless it is to return items.

Command:
/ledger rollback or /ledger rb

Example:
/ledger rollback source:Player123 after:12h range:40 will rollback everything Player123 did in the last 12 hours within 40 blocks of you.

I would suggest using 20 as a default range, and increase it if needed. If it's just a couple blocks near you, decrease it.

Searching

Use this if you aren't sure what specific block position the player griefed (e.g. a fire).

Command:
/ledger search or /ledger s

Example:
/ledger search after:12h range:50 object:minecraft:flint_and_steel will search for everything in the last 12 hours within 50 blocks of you that involved a flint and steel.

Restoring

Command:
Run the rollback command, but replace rollback/rb with restore

Example:
/ledger restore source:Player123 after:12h range:40 will return what was rolled back.

Previewing

Previewing will send you a "fake world" of what it would look like if you were to run the command, but doesn't actually run it.

Commands:
Run your rollback or restore command, but insert a preview/pv before the rollback/rb/restore

Example:
/ledger preview rollback source:Player123 after:12h range:40 will show you what would happen if you were to run /ledger rollback source:Player123 after:12h range:40

Arguments

Argument order does not matter.

You can put the same argument type multiple times to specify your rollback/search:
/ledger rollback source:Player123 source:Player456 range:20 after:12h will rollback everything Player123 and Player456 did in the past 12 hours within 20 blocks of you.

You can insert a ! after the colon to remove it from your rollback/searching. Example:
/ledger rollback source:Player123 range:20 after:12h action:!item-drop will rollback everything Player123 did in the past 12 hours within 20 blocks that ISN'T dropping an item.

source

The source of the event that you are rolling back or searching for.

after

How far back to search. In format [number][h/d/w]. Examples:

3h = Three hours
8d = Eight days
2w = Two weeks

range

The radius in blocks that you are rolling back or searching for.

object

What items/block you are rolling back or searching for.

action

The type of action you are rolling back or searching for. List of actions:

block-break - Breaking a block
block-place - Placing a block
block-change - Changing a block (e.g. opening/closing a door)
entity-change - Changing an entity, not sure what this is
entity-kill - Killing an entity
entity-mount - Mounting an entity
entity-dismount - Dismounting an entity
item-insert - Inserting an item into a chest/shulker box
item-remove - Removing an item from a chest/shulker box
item-drop - Dropping an item
item-pickup - Picking an item up

Specific Uses

"..." should be replaced with your typical arguments e.g. after, range. Don't set an argument already defined below (for example for finding the source of the fire, method 2, don't do /ledger search source:@fire source:PotentialGriefer after:12h range:20)

Fire

--- Finding the source of the fire ---

Method 1:
/ledger search object:fire_charge ...
/ledger search object:flint_and_steel ...
/ledger search object:lava ...
If nothing shows up, move on to Method 2.

Method 2:
/ledger search source:@fire ...
/ledger page {last page}

--- Rolling back the fire ---

/ledger rollback source:@fire object:!fire ...