How to use GriefPrevention

From This Land Wiki
Jump to: navigation, search
This article would benefit from some images
Please help by uploading and embedding if you can!
Optional picture suggestions: Some visuals about what it looks like when you make a claim and a subdivision in the default texturepack would be great. Maybe a picture of error messages you get if you try to move stuff in someone else's claim, too? I'll happily do this, but if someone else gets there first it's cool. :) --Cass
See all articles that need pictures
GriefPrevention is a server plugin which allows players to claim areas of the map to protect them from being griefed (intentionally damaged by other players).

Summary

Using GriefPrevention, players can "claim" sections of the map. These claims are automatically protected from any damage or changes made by anyone other than the claiming player, for example:

  • Breaking or placing blocks.
  • Using buttons and levers.
  • Picking up or placing liquids.
  • Opening chests.
  • Being claimed by anyone else.

(A complete list of protected actions is available on the plugin website). If a player tries to do a protected action inside a claim, it won't work and they will see a message telling them they do not have permission.

The claiming player can customise the permissions for other players within their claim. For example; they can allow other players to press buttons but not to open chests, or allow a specific player to build in their claim but no-one else. Claims can also be subdivided and different permissions set for different subdivisions, as well as resized or removed - all using simple commands.

Each player has a certain quantity of blocks they are allowed to claim, which increases over time as they play on the server. If a player doesn't log on to the server for one year, their claims will be automatically abandoned (if you know you are going to be inactive for this length of time and want to keep your claims, contact the admin, Cassolotl. See also abandoned builds and inactive players).

Seeing and understanding claims

Claims are shown in the game when you equip a wooden shovel, when you alter your claims, or when you attempt to do something you don't have permission for. Claims are shown using 'phantom blocks' (glowstone, gold, and others) which appear to mark out the corners and borders of the claim. These blocks aren't really there - if you hit or right-click them they will disappear and revert to the real block. The borders of subdivisions are also marked out using phantom blocks.

You can see a list of all your existing claims by typing the command /claimslist in the game. This will show the co-ordinates of one corner of the claim, and the size of the claim in blocks.

Making and resizing claims

To make and alter claims, you need to be holding a wooden shovel. When you equip it, a message will prompt you that you can make GriefPrevention claims. All claims are rectangular areas of the map, and extend the full height of the world (from y=0 to y=256).

To make a claim

  1. Right-click on the first corner of the rectangle you want to claim.
  2. (Without unequipping the shovel in between) Right-click on the opposite corner.

The rectangle defined by those corners will then be claimed and you will see a success message, unless the claim is invalid. A claim may be invalid if:

  • It is too big (it uses more claim blocks than you have available)
  • It overlaps an existing claim (yours or someone else's)

An error message will tell you if your attempted claim is invalid, and why.

To resize a claim

You can resize a claim by moving any of the corners.

  1. Right-click on the corner which you want to move.
  2. (Without unequipping the shovel in between) Right-click on the new location you want the corner to be.

The claim will be resized to the new block position and you will see a success message, unless the resized claim is invalid. It may be invalid for the same reasons given above.

Standing in a claim and typing /extendclaim 5 will extend your claim by 5 blocks in whichever direction you are facing.

Subdivisions

A subdivision is an area within a claim. By default it will have the same permissions as the top-level claim, but you can set different permissions in different subdivisions. To subdivide claims, you need a wooden shovel. You then need to type the command /subdivideclaim. When you send the command, a message will tell you that you are in subdivision mode. If you unequip and re-equip the wooden shovel, you'll be reverted to regular claims mode and need to send the command again. All subdivisions, like regular claims, are rectangular areas of the map extending the full height of the world.

To make a subdivision

  1. Right-click on the first corner of the rectangle you want to make into a subdivision.
  2. (Without unequipping the shovel in between) Right-click on the opposite corner.

The rectangle defined by those corners will then be turned into a subdivision and you will see a success message, unless the subdivision is invalid. It may be invalid if:

  • It's not fully inside one of your existing claims.
  • It overlaps one of your existing subdivisions.

An error message will tell you if your attempted subdivision is invalid, and why.

To resize a subdivision

You can resize a subdivision in the same was as resizing a top-level claim, by moving any of the corners. To resize a subdivision:

  1. Right-click on the corner which you want to move.
  2. . (Without unequipping the shovel in between) Right-click on the new location you want the corner to be.

The claim will be resized to the new block position and you will see a success message, unless the resized claim is invalid. It may be invalid for the same reasons given above.

Abandoning claims and subdivisions

To abandon a specific claim, you must be standing inside it. For a simple top-level claim, type /abandonclaim. This will remove your claim of the area and the claim blocks will be available for you to make new claims with.

For claims with subdivisions, it is slightly more complicated. To remove a subdivision from a claim (without affecting the top-level claim), stand inside the subdivision and type /abandonclaim. The abandon a top-level claim along with all its subdivisions, stand anywhere inside the top-level claim and type /abandontoplevelclaim.

You can also abandon all of your existing claims at once. To do this, you don't need to be standing inside a claim - just type /abandonallclaims.

Permissions

By default, any new claim does not have any permissions - this means no player apart from you will be able to do any restricted actions inside the claim. Any new subdivision will have the permissions of the top-level claim it's inside by default.

To give permission to other players to do things in your claims, you can use commands which have two parameters. The first parameter is the permission type, which defines what you are giving players permission to do. The second parameter is the target of the permission, which defines who is allowed to do it. When you send a permission command, it applies to the claim or subdivision you are standing in.

The permissions types available are:

  • accesstrust. This gives permission to use buttons, levers, and beds.
  • containertrust. This gives permission for crafting gear, chests, and animals, and all of the above.
  • trust. This gives permission to break and place blocks, and all of the above.
  • permissiontrust. This gives permission to give *other* players their own permission level.
  • untrust. This removes any permissions that have been set for this target.

The targets available are:

  • all. This gives permission to any player.
  • [playername] This gives permission to the specific player.

To use a trust command, type /[permissiontype] [target]. Example:

  • To give a Cassolotl permission to open chests inside the claim, type /containertrust Cassolotl.
  • To give everyone permission to use buttons and levers, type /accesstrust all.
  • To take away Cassolotl's permission to open chests in the claim, type /untrust Cassolotl.

You can find out which permissions you have previously set for the claim or subdivision you are standing in by typing /trustlist. This will show a list of the players (or "all") who currently have each type of permission in the claim or subdivision.

There is one more permission command you can use to give away a tamed animal (cat or dog) which belongs to you. Type /givepet [playername]. You will be prompted to right-click on the pet you want to give away. The pet will then be transferred to their ownership and you will get a success message. To cancel the givepet command, type /givepet cancel.

Trapped

It is possible to get trapped inside someone else's claim. For example, you might fall into a hole and not be able to place a block to climb out. If this happens, you can use the command /trapped. This will teleport you out to the nearest unclaimed part of the map.

See also