CoreProtect¶

CoreProtect (v23.1) is a block logging and rollback plugin. It records nearly every interaction on the server — block placement, block breaking, container transactions, chat, commands, entity kills, and more — and allows admins to inspect, look up, roll back, and restore changes.

Inspector Mode¶

Toggle inspector mode to click any block and see its history:

/co inspect

or /co i

Click a block to see who placed/broke it and when.

Looking Up Changes¶

/co lookup u:<user> t:<time> r:<radius> a:<action> i:<block> e:<exclude>

Parameters¶

Parameter	Description	Example
`u:<user>`	Filter by player(s)	`u:Notch` or `u:Notch,Steve`
`t:<time>`	Time range (w/d/h/m/s)	`t:5d2h`, `t:1h-2h`
`r:<radius>`	Area radius	`r:10`, `r:#world`, `r:#global`
`a:<action>`	Action type	`a:block`, `a:+block`, `a:-block`
`i:<block>`	Include specific blocks/items	`i:diamond_ore`
`e:<block>`	Exclude specific blocks/items	`e:stone`

Action Types¶

Action	Description
`block`	Block place/break
`+block`	Block placement only
`-block`	Block break only
`chat`	Player chat messages
`click`	Player interactions
`command`	Player commands
`container`	Container transactions
`inventory`	Inventory changes
`item`	Item pickups/drops
`kill`	Entity kills
`session`	Player join/leave
`sign`	Sign text changes
`username`	Username changes

Modifiers¶

Add these to the end of any lookup/rollback:

Modifier	Description
`#preview`	Preview only (no actual changes)
`#count`	Show quantity only
`#verbose`	Detailed output
`#silent`	Minimal feedback

Rollback & Restore¶

/co rollback u:<user> t:<time> r:<radius>

Reverts a player's actions within the specified time and area.

/co restore u:<user> t:<time> r:<radius>

Undoes a rollback or restores a player's actions.

/co undo

Reverses your last rollback or restore.

Other Commands¶

Command	Description
`/co near`	Quick lookup within 5-block radius
`/co purge t:<time>`	Remove old data from database
`/co reload`	Refresh configuration
`/co status`	Show plugin version and state
`/co consumer`	Pause/resume data queue

Examples¶

/co l u:xeno9118 t:1d r:10 a:block

Look up all block changes by xeno9118 in the last day within 10 blocks.

/co rb u:griefer123 t:12h r:#world a:-block

Roll back all blocks broken by griefer123 in the last 12 hours, entire world.

/co l t:1h a:container i:diamond

Look up all diamond container transactions in the last hour.

Permissions¶

Permission	Description
`coreprotect.*`	All CoreProtect commands
`coreprotect.inspect`	Inspect command
`coreprotect.lookup`	Lookup command
`coreprotect.rollback`	Rollback command
`coreprotect.restore`	Restore command
`coreprotect.teleport`	Teleport to lookup results
`coreprotect.purge`	Purge command
`coreprotect.reload`	Reload config