Skip to content

yigit-guven/Claim

Repository files navigation

Claim Logo Claim Claim Logo

Claim is a land management system for Minecraft designed for territory security and administration. It provides a robust protection system, a 3D management interface, and deep integration with Xaero's World Map.

Features

  • Territory Security: Prevents unauthorized block modifications (break/place), fluid manipulation (buckets), and crop trampling.
  • Access Control: Configurable permission modes (PRIVATE/PUBLIC) for block interactions such as chests, doors, and buttons.
  • Economy-Friendly Permits: Optional land permit requirement with configurable item, amount, and consumption behavior.
  • Utility Items: Craftable Claim Compass to open claim management quickly and Land Permit for progression-based claiming.
  • 3D Management Interface: Visual dashboard for managing claims, featuring real-time 3D projector previews with terrain elevation support.
  • Xaero's World Map Integration: Automatic claim overlays on the world map with custom color support and foreign territory highlighting.
  • Granular Trust System: Manage trusted players per-claim via a dedicated UI.
  • Administrative Control: Server-wide configuration for Operator (OP) bypass and administrative overrides.

Commands

Command Description
/claim Claims the area selected with the selection tool. Supports relative coordinates.
/claim list Opens the graphical management dashboard for your claims.
/claim help Shows in-game help for main subcommands.
/claim info Shows claim ID and owner for the claim you are standing in.
/claim setvisit Sets visit spawn for the current claim.
/claim visit <claimId> Visits a claim by its ID.
/claim trustall <player> Trust a player across all your claims.
/claim untrustall <player> Remove trust across all your claims.
/claim admin givepermit [player] [amount] Gives Land Permit items for setup/testing.
/claim admin givecompass [player] [amount] Gives Claim Compass items for setup/testing.

Configuration

Configuration settings are located in config/claim-common.toml:

  • selectionTool: The item ID used for area selection (Default: minecraft:wooden_shovel).
  • opBypass: Toggles whether server operators bypass claim protections (Default: true).
  • requireLandPermit: Require permits to create claims.
  • landPermitItem: Item ID used as permit (Default: claim:land_permit).
  • consumeLandPermitOnUse: Consume permit item(s) on successful claim creation.
  • visitOwnerOnly: Restrict claim visiting to claim owners.

Protection Logic

  • Modifications: Block breaking, placing, and fluid usage are restricted to the owner and trusted players.
  • Interactions:
    • PRIVATE: Restricted to owner and trusted players.
    • PUBLIC: Accessible to all players.

Technical Integration

  • Xaero's World Map: Fully compatible with high-performance claim overlays. Available on CurseForge and Modrinth.
  • Persistence: Claims are stored in world/data/claim/claims.json for easy backup and management.

© 2026 Yigit Guven. Licensed under GNU GPLv3.

About

A selection-based land management mod for Minecraft that lets players claim, secure, and customize their territories.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages