GriefProtection999

Features

• Land Claiming — Players select two corners with a claim tool and turn the selection into a protected claim. Claims protect the full height of the world within the selected area.
• Claim Blocks — Every player starts with a configurable number of claim blocks. Claiming land spends blocks based on the area claimed, and unclaiming can refund a portion of them.
• Claim Economy — With Vault installed, players can buy additional claim blocks or sell blocks they no longer need. Prices for both are configurable, and the economy is entirely optional.
• Claim Limits — Servers can cap how many claims a player may own and how much land in total each player may protect. Individual ranks can be given higher limits through permissions, and selected players can be made unlimited.
• Claim Naming and Teleporting — Claims can be given names, appear with a stable identifier and number in the claim list, and can be visited instantly with a teleport command.
• Trust System — Claim owners can trust other players so they can build and interact. Trust can be managed for players who are offline, and a trust list shows everyone currently trusted.
• Fine-Grained Flags — Each claim has its own set of flags controlling combat, explosions, fire, mobs, building, block breaking and placing, containers, interactions, entities, liquids, farming, item handling, teleporting in, and custom messages.
• Entry and Exit Notifications — Claims can display a custom greeting and farewell. Messages can appear in chat, above the hotbar, as on-screen titles, and can play a sound.
• Boundary Visualization — Owners and visitors can see a particle outline of a claim for a configurable amount of time.
• Activity Log and Rollback — Recent changes inside a claim are recorded so owners and admins can review activity and undo recent grief.
• Resize Tool — Existing claims can be resized with a dedicated tool. Growth requires enough claim blocks and shrinking respects the configured refund percentage.
• Automatic Backups — Claim data, player data, and claim activity are saved to timestamped backup files on a configurable schedule, which can also be disabled.
• Admin Tools — Admins can bypass protection, force-remove claims, transfer ownership, inspect or edit any claim, manage trust on any claim, and list every claim on the server.

Commands

All commands can be used as /claim or /griefprotection or /gp.

• /claim — Gives you the claim tool. Left-click a block to set the first corner and right-click to set the second.
• /claim create — Creates a claim from your current selection. The claim must be within the allowed size range, must not overlap another claim, and must fit within your available blocks and limits.
• /claim resize — While standing inside your own claim, gives you a resize tool. Set two new corners and the claim updates automatically.
• /claim unclaim [refund] — Removes the claim you are standing in. Add refund to return claim blocks based on the configured refund percentage.
• /claim buy <amount> — Buys claim blocks at the configured price. Requires Vault.
• /claim sell <amount> — Sells claim blocks at the configured sell price. Requires Vault.
• /claim trust <player> — Trusts a player in the claim you are standing in. Works with offline players.
• /claim untrust <player> — Removes a player's trust from the claim you are standing in. Works with offline players.
• /claim trustlist — Lists every player trusted in the claim you are standing in.
• /claim name <name> — Names the claim you are standing in. Use clear to remove the name.
• /claim list — Lists all of your claims with their number, name, identifier, location, and size, plus your available claim blocks.
• /claim tp <number|name|id> — Teleports you to one of your claims. Use the number from your claim list, its name, or its identifier.
• /claim info — Shows details about the claim you are standing in, including its name, identifier, owner, size, trusted players, and every flag.
• /claim flag <flag> <value> — Changes a flag on the claim you are standing in. Booleans accept true or false; message flags accept any text or clear.
• /claim visualize — Shows a particle outline of the claim you are standing in for the configured duration.
• /claim logs [amount] — Shows recent recorded activity in the claim you are standing in.
• /claim rollback <minutes> — Restores blocks in the claim you are standing in to how they were before the recent changes made by other players.
• /claim admin — Shows the admin command list.
• /claim admin bypass — Toggles whether protection is ignored for you.
• /claim admin unclaim — Force-removes the claim you are standing in, even if you do not own it.
• /claim admin list — Lists every claim on the server with its owner and size.
• /claim admin info <name|id> — Shows full details for any claim.
• /claim admin delete <name|id> — Deletes any claim.
• /claim admin transfer <name|id> <player> — Transfers ownership of any claim to another player.
• /claim admin trust <name|id> <player> and /claim admin untrust <name|id> <player> — Manages trust on any claim.
• /claim admin flag <name|id> <flag> <value> — Changes a flag on any claim.
• /claim reload — Reloads the configuration and stored data. Admin only.
• /claim help — Shows the command list.

Claim Flags

Flags are set per claim with /claim flag <name> <value>. Boolean flags accept true or false, and the default for each flag is shown in parentheses.

Combat and disasters

• PVP (false) — Allows player-versus-player combat inside the claim.
• EXPLOSIONS (false) — Allows explosions to destroy blocks inside the claim.
• EXPLOSION_DAMAGE (false) — Allows explosions to harm players and entities inside the claim.
• LIGHTNING_DAMAGE (false) — Allows lightning to damage blocks and start fires inside the claim.
• FIRE_SPREAD (false) — Allows fire to spread, lava to ignite blocks, and flint and steel to be used by untrusted players.

Mobs and nature

• MOB_SPAWNING (false) — Allows hostile mobs to spawn naturally inside the claim.
• ANIMAL_SPAWNING (true) — Allows passive animals to spawn naturally inside the claim.
• HOSTILE_MOB_GRIEFING (false) — Allows hostile mobs such as creepers and endermen to alter blocks.
• LEAF_DECAY (true) — Allows leaves to decay naturally.
• CROP_TRAMPLE (false) — Allows players and mobs to trample farmland.
• CROP_GROWTH (true) — Allows crops and plants to grow.
• SNOW_ICE (true) — Allows snow and ice to form and melt.

Building

• BUILD (true) — Allows trusted players to build, break, and interact. The owner is always allowed.
• BLOCK_PLACE (false) — Allows untrusted players to place blocks.
• BLOCK_BREAK (false) — Allows untrusted players to break blocks.
• PISTON_MOVEMENT (false) — Allows pistons to push or pull blocks across claim borders.

Interaction

• INTERACT (false) — Allows untrusted players to use levers, buttons, doors, trapdoors, gates, and other interactive blocks.
• CONTAINER_ACCESS (false) — Allows untrusted players to open chests, barrels, furnaces, hoppers, shulker boxes, and similar containers.
• VEHICLE_PLACE (false) — Allows untrusted players to place boats and minecarts.
• BUCKET_USE (false) — Allows untrusted players to use buckets.
• LIQUID_FLOW (false) — Allows liquids to flow into the claim from outside.
• ENTITY_INTERACT (false) — Allows untrusted players to use item frames and armor stands, and to interact with animals and vehicles.
• ANIMAL_DAMAGE (false) — Allows untrusted players to harm animals and pets.
• VILLAGER_TRADE (false) — Allows untrusted players to trade with villagers.

Items and movement

• ITEM_PICKUP (true) — Allows items to be picked up inside the claim.
• ITEM_DROP (true) — Allows items to be dropped inside the claim.
• ENDER_PEARL_TELEPORT (false) — Allows untrusted players to enter the claim with an ender pearl.
• CHORUS_FRUIT_TELEPORT (false) — Allows untrusted players to enter the claim with a chorus fruit.

Messages

• ENTRY_MESSAGE (empty) — A custom message shown to players entering the claim. Supports color codes.
• EXIT_MESSAGE (empty) — A custom message shown to players leaving the claim. Supports color codes.

Configuration

All settings live in the configuration file and apply server-wide.

• starting-claim-blocks — How many claim blocks each player receives the first time they join. Default: 1000.
• price-per-block — The cost of one claim block when buying. Default: 1.0.
• sell-price-per-block — The money received per claim block when selling. Default: 0.5.
• refund-percentage — The share of blocks returned when unclaiming with a refund or when shrinking a claim, from 0.0 to 1.0. Default: 0.5.
• min-claim-size — The smallest allowed claim area in blocks. Default: 100.
• max-claim-size — The largest allowed claim area in blocks. Default: 10000.
• max-claims-per-player — The maximum number of claims one player may own, or 0 for unlimited. Default: 0.
• max-total-claim-area — The maximum combined area one player may protect, or 0 for unlimited. Default: 0.
• visualize-duration — How many seconds a boundary visualization lasts. Default: 30.
• visualize-interval — How often, in ticks, the boundary visualization is refreshed. Default: 10.
• backup-interval — How many seconds between automatic backups. Set it to 0 to disable backups entirely. Default: 3600.
• backup-path — Where timestamped backup files are stored. Default: plugins/GriefProtection999/backups.
• grid-cell-size — The size of the internal map cells used to find claims quickly. Lower values use more memory but speed up lookups on busy servers. Default: 16.
• audit-log-size — How many recent activity records are kept for the log and rollback commands. Default: 5000.
• audit-retention-minutes — How long activity records are kept, in minutes, or 0 to keep them until the size limit is reached. Default: 1440.
• entry-exit-messages — Whether entry and exit messages appear in chat. Default: true.
• entry-exit-action-bar — Whether entry and exit messages appear above the hotbar. Default: true.
• entry-exit-titles — Whether entry and exit messages appear as an on-screen title. Default: false.
• entry-exit-sound — Whether a sound plays when entering or leaving a claim. Default: true.

Permissions

• griefprotection999.admin — Access to bypass, claim management tools, and reload. Default: operators.
• griefprotection999.use — Claiming land and using the claim tool. Default: everyone.
• griefprotection999.buy — Buying claim blocks. Default: everyone.
• griefprotection999.sell — Selling claim blocks. Default: everyone.
• griefprotection999.trust — Managing trusted players. Default: everyone.
• griefprotection999.resize — Resizing claims. Default: everyone.
• griefprotection999.flag — Changing claim flags. Default: everyone.
• griefprotection999.visualize — Visualizing claim boundaries. Default: everyone.
• griefprotection999.teleport — Teleporting to your claims. Default: everyone.
• griefprotection999.rollback — Rolling back recent changes. Default: everyone.
• griefprotection999.limits.unlimited — Ignores claim count and area limits. Default: nobody.
• griefprotection999.maxclaims. — Optional per-rank override for the maximum number of claims.
• griefprotection999.maxarea. — Optional per-rank override for the maximum total claim area.

Changelog

The current release is version 1.0.4. See the changelog for the full history of additions and fixes.