Allow me to preface this long, meticulous, informational post with: Prism is a cool plugin that allows you to undo grief of all kinds. However, since it does so much, it can kinda be confusing! And thus, I, your glorious _leroy, have deigned to write this wiki to help you get a grasp on the full breadth of your power.
First, the basic commands and what they mean. (A full list of commands can be found on the official wiki.)
Note that whenever you view results in chat, you can click on the number to teleport to the result, hover over each word to view more information, and click the Prev/Next buttons to navigate pages.
/pr i is short for your Prism inspection tool. This actives whatever your inspection tool has been set to (by default: your hand). You can left-click on a block to see all changes done to that particular block space. You can right-click to see all changes done to the adjacent side. You can re-enter the command to disable the wand.
/pr setmy wand item [block ID] will set your wand to a specific block. Most staff have it set to 7, which is bedrock.
/pr drain [radius] will drain any liquids within the radius specified. Can be undone with /pr undo.
/pr ex [radius] will extinguish any fires within the radius specified.
/pr near [radius] will list all the actions done within a certain radius around you. The default radius is 30.
/pr l is the Prism lookup command. This command is what you use if you're trying to see actions, similar to /pr near. It is meant for when you're looking for specific stuff. Requires the action, radius, and time parameters.
/pr pg [page number] will open the history to that page, provided there is another page. Can use /pr pg next|prev to cycle through the pages.
/pr pv rb is the Prism preview and rollback command. This command is what you use to rollback any and all grief done. It undoes practically any and all actions! It requires only player, radius, and time paramaters to function.
/pr pv rs is the Prism preview and restore command. This command is what you use to restore something, particularly what you undid if you done goofed with your rollback. It redoes practically any and all actions! It requires only player, radius, and time parameters to function.
/confirm and /cancel are shorthands for completing or cancelling the preview.
The locate, rollback, and restore commands are useless without parameters. What are parameters, you might ask? Good question. No clue. Parameters define the range of what you are rolling back or restoring. The parameters you will find are (but not limited to):
- p: is the player parameter. This is what you use to specify whose actions to undo/redo. If you want to list more than one player, you can separate them with a comma (but not a space!).
- a: is the action parameter. This is what you use to specify which actions to undo/redo. If you want to list more than one action, you can separate them with a comma (but, again, not a space!).
Actions you might come across
- break specifies actions that resulted in something being broken.
- place specifies actions that placed something.
- kill specifies actions which killed something. This can be paired with the entity parameter, e:<entity name>.
- insert specifies actions in which an entity was inserted into an inventory.
- remove specifies actions in which an entity was removed from an inventory.
- drop specifies actions in which something was dropped.
- pickup specifies actions in which something was picked up.
A full list can be seen here
- r: is the radius parameter. This is what you use to specify how far away you want the rollback/restore to apply.
- global makes Prism not limit the block changes to a location.
- world:<world> limits the rollback/restore to the current world.
- t: is the time parameter. This is what you use to specify how long ago the actions that need to be undone/redone happened. Use shorthand and combine the arguments however you wish (d = days, h = hours, m = minutes, and you can say 3d or 3d5h10m or so on).
- before: is another time parameter. This helps you specify the window of time that you want actions to be undone/redone. Again, use shorthand and combine the arguments as you wish.
- b: is the block parameter. This is what you use to specify only particular blocks to be undone. Can be the block's name or ID (i.e. both b:grass and b:2 will affect grass blocks).
Extra parameters and flags
- after: is another time parameter. It works the same as t:.
- w: is the world parameter. This is what you use to specify which world for the rollback/restore to take place in. It defaults to the world you're currently in.
- e: is the entity parameter. This is what you use to specify which entities for the rollback/restore to affect.
- -drain is a flag that initiates the drain action. Can add -water or -lava to specify which liquid.
Other flags can be found here.
If you want to exclude a particular action, player, or entity, you can use ! in front of what you're excluding. (It'd read as p:!spike618 if I wanted to undo everything except what I did in the actions.) Additionally, you can use ~ to make partial matches for player names. (It'd read as p:~spike if I wanted to find me without fully typing it out. )
/pr pv rb a:drop t:15m r:30 p:Pugabyte - Roll back a death (only when a server-side bug causes them to die)
/pr l t:15m r:35000 a:insert p:Pugabyte - Find a lost item
/pr pv rb t:2d r:50 p:GrieferBear - Undo grief
/pr pv rb a:break b:diamond_ore,gold_ore,lapis_ore,iron_ore,emerald_ore t:2h r:100 - Helpful for investigating XRay
And don't forget that you can always do /siprism for some quick help! Have fun! ;)