WildClaiming - Claiming System for Paper and Folia

A sleek, modern, and GUI-driven land protection plugin designed to give players full control over their builds while keeping the server experience seamless and grief-free.

Whether you run a survival SMP or a competitive community server, WildClaiming bridges the gap between powerful administration and intuitive player management.

---

🚀 Key Features

• Visual Claim Boundaries: No more guessing where your land ends. WildClaiming uses customizable blocks (like Froglights) and vibrant particle effects to show exactly where a claim is located.

• Fully GUI-Driven Dashboard: Players can manage their entire claim through an elegant, multi-page inventory menu—no messy multi-line commands required for everyday settings.

• Granular Role System: Protect your assets by assigning distinct roles to your friends:

• Owner: Full control over the land, transfers, and deletion.

• Members (Trust): High-tier access (open containers, manage armor stands, etc.).

• Helpers (Add): Low-tier access (interact with doors/buttons, break/place blocks).

• Extensive Flag System: Toggle over 30+ unique toggles per claim, including PvP, Mob Spawning, TNT/Creeper Damage, Fluid Flow, Crop Trampling, Weather/Time locks, and entry restrictions!

• Playtime Block Rewards: Reward active players by giving them additional claim blocks automatically for every interval they spend online.

• Robust Database Integration: Support for both lightweight SQLite storage and high-performance MariaDB/MySQL networks.

• Admin Inactivity Cleanup: Easily track down abandoned or inactive claims through a dedicated admin GUI to keep your game world clean.

---

🛠️ Commands & Subcommands

WildClaiming features a highly organized, modular command system (/claim or aliases like /claims, /claiming, /wildclaiming).

Player Commands

• /claim – Opens the main menu or dashboard of the claim you are standing in.
• /claim create – Claims the area selected with your claim tool.
• /claim delete – Abandons the current claim and returns your blocks.
• /claim description <text> – Sets a custom description for your claim info menu.
• /claim expand <amount> – Expands the claim by a specified number of blocks in the direction you are facing.
• /claim give <player> – Triggers a secure, irreversible transfer of ownership to another player.
• /claim info – Displays detailed information about the current area (ID, owner, size, active members).
• /claim list – Opens a paginated GUI displaying all claims you own or have access to.
• /claim flags – Directly opens the flag configuration matrix for the claim.
• /claim show – Toggles the visibility of the claim borders and particle grids.
• /claim access – Opens a management screen for trusted players and helpers.
• /claim sendblocks <player> <amount> – Gifts some of your claim blocks to another player.

Moderation & Punish Subcommands

• /claim kick <player> – Kicks an unwanted intruder out of your claim boundary.
• /claim kickall – Forcibly removes all non-trusted players from your claim area.
• /claim ban <player> – Bans a player from stepping foot inside your claim.
• /claim banall – Blacklists all players currently not explicitly trusted.
• /claim unban <player> – Removes a player from your claim's ban list.
• /claim unbanall – Clears your claim's ban list completely.

Admin Commands (/claim admin <subcommand>)

• /claim admin bypass – Toggles Admin Bypass mode to modify or manage any claim on the server.
• /claim admin claimblocks <add/remove/set> <player> <amount> – Manages player claim block balances directly.
• /claim admin deleteall <player> – Deletes all claims belonging to a specific player.
• /claim admin findabandoned – Opens the dedicated GUI listing claims belonging to inactive players.
• /claim admin list <player> – Lists all claims registered to a specific player.
• /claim admin tp <id> – Teleports directly to the specified claim ID destination.
• /claim admin transfer <id> <player> – Forcibly transfers a specific claim ID to a new player.
• /claimadmin reload – Safely reloads all plugin configurations, flag defaults, database hooks, and translations.

---

🔒 Protect Anything (The Flag List)

Every claim owner can fine-tune their land dynamics using the intuitive flag matrix GUI. Available flags include:

• Environment: Fluid Flow, Fire Spread, Leaf Decay, Gravity, Ice/Snow Formation, Ice Melting.
• Interactions: Buttons & Levers, Pressure Plates, Doors & Gates, Armor Stands, Villager Trading, Lecterns.
• Combat & Spawning: PvP, Mob Spawning, Kill Animals, Kill Monsters, Kill Villagers.
• Cosmetics & Fun: Player Time Lock (Day/Night/Noon), Player Weather Lock, Biome Simulation (changes grass colors inside the claim), Custom Enter/Exit Titles & Actionbar messages.

---

🔑 Permissions Nodes

Player Permissions

Granted by default (default: true) unless explicitly revoked:

• claimsystem.command.* – Grants access to all base player subcommands.
• Individual nodes: create, delete, info, list, show, kick, kickall, ban, banall, unban, unbanall, expand, sendblocks, give, access.

Management & Protection Flags

Allows players to interact with specific flag configurations inside their claims (default: true):

• claimsystem.flag.* – Allows toggling all flags (Defaults to OP).
• Individual flag access nodes:
• claimsystem.flag.fluid_flow | claimsystem.flag.fire_spread | claimsystem.flag.tnt_damage
• claimsystem.flag.leaf_decay | claimsystem.flag.crop_trample | claimsystem.flag.block_smelt
• claimsystem.flag.coral_death | claimsystem.flag.crop_grow | claimsystem.flag.snow_form
• claimsystem.flag.ice_form | claimsystem.flag.pvp | claimsystem.flag.mob_spawning
• claimsystem.flag.block_homes | claimsystem.flag.player_no_enter | claimsystem.flag.teleportation
• claimsystem.flag.player_time | claimsystem.flag.player_weather
• claimsystem.flag.enter_actionbar | claimsystem.flag.exit_actionbar

Administrator Permissions

• claimsystem.admin.bypass – Grants Admin Bypass mode to override protection boundaries everywhere.
• claimsystem.admin.manage – Allows administrators to view, modify, and delete foreign claims via administration GUIs.

---

🧩 PlaceholderAPI Support

WildClaiming offers native integration with PlaceholderAPI to easily display claim data across scoreboards, chat formatters, or tab lists.

Placeholder	Description	Output Example
%claimsystem_claimblocks%	Displays the player's remaining usable claim blocks.	1450
%claimsystem_owner%	Displays the name of the claim owner at the player's location.	JustGino / Unclaimed