⚠️ 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 — Manage your land using claim profiles. Depending on server configuration, players can own a single profile or utilize the Multi-Profile System to manage multiple independent bases and quickly switch between them via an interactive GUI.
• 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).
• Held Territory Map (Minimap) — Live 128×128 pixel radar map in hand/off-hand or Item Frames showing chunk boundaries, claim colors, and real-time player orientation.
• Interactive Selectors — Programmatically select online players via their heads for Trust, Member, and Ally management.
• Unstuck Command — A safe /claim unstuck feature that teleports trapped players to the nearest safe wilderness block.

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
• Trust System — Grant individual players per-player permission overrides
• Ban System — Hard-deny a player from entering or interacting with your claim. Banned players are physically pushed back at chunk boundaries and (if online at the moment of the ban) teleported outside. Survives server restarts.
• Warp System — Set named warps within your claims with custom icons and per-player limits
• Public Warps — Publish any of your warps to the server-wide public list. Other players can browse and teleport via /claim publicwarps.

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
• Combat Tag PvP Bypass — Actively combat-tagged players temporarily lose claim protection against attacks, preventing safe-zone abuse during fights
• Inactive Claim Auto-Decay — Automatically clean up claims from players inactive for a configurable period, with exemption options for VIPs and staff
• Vehicle Protection — Prevent unauthorized vehicle use and destruction
• Command Blocking — Block specific commands inside other players' claims
• Wilderness Protection — Opt-in wildernessProtection.enabled flag flips the default: players can only build/break inside claims, never in unclaimed chunks. Designed for clan/town-style servers.

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 combat exploitation and command abuse while in active combat. Automatically detects combat tagging:

• DeluxeCombat
• CombatLogX
• PvPManager
• EternalCombat
• Claim Protection Bypass: Actively combat-tagged players cannot flee into claims to hide from PvP fights — claim PvP protection temporarily drops for them until their tag expires (combatTag.combatTagBypass: true).
• Command Blocking: Prevents tagged players from teleporting or abandoning claims during combat.

🛡️ 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!

🎮 Bedrock / Geyser Support

Bedrock players get a tailored UI when Geyser 2.x is installed. No hard Geyser dependency — the plugin uses reflection to detect the form API and falls back to the Java-only chat prompts if Geyser is missing.

• CustomForm text input for anvil-based prompts (rename, color, role name)
• ModalForm confirmation for destructive actions (abandon, unclaim all, ban)
• Visualization automatically switches to particle mode for Bedrock clients

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

🧩 Addons

The plugin's public API (LandClaimAPI) and event bus (ClaimCreateEvent, ClaimDeleteEvent, PlayerEnterClaimEvent, PlayerLeaveClaimEvent) let you build standalone addons in a sibling Maven project. Soft-depend on LandClaimPlugin so the addon only loads when the parent is present.

Official Addons

Building Your Own

The API exposes:

• getClaimAt(...), getClaimsByOwner(UUID), getClaimByName(String), getClaimById(UUID)
• getAllClaimProfiles() — every loaded claim, for global iteration (tax, leaderboards, etc.)
• transferClaim(Player actor, UUID profileId, UUID newOwnerId) and unclaimAll(Player actor, UUID profileId) — programmatic ownership / claim management (the actor is either the new owner or has landclaim.admin)
• addBonusBlocks(UUID, int) and getBonusBlocks(UUID) — for paid-claim-block plugins
• isInCombat(Player) — hook for combat-taggers
• The full claim profile model — getOwnedChunks(), getRoles(), getTrustedPlayerFlags(), etc.

For addons that want to act on claim lifecycle, listen for org.ayosynk.landClaimPlugin.api.event.* events.

📥 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 26.2+ | Java 25+

💬 Commands

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

General Commands

Menu Shortcuts

Jump directly to specific GUI panels without navigating through the main menu.

Management Commands

menu_title: '&8Buy Land Claim Chunks'
open_command: claimshop
size: 27
items:
  buy_chunk:
    material: GOLD_BLOCK
    slot: 13
    display_name: '&e&lBuy 1 Extra Chunk'
    lore:
      - '&7Cost: &630x Gold Block'
      - '&7Your Chunks: &a%landclaim_chunks% &7/ &b%landclaim_limit%'
      - ''
      - '&a&lCLICK &fto purchase 1 claim chunk!'
    left_click_commands:
      - '[console] clear %player_name% gold_block 30'
      - '[console] claim admin add chunk %player_name% 1'
      - '[message] &aSuccessfully traded 30 Gold Blocks for 1 extra claim chunk!'
      - '[sound] ENTITY_PLAYER_LEVELUP 1 1'
      - '[refresh]'
    left_click_requirement:
      requirements:
        has_gold_blocks:
          type: has item
          material: GOLD_BLOCK
          amount: 30
      deny_commands:
        - '[message] &cYou need 30 Gold Blocks in your inventory to buy this!'
        - '[sound] BLOCK_ANVIL_LAND 1 1'