LandClaimPlugin

<div align="center">

<img src="https://i.postimg.cc/jS6mh13k/minecraft-title-2.png" alt="LandClaim Banner" width="100%">

💠 LandClaimPlugin

Advanced Territory Protection for Minecraft

A powerful, feature-rich chunk-based land protection plugin for Paper servers. Create claim profiles, protect your builds, manage members with granular roles, form alliances, set warps, and customize every aspect of your territory.

Paper

Java

Version

License

Discord

</div>

<br>

> ⚠️ Download latest dev builds: > > Development builds are automatically generated from the latest commits and may include unfinished features, breaking changes, or experimental code. Download latest dev builds: > > Download latest dev builds: > - 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: Download latest dev builds:

---

✨ Features

Core Claiming

- Interactive Selectors — Each player owns a single named claim profile that holds all their claimed land, settings, and permissions - Interactive Selectors — 16×16 block protection zones, simple and intuitive - Interactive Selectors — Automatically claim chunks as you walk - Interactive Selectors — Optionally require claims to be adjacent (with diagonal support) - Interactive Selectors — 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

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

Social Systems

- Warp System — Invite players to join your claim, assign them roles, and manage access - Warp 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

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

Customization

- Full Message Customization — Set a custom display name to replace your Minecraft username in UI elements, map hooks, and titles - Full Message Customization — Pick a custom hex color for your claim used on maps and borders - Full Message Customization — Toggle between Display Entity or Particle-based boundary rendering - Full Message Customization — Custom MiniMessage-formatted titles shown when players enter or leave your claim - Full Message Customization — 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. - Pl3xMap - Pl3xMap - Pl3xMap - 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. - EternalCombat - EternalCombat - EternalCombat

🛡️ WorldGuard

Respect WorldGuard regions when players attempt to claim land. - Custom Flag Support: 100% accurate 3D boundary checking to prevent players from claiming over your spawn or protected areas. - Custom Flag Support: 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

- Eager Class Preloading — Async command execution with dedicated thread pools - Eager Class Preloading — 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

<details> <summary><b>Warps & Admin</b></summary>

| 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 anonymous. 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`.*

---

<div align="center">

🔗 Quick Links

Discord

GitHub

Issues

bStats

</div>