Plugins / ClaimsForge

Admin Guide

Admin Guide

Reference for server administrators managing ChunkClaim.

Admin Commands

Safety net: /claim admin unclaim routes through the same ConfirmGui as the player-facing /unclaim — a green-wool confirm and a red-wool cancel. Staff get the same misclick protection as players.

Note: All admin commands require chunkclaim.admin permission.

Bypass Permission

Staff with chunkclaim.bypass can build, interact, and open containers in any claim regardless of trust:

/lp user AdminName permission set chunkclaim.bypass true

Use this for: - Helping players with locked chests - Investigating grief reports - Building on behalf of players

Managing Claim Limits

ChunkClaim uses permission nodes to control how many chunks a player can claim. The highest granted node wins.

# Set default (all players)
/lp group default permission set chunkclaim.limit.5 true

# VIP tier
/lp group vip permission set chunkclaim.limit.15 true

# Premium tier
/lp group premium permission set chunkclaim.limit.30 true

# Give a specific player a custom limit
/lp user PlayerName permission set chunkclaim.limit.50 true

Handling Grief Reports

1. Teleport to the reported location
2. Run /claim admin info to see who owns the chunk and who has trust
3. If the chunk is unclaimed normal wilderness grief, handle via rollback
4. If the chunk is claimed check trust list for suspicious entries
5. Run /claim admin unclaim if the claim itself is the problem (e.g., grief claim blocking others)

Economy Configuration

claims:
  cost-per-claim: 100.0   # Set to 0 to make claiming free

Warning: Vault must be installed for economy costs to work. If Vault is absent and cost > 0, claiming will fail silently or fall back to free depending on the version.

Map Integration Setup

Dynmap

map:
  dynmap-enabled: true
  marker-color: "#3498db"

Claims appear as map markers on the Dynmap web interface. Players can hover to see the owner's name.

BlueMap

map:
  bluemap-enabled: true
  marker-color: "#e74c3c"

Claims appear as colored shape overlays on BlueMap.

Developer API

Other plugins can query claim data:

ChunkClaimApi api = Bukkit.getServicesManager()
    .getRegistration(ChunkClaimApi.class).getProvider();

// Check if a chunk is claimed
boolean claimed = api.isClaimed(chunk);

// Get the owner's UUID
Optional<UUID> owner = api.getOwner(chunk);

// Check if a player can perform an action
boolean canBuild     = api.canBuild(player, block);
boolean canInteract  = api.canInteract(player, block);
boolean canContainer = api.canOpenContainer(player, block);

See the Developer API page for full documentation.

Home | Commands & Permissions | Configuration