⚠️ DEVELOPMENT BUILDS

Development builds are automatically generated from the latest commits and may include unfinished features, breaking changes, or experimental code. These builds are not recommended for production use.

If you choose to run a dev build:

• Expect bugs, crashes, or incomplete functionality.
• Configs and data formats may change without notice.
• No guarantee of backward compatibility.

Use them only for testing, early access, or contributing feedback.
📦 Download latest dev builds: GitHub Releases

---

✨ Features

Core Claiming

• Claim Profiles — Each player owns a single named claim profile that holds all their claimed land, settings, and permissions
• Chunk-Based Claims — 16×16 block protection zones, simple and intuitive
• Auto-Claim — Automatically claim chunks as you walk
• Connected Claims — Optionally require claims to be adjacent (with diagonal support)
• Claim Map GUI — Interactive in-game map showing nearby claims and ownership
• Interactive Selectors — Programmatically select online players via their heads for Trust, Member, and Ally management

Permission System

• 4-Tier Priority Chain — Owner > Role > Trusted > Visitor — the first matching tier decides
• Custom Roles — Create and configure custom roles (e.g., Member, CoOwner) with granular flag-based permissions
• Trusted Players — Grant individual players specific permission overrides
• Visitor Settings — Configure what non-members can do in your claims
• 25+ Permission Flags — Doors, trapdoors, containers, workstations, animals, vehicles, redstone, and more

Social Systems

• Member System — Invite players to join your claim, assign them roles, and manage access
• Ally System — Form mutual alliances between claims with configurable inter-claim permissions
• Warp System — Set named warps within your claims with custom icons and per-player limits

Protection

• Block Protection — Prevent unauthorized breaking and placing
• Entity Protection — Protect animals, armor stands, and item frames
• Explosion Protection — Block TNT, creeper, and other explosion damage
• Interaction Protection — Control door, container, and workstation access
• Item Protection — Prevent unauthorized pickup and drop
• Piston Protection — Block pistons from pushing/pulling across claim borders
• PvP Protection — Disable PvP inside claims
• Vehicle Protection — Prevent unauthorized vehicle use and destruction
• Command Blocking — Block specific commands inside other players' claims

Customization

• Owner Alias — Set a custom display name to replace your Minecraft username in UI elements, map hooks, and titles
• Claim Colors — Pick a custom hex color for your claim used on maps and borders
• Visualization Modes — Toggle between Display Entity or Particle-based boundary rendering
• Entry/Exit Titles — Custom MiniMessage-formatted titles shown when players enter or leave your claim
• Rename Claims — Change your claim's display name at any time
• Full Message Customization — All plugin messages are configurable via Okaeri Configs

🔌 Supported Integrations

LandClaimPlugin seamlessly hooks into various popular server plugins to provide an interconnected experience out-of-the-box.

🗺️ Web Map Plugins

Visualize claims directly on your server's web map! Claims are drawn as colored polygons matching the claim's chosen color, complete with owner and size information.

• BlueMap
• Dynmap
• Squaremap
• Pl3xMap

⚔️ Combat Tagger Plugins

Prevent players from abusing claim commands (like teleporting or abandoning claims) while actively in combat. The plugin automatically detects when a player is combat-tagged.

• DeluxeCombat
• PvPManager
• EternalCombat

🛡️ WorldGuard

Respect WorldGuard regions when players attempt to claim land.

• Volumetric Intersection Check: 100% accurate 3D boundary checking to prevent players from claiming over your spawn or protected areas.
• Gap Enforcement: Configurable required distance between claims and WorldGuard regions.
• Custom Flag Support: Apply the custom allow-land-claims WorldGuard state flag to regions (e.g., Wilderness/Warzone) to explicitly allow players to claim land inside them, overriding the gap and intersection protections!

Technical

• Cloud Command Framework — Async command execution with dedicated thread pools
• Modular Architecture — Separate command groups, listeners, and managers
• Eager Class Preloading — Eliminates first-execution lag spikes for GUI classes

---

📥 Installation

1. Download the latest release and drop LandClaimPlugin.jar into your plugins/ folder.
2. Restart your server.
3. Configure plugins/LandClaimPlugin/config.yml to your liking.

Requirements: Paper 1.21.4+ | Java 21+

---

💬 Commands

All commands use /claim (alias: /c) as the base.

General Commands

Command	Description
/claim	Claim the chunk you're standing in
/claim create <name>	Create a new claim profile with the given name
/claim auto	Toggle auto-claim mode (claim chunks as you walk)
/claim menu	Open the main claim management GUI
/claim info	View info about the claim at your location
/claim visible	Toggle claim boundary visualization
/claim abandon	Delete your entire claim profile and all claimed chunks
/claim pvp <on/off> [time]	Toggle PvP globally in the claim, with an optional time duration in seconds
/unclaim	Unclaim the chunk you're standing in
/unclaim all	Unclaim all your chunks

Management Commands

Members

Command	Description
/claim member invite <player>	Invite a player to join your claim
/claim member kick <player>	Remove a member from your claim
/claim member list	List all members and their roles
/claim accept <name>	Accept a pending member invitation
/claim deny <name>	Deny a pending member invitation

Trust

Command	Description
/claim trust invite <player>	Send a trust invitation to a player
/claim trust accept	Accept a pending trust invitation
/claim trust deny	Deny a pending trust invitation
/claim trust remove <player>	Remove a trusted player
/claim trust list	List all trusted players and their flags

Allies

Command	Description
/claim ally invite <name>	Send an alliance request to another claim
/claim ally accept <name>	Accept an alliance request
/claim ally deny <name>	Deny an alliance request
/claim ally remove <name>	Remove an existing alliance

Warps & Admin

Command	Description
/claim setwarp <name>	Set a warp at your current location
/claim delwarp <name>	Delete a warp
/claim warp <name>	Teleport to a warp
/claim warps	Open the warp management GUI
/claim admin check	View detailed claim info (owner UUID, profile name)
/claim admin unclaim	Force-unclaim the chunk you're standing in
/claim admin edit <player>	Open any player's claim management GUI
/claim admin setalias <claim> <alias>	Set or reset an owner's custom alias
/claim admin trust list <owner>	List players trusted by this owner
/claim admin trust who <player>	List claims where this player is trusted

---

🔐 Permissions

Permission	Description	Default
landclaim.*	All LandClaim permissions	false
landclaim.claim	Basic claiming ability	✅ true
landclaim.auto	Use auto-claim mode	✅ true
landclaim.admin	Admin commands & bypass all protection	op
landclaim.limit.<n>	Override the chunk claim limit (e.g., landclaim.limit.50)	false
landclaim.list	List claims	✅ true
landclaim.warps.limit.<n>	Override the warps limit (e.g., landclaim.warps.limit.10)	false
landclaim.createrole.<n>	Override the max number of custom roles	false

---

📊 bStats

This plugin collects anonymous usage statistics via bStats. The data is publicly visible and helps us understand how the plugin is used across servers. No personal or identifiable information is collected.

To opt out, navigate to plugins/bStats/config.yml and set enabled to false.

---