Articles on: Plugin Setup

How to install and use GriefPrevention [Java]

In this article, you'll learn how to install and setup GreifPrevention plugin.

How to Install GriefPrevention

Go to GreifPrevention Spigot page.
Click on Download Now.
Upload it to your plugins folder in WitherPanel.

Go to console tab on the sidebar and restart your server.
The plugin should be install and ready to use. You can check by running pl in console.

How to use GreifPrevention


In order to use greif prevention players need to "claim" their land by using golden shovel in two opposite corners.
Players can create and manage their land.
The first chest a player places will create a claim around.
Explosion/PvP can be enabled and disabled in claim.
Claims are impossible to greif.
Admins can restore land outside the claims.
Anti-Alt and Anti-chat spam protection.

Configuring The Plugin

##### Limiting Which Worlds GriefPrevention Runs On
Use the claims.mode configuration variable to list which worlds players may create claims in. Options are Survival, Creative, SurvivalRequiringClaims, and Disabled.

When you disable land claims in a world, most of GriefPrevention’s features turn off for that world as well. There are very few exceptions, for example anti-spam.

Beware - if you set a world to Disabled which already includes some land claims, those land claims will stop protecting the blocks inside. You can use this setting, for example, to turn off GP land claims in a Factions or Towny world.

##### Land Claim Settings
Claim Limits

Claims.InitialBlocks: 100

The number of claim blocks a new player starts with. Note that if you allow automatic new player claims, those claims can still be larger than this number (the player will just go into negative claim blocks until he accrues more).

Claims.BlocksAccruedPerHour: 100

The number of claim blocks awarded to players for each hour of play time on your server. These are awarded gradually (about every 5 minutes), but only to players who aren’t just standing around doing nothing (idling).

Claims.MaxAccruedBlocks: 80000

The maximum number of accrued claim blocks any player may amass. This number does not limit bonus claim blocks granted by administrators (see above).

MaximumNumberOfClaimsPerPlayer: 0

If you set this to more than zero, players won’t be able to own more than the number of claims you specify. To exempt a player from this limit, use permission griefprevention.overrideclaimcountlimit, which operators have by default.

Claims.AutomaticNewPlayerClaimsRadius: 4

When a player who doesn’t have any claimed land places a chest, he automatically gets a claim with the chest at its center. This configuration variable determines the size of that claim (as number of blocks away from the chest, NOT including the chest itself). So the default radius 4 would create a 9 x 9 = 81 total blocks claim, centered at the placed chest.

To protect only the chest itself, set this to zero.

To disable automatic new player claims entirely, set this to a negative number. Before disabling this feature, consider that it’s vital to the user-friendly nature of this plugin, because it protects players who don’t know how to use the golden shovel or don’t have access to a golden shovel yet, and also educates them about the golden shovel. If you disable it, you’ll need a plan to educate new players about the golden shovel, for example by posting signs near the spawn.

Claims.ExtendIntoGroundDistance: 5

How far into the ground a new claim should extend from the golden shovel location. If the golden shovel is used at two different heights, the lower value will be used in conjunction with this variable. To guarantee all claims run all the way to bedrock, use a very large number. The default doesn’t sink to bedrock because that would effectively claim valuable ore that the player placing them claim hasn’t discovered yet. Please note! As a player digs or builds underneath his claim, his claim automatically sinks lower with him. Thus, mine shafts and basements are safe from grief even if you set this variable at a small value.

Claims.MaximumDepth: 0

Maximum depth claims are allowed to reach. If you set this greater than zero, some players may have difficulty because they’re not accustomed to thinking in terms of coordinates. Further, a future patch may remove the debug screen (which displays coords) from the standard client. Anyway if you don’t want players claiming underground, you can set this to something near sea level. Or, lower to prevent players from claiming diamond-laden areas.

Claims.MinSize: 10

The minimum size for sides of a claim. If you make this very small, griefers may run around creating very tiny claims all over the place just to annoy other players. And then you’ll have to come clean it up. Note that administrative claims (/adminclaims mode) ignore this rule, so you can use that together with /transferclaim to create smaller claims on a claim-by-claim basis, as needed.

##### Claim Security
Claims.PreventTheft: true

Set this to false if you want to allow players to steal from claimed containers (like chests and furnaces) and attack claimed animals.

Claims.PreventButtonsSwitches: true

Set this to false if you don’t want players to use buttons and swtiches to limit access to their builds. Players can still limit access by simply using solid blocks rather than a door, so this won’t guarantee all players can explore all of the world.

Claims.LockAllDoors: false

By default, only iron doors are lockable. This encourages players to “earn” their privacy by playing the game enough to gather iron ore, and then learning very basic redstone engineering. If you set this to true, then ALL doors (wooden doors, trap doors, fence gates) will require /accesstrust for a player to open, unless the builder has placed a touchplate in front of the door for visitors. Many of your players might not be aware of /accesstrust, which could lead to a lot of near-strangers getting /trust, which can open a lot of builds to grief.

##### Restricting Where Claims May Be Created
Use the claims.worlds configuration variable to list which worlds players may create claims in. Options are Survival, Creative, and Disabled. Beware - if you set a world to Disabled which already includes some land claims, those land claims will stop protecting the blocks inside.

If you want to prevent players from making claims in a specific area without impacting their ability to build there, place an administrative claim and then use /trust public while standing inside it. Players can do anything they want there now except for claiming land, because the area is already claimed.

##### Restricting Who Can Create
By default, all players may create claims with the shovel. To prevent a player from creating land claims with the shovel, take away the griefprevention.createclaims permission. This does NOT block new player claims. To disable those for everyone, set the Claims.AutomaticNewPlayerClaimsRadius to -1.

If you choose to effectively disable player claims, then you might also want to take away the permission from all players. This permission is granted to everyone by default, and is necessary for the claims-related slash commands. So by taking it away, you will clean up their /help experience.

You can view the full guide to configuration by clicking here

Player Commands

/AbandonClaim - Deletes the claim you're standing in.
/ClaimExplosions - Toggles if explosions are allowed in the claim.
/Trust - Gives another player permission to edit in your claim.
/UnTrust - Revokes any permissions granted to a player in your claim.
/AccessTrust - Gives a player permission to use your buttons, levers, and beds.
/ContainerTrust - Gives a player permission to use your buttons, levers, beds, crafting gear, containers, and animals.
/TrustList - Lists the permissions for the claim you're standing in.
/SubdivideClaims - Switches your shovel to subdivision mode, so you can subdivide your claims.
/BasicClaims - Puts your shovel back in basic claims mode.
/PermissionTrust - Grants a player permission to share his permission level with others.
/Untrust All - Removes all permissions for all players in your claim.
/AbandonAllClaims - Deletes all of your claims.
/BuyClaimBlocks - Converts server money to claim blocks.
/SellClaimBlocks - Converts claim blocks to server money.
/GivePet - Gives away a tamed animal.
/ClaimsList - Lists a player's claims and claim block details.
/IgnorePlayer - Ignores a target player's chat messages.
/UnIgnorePlayer - Un-ignores a target player's chat messages.
/IgnoredPlayerList - Lists all players currently ignored.
/Trapped - Gets a player out of a land claim he's trapped inside.
/UnlockDrops - Allows other players to pick up items you dropped when you died.

Admin Commands

/AdjustBonusClaimBlocks - Adjusts the number of claim blocks available to a player.
/SetAccruedClaimBlocks - Sets the number of accrued blocks available to a player.
/RestoreNature - Switches the shovel to restore nature mode.
/RestoreNatureAggressive - Switches the shovel to aggressive restore mode.
/RestoreNatureFill - Switches the shovel to fill mode.
/IgnoreClaims - Toggles claims override.
/AdminClaims - Switches the shovel to administrative claims mode.
/BasicClaims - Switches the shovel back to basic claims mode.
/DeleteClaim - Deletes the claim you're standing in.
/DeleteAllClaims - Deletes all claims belonging to a specific player.
/ClaimsList <otherPlayer> - Lists a player's claims and claim block details.
/AdminClaimsList - Lists all administrative claims.
/SoftMute - Partially mutes a player (he and others on soft mute will still get his messages).
/Separate - Forces two players to ignore each other without notifying them.
/UnSeparate - Reverses /Separate.
/ClaimBook <otherPlayer> - Gives a player a replacement claim information book.

Updated on: 14/06/2022

Was this article helpful?

Share your feedback


Thank you!