• User avatar
  • User avatar
User avatar
By Intelli
#82240
This documentation has moved!

For the latest version, please visit https://docs.coreprotect.net/commands/

CoreProtect Commands

You can access the commands using either "/coreprotect", "/core", or "/co".

Quick Command Overview:
  • /co help - Display a list of commands
  • /co inspect - Toggle the inspector
  • /co rollback <params> - Rollback block data
  • /co restore <params> - Restore block data
  • /co lookup <params> - Advanced block data lookup
  • /co purge <params> - Delete old block data
  • /co reload - Reload the configuration file
  • /co status - View the plugin status
Shortcut Commands:
  • /co near - Performs a lookup with a radius of 5
  • /co undo - Revert a rollback/restore via the opposite action

Detailed command information is listed below.



| /co help
| Display a list of commands in-game.



| /co inspect
| Enable the inspector. Type the command again to disable it. You can also use just "/co i".



| /co rollback u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
| Nearly all of the parameters are optional. Shortcut: "/co rb".

u:<user> - Specify a user to rollback.
Example: u:Notch

You can also combine multiple users.
Example: u:Notch,Intelli
t:<time> - Specify the amount of time to rollback
You can specify weeks,days,hours,minutes, and seconds.

Example: t:2w,5d,7h,2m,10s

You can pick and choose time amounts.
Example: t:5d2h

You can also use decimals.
Example: t:2.50h (2 and a half hours)
r:<radius> - Specify a radius.
You can use this to only rollback blocks near you.

You can specify a number (e.g. r:5), a world (e.g. r:#world_the_end), a global rollback (r:#global), or a WorldEdit selection (r:#worldedit or r:#we)

For example, the following would only rollback damage within 10 blocks of where you are standing: r:10
a:<action> - Restrict the lookup to a certain action
For example, if you wanted to only rollback blocks placed, you would use a:+block

Here's a list of all the actions:
  • a:block (blocks placed/broken)
  • a:+block (blocks placed)
  • a:-block (blocks broken)
  • a:chat (messages sent in chat)
  • a:click (player interactions)
  • a:command (commands used)
  • a:container (items taken from or put in chests)
  • a:+container (items put in chests)
  • a:-container (items taken from chests)
  • a:inventory (items dropped or picked up by players)
  • a:+inventory (items picked up by players)
  • a:-inventory (items dropped by players)
  • a:item (items dropped, picked up, taken from, or put in chests)
  • a:+item (items picked up or put in chests)
  • a:-item (items dropped or taken from chests)
  • a:kill (mobs/animals killed)
  • a:session (player logins/logouts)
  • a:+session (player logins)
  • a:-session (player logouts)
  • a:sign (messages written on signs)
  • a:username (username changes)
b:<blocks> - Restrict the rollback to certain block types.
For example, if you wanted to only rollback stone, you would use b:stone
You can specify multiple blocks, such as b:stone,oak_wood,bedrock

You can find a list of block type IDs at https://minecraft.fandom.com/wiki/Java_ ... ata_values
e:<exclude> - Exclude certain block types from the rollback.
For example, if you don't want TNT to come back during a rollback, you would type e:tnt
#<hashtag> - Add a hashtag to the end of your command to perform additional actions.
For example, to perform a rollback preview, you would use #preview

Here's a list of available hashtags:
  • #preview (Preview a rollback/restore)
  • #count (Return the number of rows found in a lookup query)
  • #verbose (Display additional information during a rollback/restore)
  • #silent (Display minimal information during a rollback/restore)


| /co restore u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
| Same parameters as /rollback. Shortcut: "/co rs".

Restoring can be used to undo rollbacks.



| /co lookup u:<user> t:<time> r:<radius> a:<action> b:<blocks> e:<exclude>
| Search through block data using the same parameters as /co rollback. Shortcut: "/co l".

If multiple pages are returned, use the command "/co lookup <page>" to switch pages.
To change the number of lines displayed on a page, use the command "/co lookup <page>:<lines>".

For example, "/co l 1:10" will return 10 lines of data, starting at the first page.



| /co purge t:<time> r:<world>
| Purge old block data. Useful for freeing up space on your HDD if you don't need the older data.

For example, "/co purge t:30d" will delete all data older than one month, and only keep the last 30 days of data.
If used in-game, only data older than 30 days can be purged. If used from the console, only data older than 24 hours can be purged.

You can also optionally specify a world in CoreProtect v19+.
E.g. "/co purge t:30d r:#world_nether" will delete all data older than one month in the Nether, without deleting data in any other worlds.

In CoreProtect v2.15+, adding "#optimize" to the end of the command (e.g. "/co purge t:30d #optimize") will also optimize your tables and reclaim disk space.
This option is only available when using MySQL, as SQLite purges do this by default.

Please note adding the #optimize option will significantly slow down your purge, and is generally unnecessary.



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.

Rollback Notch 1 hour (with default radius of 10):
/co rollback Notch t:1h

PREVIEW rolling back both Notch & Intelli 1 hour (with default radius of 10):
/co rollback u:Notch,Intelli t:1h #preview

Rollback Notch 23 hours and 17 minutes (with default radius of 10):
/co rollback u:Notch t:23h17m

Rollback ONLY stone placed/broken by Notch within the last hour (with default radius of 10):
/co rollback u:Notch t:1h b:1

Rollback ONLY stone BROKEN by Notch within the last hour (with default radius of 10):
/co rollback u:Notch t:1h b:stone a:-block

Rollback EVERYTHING Notch did in the last hour EXCEPT for stone and dirt placed/broken:
/co rollback u:Notch t:1h r:#global e:stone,dirt

Rollback griefing Notch did in the last hour that is within 20 blocks of you:
/co rollback u:Notch t:1h r:20

Rollback griefing Notch did in the last hour ONLY in the Nether:
/co rollback u:Notch t:1h r:#nether

Rollback everything done in the last 15 minutes by anyone within 30 blocks of you:
/co rollback t:15m r:30

Rollback everything done in the last 15 minutes in a WorldEdit selection:
/co rollback t:15m r:#worldedit



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.

Lookup all diamond ore mined in the last hour:
/co lookup b:56 t:1h a:-block

Lookup all chat messages sent by Notch in the last 30 minutes:
/co lookup u:Notch t:30m a:chat

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:login

Lookup previous usernames used by Notch:
/co lookup u:Notch a:username
By Nomizak
#94086
What an amazingly simple and efficient plugin! Now I don't have to worry about rolling back the entire server and losing work. Thank you so much!!
By ravingmonkey1
#96366
Great I'm new to plugins so don't know what mysql is and all the others i found need it. this however great and does all i need from it. A+++++ :D
By Seorsum
#96760
When I did a rollback just now, a sign returned to where it was placed, except the writing was not rolled back also. Do signs' text normally get replaced or are they always blank when rolled back?
By simonn
#100189
When i type in the user part.. it says user not found when the user is on?
and when i type /co t; 1h r; 10 it says specify the amount of times to rollback?
By Press45201
#101709
Doent work for me please help!!! i type /co rollback u;honeybadger14111 t;1w r;10
And dosent work please help!!
By aFlyingElefant
#102181
I was very happy to find this plugin, it's simple and it works. But, is there any way to rollback tnt explosions because it doesn't work for me.
  • 1
  • 2
  • 3
  • 4
  • 5
  • 8
long long title how many chars? lets see 123 ok more? yes 60

We have created lots of YouTube videos just so you can achieve [...]

Another post test yes yes yes or no, maybe ni? :-/

The best flat phpBB theme around. Period. Fine craftmanship and [...]

Do you need a super MOD? Well here it is. chew on this

All you need is right here. Content tag, SEO, listing, Pizza and spaghetti [...]

Lasagna on me this time ok? I got plenty of cash

this should be fantastic. but what about links,images, bbcodes etc etc? [...]