Page 1 of 8

CoreProtect - Commands

Posted: Fri Mar 09, 2012 3:43 am
by Intelli
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

Re: CoreProtect - Commands

Posted: Tue Mar 13, 2012 8:10 pm
by Wingdow7
Thank you VERY MUCH!!!

I was waiting for Big Brother to come out but, i think this is better!


Thank you!!!!!!


http://cafe.naver.com/hmcserver (<- Its in Korean, by the way)

Re: CoreProtect - Commands

Posted: Mon Apr 09, 2012 1:31 pm
by kindreganrobert
we can rollback other users o.O?

Re: CoreProtect - Commands

Posted: Tue Apr 10, 2012 2:46 pm
by CWS
This plugin is really cool and easy to use 8-)

Best one I have tested: 5*

Re: CoreProtect - Commands

Posted: Mon Apr 30, 2012 9:29 am
by Nomizak
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!!

Re: CoreProtect - Commands

Posted: Thu May 10, 2012 1:55 pm
by ravingmonkey1
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

Re: CoreProtect - Commands

Posted: Sat May 12, 2012 7:24 pm
by Seorsum
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?

Re: CoreProtect - Commands

Posted: Mon May 28, 2012 2:23 am
by simonn
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?

Re: CoreProtect - Commands

Posted: Sun Jun 03, 2012 1:41 pm
by Press45201
Doent work for me please help!!! i type /co rollback u;honeybadger14111 t;1w r;10
And dosent work please help!!

Re: CoreProtect - Commands

Posted: Tue Jun 05, 2012 3:11 pm
by aFlyingElefant
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.