Configuration

General Settings

The main configuration file is at /plugins/SimpleClaimSystem/config.yml:

# Language file (create custom YAML files for translations)
lang: en_US.yml

# Database (recommended for larger servers)
database: false
database-settings:
  hostname: localhost
  port: 3306
  database_name: test_server
  username: root
  password: pass

# Command aliases (e.g. /territory instead of /claim)
# Add unlimited aliases for any command

Language files use § for color codes (not &). RGB format: §x§F§4§9§E§0§B.

Claim Settings

# Auto-purge inactive claims
auto-purge: false
auto-purge-checking: 60          # check interval in minutes
auto-purge-time-without-login: 14d  # s/m/h/d/w/M/y

# World modes per world:
# SURVIVAL: standard — build anywhere
# SURVIVAL_REQUIRING_CLAIMS: building restricted to claims only
# DISABLED: claims unavailable in that world

# Protection message display
# Options: ACTION_BAR, TITLE, SUBTITLE, CHAT
protection-message: ACTION_BAR

# Keep claimed chunks loaded without players
keep-chunks-loaded: false

# Name & description limits
max-length-claim-name: 16
max-length-claim-description: 50

# Invitation system
claim-invitations-system: false
claim-invitation-expiration-delay: 60  # seconds

# Claim confirmation before creating
claim-confirmation: false

# Flight settings
claim-fly-disabled-on-damage: true
claim-fly-message-auto-fly: true

# Enter/Leave notifications
# Toggles for action bar, title/subtitle, and chat messages

Economy Settings

Economy integration is handled through Vault:

economy: true
max-sell-price: 1000000000

# Claim costs with optional multipliers
claim-cost: false
chunk-cost: false
claim-cost-multiplier: false
chunk-cost-multiplier: false
use-formatted-number: true   # "1M" instead of "1,000,000"

# Sale announcements: bossbar, chat, title, actionbar

BossBar Display

bossbar: true
bossbar-settings:
  color: YELLOW    # YELLOW, BLUE, GREEN, PINK, PURPLE, RED, WHITE
  style: SOLID     # SOLID, SEGMENTED_6/10/12/20

Placeholders: %owner%, %player%, %name%.

Permission Groups

Define groups with specific limits. Individual player settings override group settings:

groups:
  default:
    max-claims: 5
    max-radius-claims: 2
    teleportation-delay: 5
    max-members: 10
    claim-cost: 100
    claim-cost-multiplier: 1.5
    max-chunks-per-claim: 9
    claim-distance: 2
    max-chunks-total: 50
    chunk-cost: 50
    chunk-cost-multiplier: 1.2

Map Integration

Supports Dynmap, BlueMap, and Pl3xMap:

dynmap: true
dynmap-settings:
  claim-border-color: FFFFFF
  claim-fill-color: A5A5A5
  claim-hover-text: "%claim-name% - Owner: %owner%"

# Same structure for bluemap and pl3xmap sections

Colors use HTML hex format (RRGGBB).

Claim Protection Settings

30+ toggle-able settings per claim, configured per role (Members, Visitors, Natural):

Build, Destroy, Buttons, Items, InteractBlocks, Levers, Plates, Doors, Trapdoors, Fencegates, Tripwires, RepeatersComparators, Bells, Entities, Explosions, Liquids, Redstone, Frostwalker, Firespread, Teleportations, Damages, Pvp, Monsters, Weather, Fly, GuiTeleport, Portals, Enter, ItemsPickup, ItemsDrop, SpecialBlocks, Elytra, Windcharges

Each setting can be individually disabled in the config to prevent players from changing it.

Blocked Content

Configure restrictions for:

  • Blocked interact blocks: furnaces, anvils, brewing stands, chests, shulker boxes, beds, signs, crafting tables, etc.
  • Blocked items: ender pearls, bows, crossbows, tridents, fire starters, buckets, chorus fruit, fireworks, etc.
  • Blocked entities: villagers, sheep, item frames, armor stands, paintings, boats, minecarts, horses, llamas
  • Special blocks: indestructible blocks (e.g. spawners) even when destruction is enabled
  • Ignored break/place blocks: blocks that cannot be broken or placed (default: bedrock)