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 ` — Buys claim blocks at the configured price. Requires Vault. * `/claim sell ` — Sells claim blocks at the configured sell price. Requires Vault. * `/claim trust ` — Trusts a player in the claim you are standing in. Works with offline players. * `/claim untrust ` — 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 ` — 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 ` — 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 ` — 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 ` — 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 ` — Shows full details for any claim. * `/claim admin delete ` — Deletes any claim. * `/claim admin transfer ` — Transfers ownership of any claim to another player. * `/claim admin trust ` and `/claim admin untrust ` — Manages trust on any claim. * `/claim admin flag ` — 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 `. 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.