Links

Land Claiming

Claim Types

There are four types of user claims : admin, town, basic and subdivisions, with each having a 2D and 3D mode. To switch between types use /adminclaims, /townclaims and /basicclaims. To switch to subdivision mode, use /claimsubdivide. All three main claim types support direct child claims (subdivisions) - Town, Admin and Basic.
Admin claims have no size limitations and different flags compared to basic claims which normal players can make. Towns can also be made by players, and supports the creation of basic claims within town claims. Basic claims are the go-to claim type for players, and can support a player's own management of claim flags. For more information, visit our permission page, which will help you assign proper permissions.

Basic

Basic claims are the default claim type used for users.
A basic claim has the following capabilities
  • 5x5 size restriction in 2D mode. 5x5x5 size restriction in 3D mode.
  • Can be sold, rented, or transferred to another player.
  • Requires claim blocks.
This is the default claim type mode when equipping the claiming tool (minecraft:golden_shovel). Note: Use /basicclaims or /gd mode basic to switch to this claim type mode.

Subdivision

Subdivision claims are used to subdivide top level claims such as basic/admin/town into smaller areas.
A subdivision claim has the following capabilities
  • 1x1 size restriction in 2D mode. 1x1x1 size restriction in 3D mode.
  • Can be sold, rented, or transferred to another player.
  • Requires no claim blocks when created by owner.

Admin

Admin claims are the administrative tool by excellence. They can be overlapped over any claim type to enforce flags. To create an admin claim, the permission griefdefender.admin.claim.command.admin-mode is necessary. However, please note that griefdefender.admin is recommended - it'll allow the management of the admin typed claims.
An admin claim has the following capabilities
  • No size restrictions.
  • Does not cost anything to create.
  • Can be created around any existing claim.
  • Can rented.
  • Used by administrators only.
Note: Use /adminclaims or /gd mode admin to switch to this claim type mode.

Town Claims

Town claims are the third type of player claim introduced to GriefDefender. When holding the golden shovel, use /townclaimsto switch to Town claim mode. Once created, town claims can house other basic claims, much like subdivisions to basic or admin claims.
A town claim has the following capabilities
  • 32x32 size restriction in 2D mode. 32x32x32 size restriction in 3D mode.
  • Requires claim blocks.
  • Supports basic claims inside.
  • A creation limit of 1 which means you can only create 1 town by default. Note: This can be adjusted by changing griefdefender.create-limit to a value higher than 1 with gd_claim_default=town context.

Wilderness Claim

The wilderness claim is an administrative claim. It is automatically created on first time world load and uses any space not claimed by a user. It functions just like any other claim where you can assign flags and options to it. By default, all actions are allowed in the wilderness.

Trust System

There four different types of trust: Accessors, Builders, Containers, and Managers.

Arguments

Arguments
Description
<player>
The player to trust.
<group>
The group to trust. Note: If you want to trust everyone, use public.
<type>
The type of trust [none, accessor, resident, builder, container, manager]. Note: If you want to remove trust, use none. None: Revokes a player/group's access to your claim Accessor: Grants a player/group access to interact with all blocks except inventory Resident: Grants a player/group ability to create claims, includes accessor trust. Container: Grants a player/group access to interact with all blocks including inventory, includes accessor trust. Builder: Grants a player/group access to everything above, except Resident, including ability to place and break blocks Manager: Grants a player/group access to all of the above including ability to modify claim

Trust Player

Command: /gd trust player <player> <type> Alias: trust Example: /gd trust player Kratos basic
Grants a player access to your claim(s)

Trust Group

Command: /gd trust group <group> <type> Alias: trust
Grants a group access to your claim(s)

Remove Trust Player

Command: /gd trust player <player> none
Revokes a player's access to all your claims.

Remove Trust Group

Command: /gd trust group <group> none
Revokes a group's access to all your claims.

List Trusted

Command: /trustlist
Lists currently trusted players and the trust type.

Command Overview

Arguments Key: <required> [optional]

Claim Identifier

Many commands support the new argument [identifier] which is the claim id set by the claim owner. If you do not want to be required to stand in a claim for a specific command, set the claim identifier using /gd claim id <identifier> then pass the identifier at the end of the command. If using an identifier for an admin claim, the format is admin:<identifier> If using an identifier for wilderness, the format is wilderness:<identifier> If using an identifier for another player, the format is <playername>:<identifier>

Claims

Flags

Options

Trust

Note: Use public if you want to trust all users.

Admin

Main Command

Misc

The command list was ripped from the Plugin Wiki Page and may have information that is irrelevant. It will be updated eventually to be more player-friendly.

Command Detail

Claims

/gd abandon claim
Arguments: [identifier] Abandons a claim
/gd abandon all
Abandons ALL your claims
/gd abandon top
Abandons a claim and all its subdivisions
/gd buy blocks
Aliases: buyblocks Arguments: <numberOfBlocks>
Purchases additional claim blocks with server money. Doesn't work on servers without any economy plugin.
/gd buy claim
View a list of claims for sale. Click [Buy] to purchase.
/gd claim contract
Aliases: claimcontract, contractclaim Arguments: <amount> [direction] [identifier] Contracts/Shrinks the claim from the direction you are facing.
/gd claim create
Aliases: claimcreate Arguments: <radius> [type] Creates a claim around the player of the given type. If no claimtype (or an incorrect one) is specified, a basic claim will be created.
/gd claim expand
Aliases: claimexpand, expandclaim Arguments: <amount> [direction] [identifier] Expands the claim in the direction you are facing.
/gd claim farewell
Arguments: <message> [identifier] Sets the farewell message of your claim
To unset, /gd claim farewell clear
/gd claim greeting
Arguments: <message> [identifier] Sets the greeting message of your claim
To unset, /gd claim greeting clear
/gd claim id
Arguments: <identifier> Sets the friendly identifier of your claim.
/gd claim info
Aliases: claiminfo Arguments: [identifier]
Gets information about a claim you are standing in or by claim id.
/gd claim inherit
Aliases: inherit
Toggles parent claim inherit mode
/gd claim inspect
Aliases: claiminspect Arguments: [area|hide|hideall]
Inspects the target block player is looking at or nearby claims.
/gd claim list
Aliases: claimlist Arguments: [<player> [world]]
List information about a player's claims.
/gd claim displayname
Arguments: <name> Sets the display name of your claim
/gd claim rent
Arguments: create [<rate> [<max_days>]]|info|list|cancel] Used to rent/list claims. Note: Requires economy plugin.
/gd claim setspawn
Aliases: claimsetspawn
Sets the spawn of your claim to the location you are standing in.
/gd claim spawn
Aliases: claimspawn
Teleports you to claim spawn, if available.
/gd claim tax
Arguments: balance|force|pay <amount>] Used to manage taxes of a claim. Note: The argument force allows an admin to pay a claim's tax balance for another player. Note: Requires economy plugin.
/gd claim transfer
Aliases: transferclaim Arguments: <player> [identifier]
Transfer the claim you're standing in to a player.
/gd claim we
Arguments: [identifier] Claims a selection made in WorldEdit. Note: This command will not work unless the server has WorldEdit.
/gd claimgroup admin
Arguments: join <group> [<identifier>]|unjoin [<identifier>]|create <group>|delete <group> Used to manage admin claim groups.
/gd claimgroup player
Arguments: join <group> [<identifier>]|unjoin [<identifier>]|create <group>|delete <group> Used to manage player claim groups.
/gd cuboid
Aliases: cuboid
Toggles 3D cuboid claims mode.
/gd mode basic
Aliases: modebasic
Switches the shovel tool back to basic claims mode.
/gd mode subdivide
Aliases: modesubdivide
Switches the shovel tool to subdivision mode, used to subdivide your claims
/gd mode town
Aliases: modetown
Switches the shovel tool back to town claims mode.
/gd player info
Arguments: <player> <world>|<player>|[<world>]
Gets information about a player and their claimblocks
/gd player transferblocks
Aliases: transferblocks Arguments: <player> <amount>
Gives claim blocks to another player
/gd player trapped
Aliases: trapped
Teleports the player to a safe location if stuck and unable to build.
/gd player unlockdrops
Aliases: unlockdrops
Allows other players to pickup any items dropped from death.
/gd sell blocks
Aliases: sellblocks Arguments: <numberOfBlocks>
Sell your claim blocks for server money. Doesn't work on servers without any economy plugin.
/gd sell claim
Arguments: <price>
Puts your claim up for sale at the set price. To disable sale, set the price to -1 or set ForSale setting in /claiminfo to false.

Flags

/gd flag debug
Aliases: cfd
Toggles claim flag debug mode
/gd flag claim
Aliases: cf Arguments: [<flag> <target> <value> [<\contexts>]]
Gets/Sets claim flags in the claim you are standing in.
/gd flag definition
Aliases: cf Arguments: <preset:group> <definition> <value> [identifier]
Sets claim flag definitions in the claim you are standing in or claim identifier.
/gd flag group
Aliases: cfg Arguments: <group> <flag> <target> <value> [<\contexts>]]
Gets/Sets flag permission for a group in claim you are standing in.
/gd flag player
Aliases: cfp Arguments: <player> <flag> <target> <value> [<\contexts>]]
Adds flag permission to player.
/gd flag reset
Aliases: cfr
Resets a claim to flag defaults.

Options

/gd option claim
Aliases: co Arguments: [<option> <value> [<contexts>]]
Gets/Sets options in the claim you are standing in.
/gd option group
Aliases: cog Arguments: <group> [<option> <value> [<contexts>]]
Gets/Sets options for a group in claim you are standing in.
/gd option player
Aliases: cop Arguments: <player> [<option> <value> [<contexts>]]
Gets/Sets options for a player in claim you are standing in.

Trust

Note: public is for all users.
/gd trust player
Accessor: Grants a player entry to your claim(s) and use of your bed Container: Grants a player access to your claim's containers, crops, animals, bed, buttons, and levers Builder: Grants a player edit access to your claim(s) Manager: Grants a player access to all of the above including claim settings Aliases: trust Arguments: <player>|public <trusttype>
Grants a player access to your claim(s).
/gd trust group
Accessor: Grants a group entry to your claim(s) and use of your bed Container: Grants a group access to your claim's containers, crops, animals, bed, buttons, and levers Builder: Grants a group edit access to your claim(s) Manager: Grants a group access to all of the above including claim settings Aliases: trustgroup Arguments: <group>|public <trusttype>
Grants a group access to your claim(s)
/gd trustall player
Accessor: Grants a player entry to ALL your claim(s) and use of your bed Container: Grants a player access to ALL your claim's containers, crops, animals, bed, buttons, and levers Builder: Grants a player edit access to ALL your claim(s) Manager: Grants a player access to all of the above including claim settings Aliases: trust Arguments: <player>|public <trusttype>
Grants a player access to ALL your claim(s).
/gd trustall group
Accessor: Grants a group entry to ALL your claim(s) and use of your bed Container: Grants a group access to ALL your claim's containers, crops, animals, bed, buttons, and levers Builder: Grants a group edit access to ALL your claim(s) Manager: Grants a group access to all of the above including claim settings Aliases: trustallgroup Arguments: <group>|public <trusttype>
Grants a group access to ALL your claim(s).
/gd untrust player
Aliases: untrust Arguments: <player>|public
Revokes a player's access to your claim.
/gd untrust group
Aliases: untrustgroup Arguments: <group>|public
Revokes a group's access to your claim.
/gd untrustall player
Aliases: untrustall Arguments: <player>|public
Revokes a player's access to ALL your claim(s).
/untrustall group
Aliases: untrustallgroup Arguments: <group>|public
Revokes a group's access to ALL your claim(s).
/gd trust list
Lists permissions for the claim you're standing in

Flags

The Flags section may need updating to reflect player-use cases.
As shown below, both admin/user flags start off as either true or false and will represent the current active value of claim you are in.

ADMIN

Admin flags will ONLY affect the claim you are in.
Admin GUI
By default, admins have access to 2 modes PRESET and ADVANCED. The PRESET mode is directly linked to the minecraft flag definitions preset file. Each group is read into the GUI as a tab along with its definitions. There are 2 delivered groups that GD ships with, USER and ADMIN.
Both groups will apply flags to claim you are standing in. If you need flags set as a default, set it up in config as shown above.
Flag Definition
Default Value
Description
ambient-spawn
true
Controls whether ambients, such as bats, spawn.
animal-block-modify
true
Controls whether animals can modify blocks such as rabbits eating carrots.
animal-spawn
true
Controls whether animals, such as cows/pigs/horses/etc., spawn.
aquatic-spawn
true
Controls whether aquatics that live in water, such as squids, spawn.
armorstand-use
false
Controls whether armorstands can be placed or broken.
block-trampling
false
Controls whether farmland and turtle eggs can be trampled.
chorus-fruit-teleport
false
Controls whether a player can use chorus fruit to teleport.
commandblock-block-break
false
Controls whether command blocks can break blocks.
commandblock-block-place
false
Controls whether command blocks can place blocks.
creeper-block-explosion
false
Controls whether a creeper can explode blocks.
creeper-entity-explosion
false
Controls whether a creeper can explode entities.
endcrystal-use
false
Controls whether endcrystals can be placed or broken.
entity-armorstand-damage
false
Controls whether entities can deal damage to armorstands.
entity-itemframe-damage
false
Controls whether entities can deal damage to item frames.
exp-drop
true
Controls whether experience orbs can drop.
fall-entity-damage
true
Controls whether entities can take fall damage.
fall-player-damage
true
Controls whether players can take fall damage.
falling-block-break
true
Controls whether falling blocks can break.
fire-block-damage
true
Controls whether fire can cause block damage.
fire-entity-damage
true
Controls whether fire can cause entity damage.
lightning-damage
true
Controls whether lightning can cause harm.
monster-animal-damage
false
Controls whether monsters can deal damage to animals.
monster-player-damage
true
Controls whether monsters can deal damage to players.
monster-spawn
true
Controls whether monsters, such as creepers and skeletons, can spawn.
piston-item-spawn
true
Controls whether mycelium can spread.
piston-use
false
Controls whether pistons can be used.
player-block-break
false
Controls whether players can break blocks.
player-block-interact
false
Controls whether players can interact with blocks. Note: This does not include inventory blocks such as chests.
player-block-place
false
Controls whether players can place blocks.
player-damage
true
Controls whether players can be damaged.
player-enderpearl-interact
true
Controls whether players can use an enderpearl.
player-endportal-use
true
Controls whether players can use end portal.
player-entity-interact
true
Controls whether players can interact with entities. Note: This does not include chest access with entities such as horses.
player-enter
true
Controls whether a player can enter this claim.
player-exit
true
Controls whether a player can exit this claim.
player-item-drop
true
Controls whether players can drop items.
player-item-pickup
true
Controls whether players can pickup items.
player-itemframe-interact
false
Controls whether players can interact with item frames.
player-itemhanging-place
false
Controls whether players can place hanging items such as itemframes.
player-netherportal-use
true
Controls whether players can use nether portal.
player-teleport-from
true
Controls whether players can teleport from this claim.
player-teleport-to
true
Controls whether players can teleport to this claim.
player-villager-damage
false
Controls whether players can deal damage to villagers.
ravager-block-break
true
Controls whether ravagers can break blocks during raids.
silverfish-block-infest
false
Controls whether silverfish can infest blocks such as cobblestone.
tnt-block-explosion
false
Controls whether tnt can explode blocks.
tnt-entity-explosion
false
Controls whether tnt can explode entities.
turtle-egg-hatch
true
Controls whether turtle eggs can hatch.
villager-farm
true
Controls whether villages can farm crops.
wither-block-break
false
Controls whether withers can break blocks.
wither-entity-damage
true
Controls whether withers can damage entities.

USER

User flags will ONLY affect the claim you are in.
If you want to modify USER flag definitions in a claim that you do not own, you must have ignoreclaims permissions and enter /ignoreclaims before executing /cf command.
As a user, if you enter the /cf command, you will see the following
User GUI
Flag Definition
Default Value
Description
block-fertilize
false
Controls whether a player can fertilize a block with bonemeal.
chest-access
false
Controls whether a player can access chest inventories.
crop-growth
true
Controls whether crops can grow.
damage-animals
false
Controls whether animals can be damaged.
enderman-grief
false
Controls whether enderman can grief.
fire-spread
false
Controls whether fire can spread.
grass-growth
true
Controls whether grass can grow.
ice-form
true
Controls whether ice can form.
ice-melt
true
Controls whether ice can melt.
lava-flow
false
Controls whether lava can flow.
leaf-decay
true
Controls whether leaves can decay.
lighter
false
Controls whether a player can use flint and steel.
mushroom-growth
true
Controls whether mushrooms can grow.
mycelium-spread
true
Controls whether mycelium can spread.
painting-damage
false
Controls whether players can break paintings.
pvp
true
Controls whether PvP combat is allowed.
ride
false
Controls whether vehicles(including animals), not owned by the player, can be mounted.
sign-use
true
Controls whether players can use signs.
sleep
true
Controls whether players can sleep in beds
snow-fall
true
Controls whether snow can fall.
snow-melt
true
Controls whether snow can melt.
snowman-trail
true
Controls whether snowmen can create snow beneath them.
soil-dry
true
Controls whether soil will dry.
vehicle-use
false
Controls whether vehicles(boats, minecarts, etc.) can be placed, ridden and broken.
villager-trade
true
Controls whether players can trade with villagers.
vine-growth
true
Controls whether vines(and kelp) can grow.
water-flow
false
Controls whether water can flow.