# CoreProtect

[CoreProtect](https://docs.coreprotect.net)<span style="white-space: pre-wrap;"> is our data logging and anti-griefing tool. We use this plugin to rollback areas, check for player actions, and backup the server.</span>

<table id="bkmrk-command-description-" style="width: 100%;"><colgroup><col style="width: 29.6738%;"></col><col style="width: 70.3262%;"></col></colgroup><thead><tr><td>Command</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">/co help</span>`

</td><td>🛡️ 📗 Display a list of commands in-game.

</td></tr><tr><td>`<span class="editor-theme-code">/co inspect</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📗 Enable the inspector. Type the command again to disable it. You can also use just </span>`<span class="editor-theme-code">/co i</span>`.

</td></tr><tr><td>`<span class="editor-theme-code">/co lookup</span>`

</td><td>🛡️ 📗 Check for specific actions by a player, in an area, or even in the past set amount of time.

</td></tr><tr><td>`<span class="editor-theme-code">/co rollback</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Perform a rollback. Uses the same parameters as </span>`<span class="editor-theme-code">/co lookup</span>`<span style="white-space: pre-wrap;">. </span>

*Rollbacks can be used to revert player actions.*

</td></tr><tr><td>`<span class="editor-theme-code">/co restore</span>`

</td><td><span style="white-space: pre-wrap;">🛡️ 📒 Perform a restore. Uses the same parameters as </span>`<span class="editor-theme-code">/co lookup</span>`<span style="white-space: pre-wrap;">. </span>

*Restoring can be used to undo rollbacks or to restore player actions.*

</td></tr><tr><td>`<span class="editor-theme-code">/co purge t:<time> r:<world></span>`

</td><td>🛡️ 📕 Purge old block data. Useful for freeing up space on your HDD if you don't need the older data.

</td></tr><tr><td>`<span class="editor-theme-code">/co reload</span>`

</td><td>🛡️ 📗 Reloads the configuration file.

</td></tr><tr><td>`<span class="editor-theme-code">/co status</span>`

</td><td>🛡️ 📗 Displays the plugin status and version information.

</td></tr><tr><td>`<span class="editor-theme-code">/co consumer</span>`

</td><td>🛡️ 📗 Console command to pause or resume consumer queue processing.

</td></tr><tr><td><span class="editor-theme-code">`/co near`</span>

</td><td>🛡️ 📗 Performs a lookup with a radius of 5.

</td></tr><tr><td><span class="editor-theme-code">`/co undo`</span>

</td><td><span style="white-space: pre-wrap;">🛡️ 📒</span> Revert a rollback/restore via the opposite action.

</td></tr></tbody></table>

<table id="bkmrk-parameter-descriptio" style="width: 100%;"><colgroup><col style="width: 15.0155%;"></col><col style="width: 84.9845%;"></col></colgroup><thead><tr><td>Parameter</td><td>Description</td></tr></thead><tbody><tr><td>`<span class="editor-theme-code">u:<user></span>`

</td><td>Specifies a single user or multiple users.

</td></tr><tr><td>`<span class="editor-theme-code">t:<time></span>`

</td><td>Specifies weeks, days, hours, minutes, and/or seconds. Time amounts can be combined, and decimals may be used.

</td></tr><tr><td>`<span class="editor-theme-code">r:<radius></span>`

</td><td>Specifies a spherical radius centered at your current location.

</td></tr><tr><td>`<span class="editor-theme-code">a:<action></span>`

</td><td>Specifies an action to check.

</td></tr><tr><td>`<span class="editor-theme-code">i:<include></span>`

</td><td>Specifies a block, item, or entity that the operation must include.

</td></tr><tr><td>`<span class="editor-theme-code">e:<exclude></span>`

</td><td>Specified a block, item, or entity that the operation must not include.

</td></tr><tr><td>`<span class="editor-theme-code">#<parameter></span>`

</td><td>Add a hashtag to the end of your command to perform additional actions.

</td></tr></tbody></table>

<table class="docutils" id="bkmrk-action-description-a"><thead><tr><th class="align-left">Action</th><th class="align-left">Description</th></tr></thead><tbody><tr><td>`a:block`</td><td>blocks placed/broken</td></tr><tr><td>`a:+block`</td><td>blocks placed</td></tr><tr><td>`a:-block`</td><td>blocks broken</td></tr><tr><td>`a:chat`</td><td>messages sent in chat</td></tr><tr><td>`a:click`</td><td>player interactions</td></tr><tr><td>`a:command`</td><td>commands used</td></tr><tr><td>`a:container`</td><td>items taken from or put in chests</td></tr><tr><td>`a:+container`</td><td>items put in chests</td></tr><tr><td>`a:-container`</td><td>items taken from chests</td></tr><tr><td>`a:inventory`</td><td>items added or removed from player inventories</td></tr><tr><td>`a:+inventory`</td><td>items added to player inventories</td></tr><tr><td>`a:-inventory`</td><td>items removed from player inventories</td></tr><tr><td>`a:item`</td><td>items dropped, thrown, picked up, deposited, or withdrawn by players</td></tr><tr><td>`a:+item`</td><td>items picked up or withdrawn by players</td></tr><tr><td>`a:-item`</td><td>items dropped, thrown, or deposited by players</td></tr><tr><td>`a:kill`</td><td>mobs/animals killed</td></tr><tr><td>`a:session`</td><td>player logins/logouts</td></tr><tr><td>`a:+session`</td><td>player logins</td></tr><tr><td>`a:-session`</td><td>player logouts</td></tr><tr><td>`a:sign`</td><td>messages written on signs</td></tr><tr><td>`a:username`</td><td>username changes</td></tr></tbody></table>

## Example Commands

### Example Rollback Commands

By default, if no radius is specified, a radius of 10 will be applied, restricting the rollback to within 10 blocks of you. Use `r:#global` to do a global rollback.

- `/co rollback Notch t:1h`  
    *(rollback Notch 1 hour (with default radius of 10))*
- `/co rollback u:Notch,Intelli t:1h #preview`  
    *(PREVIEW rolling back both Notch &amp; Intelli 1 hour (with default radius of 10))*
- `/co rollback u:Notch t:23h17m`  
    *(rollback Notch 23 hours and 17 minutes (with default radius of 10))*
- `/co rollback u:Notch t:1h i:stone`  
    *(rollback ONLY stone placed/broken by Notch within the last hour (with default radius of 10))*
- `/co rollback u:Notch t:1h i:stone a:-block`  
    *(rollback ONLY stone BROKEN by Notch within the last hour (with default radius of 10))*
- `/co rollback u:Notch t:1h r:#global e:stone,dirt`  
    *(rollback EVERYTHING Notch did in the last hour EXCEPT for stone and dirt placed/broken)*
- `/co rollback u:Notch t:1h r:20`  
    *(rollback griefing Notch did in the last hour that is within 20 blocks of you)*
- `/co rollback u:Notch t:1h r:#nether`  
    *(rollback griefing Notch did in the last hour ONLY in the Nether)*
- `/co rollback u:Notch t:5m a:inventory`  
    *(rollback inventory transactions by Notch in the last 5 minutes)*
- `/co rollback t:15m r:30`  
    *(rollback everything done in the last 15 minutes by anyone within 30 blocks of you)*
- `/co rollback t:15m r:#worldedit`  
    *(rollback everything done in the last 15 minutes in a WorldEdit selection)*

### Example Lookup Commands

Lookup commands are generally the same as rollback commands. The primary difference is that a default radius is not applied to lookups, meaning all lookup commands do a global search by default.

- `/co lookup i:diamond_ore t:1h a:-block`  
    *(lookup all diamond ore mined in the last hour)*
- `/co lookup u:Notch t:30m a:chat`  
    *(lookup chat messages sent by Notch in the last 30 minutes)*
- `/co lookup u:Notch t:3d a:inventory`  
    *(lookup inventory transactions by Notch in the last 3 days)*
- `/co lookup u:Notch a:login`  
    *(lookup all logins ever done by Notch)*
- `/co lookup u:Notch a:login`  
    *(lookup all logins ever done by Notch)*
- `/co lookup u:Notch a:username`  
    *(lookup previous usernames used by Notch)*