Claims are rectangular regions owned by players that have been protected from grief by others. Claims cost Claim Blocks to create and extend the full height of the world.

Creating Claims

Creating a claim requires the claim tool, which is a Golden Shovel by default. To create a claim, simply right-click a block to mark down a corner for a claim selection, then right-click a second block to mark down the opposite corner. A claim will be created over the rectangular region between the two corner points.

Creating a claim by right-clicking two corner points

A claim can alternatively be created by using the /claim (radius) command, which will create a claim with a radius of (radius) blocks around the player's current location. Claims have a minimum size and area, configurable in the plugin config.

Inspecting Claims

Inspecting claims is done with the inspection tool, which is a Stick by default. Simply right-click the stick at a block to inspect whether it has been claimed. Different types of claims will be highlighted with different glowing block displays (Paper 1.19.4+)/ghost blocks (Spigot 1.19.4 and below).

Inspecting claims with the claim inspection tool

Holding the Sneak key while right-clicking will inspect all nearby claims, highlighting all claims within a configurable radius of the block you right-clicked.

Viewing nearby claims

On Minecraft 1.19.4+ Paper servers with the block_displays setting enabled, claim inspection will use block display entities to highlight claims offering glowing blocks for more visibility. On older servers, or with the block_displays setting disabled (if you prefer!), "ghost blocks" will be used instead.

Comparison of different claim highlighters

Listing Claims

You can view a list of your claims using the /claimslist command, which is navigable through the interactive clickable chat buttons. The claim list is global across servers running HuskClaims in cross-server mode.

Viewing a list of your claims

Admins can view a list of admin claims using the /adminclaimslist command, and view a specific user's claims through /claimslist (username). Additionally, if the HuskHomes hook is enabled, admins with access to /huskclaims teleport can click on the coordinates displayed in the claim list to quickly teleport to that claim.

Resizing & Deleting Claims

To resize a claim, hold the claim tool and right-click the corner of the claim you wish to resize. Then, right-click the new corner point to resize the claim.

Claim owners may delete their claims by using the /unclaim command. This will refund the player the claim blocks that were used to create the claim. If you are standing in a parent claim which has children, those will also be deleted; you will be prompted to confirm if this is the case. The /unclaimall command may also be used to perform a bulk-delete action, removing all claims owned by the player.

Operations in Claims

Operations in claims are restricted to those with Trust in a claim (except admin claims—see below), with different Trust levels allowing users to perform different operations.

Separate from the claims/operations system, tamed animals may be protected from harm through the Pets system.

Natural Operations

Within claims, natural events—such as crop growth and mob spawning—may occur, depending on the default flags set by the server administrator (see the default_flags, admin_flags, and wilderness_flags sections in config.yml). However, you may use Operation Groups to toggle certain behaviours; by default, the /claimexplosions (on|off) command allows claim managers and owners to toggle whether explosion damage should be allowed in a claim.

Ignoring Claims

Using the /ignoreclaims (on|off) command, it is possible for administrators to toggle whether they wish to ignore claim operation restrictions; while ignoring claims, administrators will be able to perform any operation in any claim, regardless of their trust level within it.

Child Claims

Child claims (also known as "subdivisions") are essentially claims-within-a-claim. This is very useful for town projects, where you may want to limit which area of a claim a player can build in. Child claims are created by first using the /childclaim command to toggle child claim creation mode, then right-clicking two corner points within a parent claim to create the child claim. The /childclaim (radius) command also works provided you are standing within a parent claim and the radius is small enough to fit within it. Creating and managing child claims requires the MANAGE_CHILD_CLAIMS privilege in the parent claim.

By default, child claims inherit the parent claim's Trust access list, meaning users trusted in the parent claim will also have access to the child claim—but not vice versa. The owner may restrict access inheritance with the /restrictclaim (on|off) toggle command.

Admin Claims

Admin claims are special claims that are not owned by any player, and are not subject to the same restrictions as normal claims. Admin claims can be created by first using the /adminclaim command to toggle admin claim creation mode, then right-clicking two corner points to create the claim. The /adminclaim (radius) command also works if you prefer radial claim creation.

Unlike regular claims, all administrators with the huskclaims.admin_claim permission have full management privileges in every admin claim, allowing them to trust themselves and create child claims without being explicitly trusted.

Claim Bans

If you have claim bans enabled (see the bans subsection under claims in the config), you can ban and unban players from your claim using the /claimban <ban|unban|list> [username] command.

This will prevent the banned player from entering the claim/child claim. Banned players cannot be trusted in the claim, and will be unable to interact with blocks within the claim.