Claims: Overview

The claim module is Mira's built-in land protection for Paper and Folia servers. It is intended as a drop-in replacement for GriefPrevention 16.18.x: the same basic concepts (golden shovel, trust levels, subdivisions, claim blocks, admin claims, wilderness rules), largely the same config keys, but built right into Mira instead of being a standalone island.

There is nothing extra to install: the claim module ships inside the Mira JAR and is on by default (enabled: true in plugins/Mira/modules/claim.yml). It uses Mira's economy, GUI, team and messaging systems directly. This means a server that already uses Mira for economy, teams or the web interface gets a claim system that fits in seamlessly, including team claims, team plots and (with CoreProtect installed) block history in the investigation tool.

What Does the Claim Module Do? #

• Claiming - protect land with the golden shovel via a two-click flow; new players automatically get a starter claim when placing their first chest.
• Protecting - blocks, containers, redstone, doors, animals, crops, fire, explosions, pistons and mob grief are filtered claim-aware.
• Sharing - five trust levels (Public/Access/Container/Build/Permission, implicit Manage for the owner) plus subdivisions with their own trust list.
• Growing - claim blocks accrue over playtime, can be bought/sold and limit a player's total area.
• Managing - admin claims, world claims, restore nature, claim transfer, block management, claim expiration for inactive players.
• Teams - subdivisions can be assigned to a team, teams buy plots in admin land, team ranks control build and management rights.

Most Important Permissions at a Glance #

All commands are individually permissioned, but are already sensibly preconfigured for the usual roles via a few collective permissions:

Every visible individual action additionally has its own node (e.g. mira.claim.claim.list, mira.claim.claim.trust, mira.claim.claim.admin.world), so individual functions can be specifically granted or revoked via LuckPerms without granting the entire collective permission at once.

Basic Concepts in Brief #

• Claim - a rectangular, world-bound area with a unique internal identifier. A claim is either a player claim (with an owner), an admin claim (no owner) or a subdivision (sub-area within another claim). Subdivisions can additionally be assigned to a team.
• Trust - a list of rights maintained per claim (NONE to MANAGE), resolved via explicit player entries, LuckPerms groups, public trust and inheritance from the parent subdivision. Details: the "Trust & Protection" page.
• Claim Blocks - each claim "costs" its area (width x length) in claim blocks; players accumulate blocks over playtime and can buy additional blocks. Details: the "Claims Basics" page.
• Golden Shovel Modes - the golden shovel has several modes (Basic, Subdivide, Admin, Restore Nature variants), switchable via /claim basic, /claim subdivide, /claim admin mode etc.
• Wilderness - land outside any claim follows global rules (Claims.WorldModes, fire, explosions, sky tree protection), not claim-specific trust resolution.
• Web Interface - via Mira's web interface (/cweb), players see their claims in the browser (category "Claims"): area, coordinates, trust list, claim block balance, and can also abandon claims there. Team claims appear under "Teams → Claims".
• Storage Format - claim data is stored server-side. Administrators can switch the storage format if needed with the admin command /claim admin migrate.

Further Topics #