Configuration

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

# Logger level: NORMAL or DEBUG
logger: NORMAL

# Language file
lang: "en_US.yml"

# Database (MySQL — recommended for larger servers)
database:
  enabled: false
  hostname: localhost
  port: 3306
  name: database_name
  username: root
  password: pass

# Redis (for cross-server caching)
redis:
  enabled: false
  hostname: localhost
  port: 6379
  password: ""
  database: 0

# Discord Webhook
discord-webhook:
  enabled: false
  url: ""

# Admin Web Dashboard
web-dashboard:
  enabled: false
  port: 8095

# Audit Logs
audit-logs:
  enabled: false
  retention-days: 30

# Update checker
update:
  check: true
  notifications: true

Each world can be configured individually with its own mode, border, chunk limits, mob stacker, and item stacker:

worlds:
  world:
    aliase: "Overworld"
    # Modes: SURVIVAL, SURVIVAL_REQUIRING_CLAIMS, DISABLED
    mode: SURVIVAL
    border:
      enabled: false
      center: 0,0
      size: 100_000
    # Chunk limits (blocks & entities per chunk)
    chunk-limits:
      enabled: true
      mode: EVERYWHERE
      blocks:
        HOPPER: 24
        SPAWNER: 6
        TNT: 20
        PISTON: 32
        # ... more blocks
      entities:
        VILLAGER: 8
        ARMOR_STAND: 12
        ITEM_FRAME: 20
        # ... more entities
    # Mob stacker
    mob-stacker:
      enabled: true
      excludeNamedEntities: true
      killOneByOne: false
      multiplyDrop: true
      maxStackAmount: 50
    # Item stacker
    item-stacker:
      enabled: true
      maxStackAmount: 512

claims:
  # Auto-purge inactive claims
  auto-purge:
    enabled: true
    checker: 1h
    time-without-login: 90d

  # Confirmation prompts
  confirmation:
    claim: false
    unclaim: false
    merge: false
    owner: true
  confirmation-delay: 30

  # Names & descriptions
  template-name: "claim-%n"
  max-length-name: 32
  allowed-regex-name: "^[a-zA-Z0-9]+$"
  max-length-description: 64
  blocked-words: ["word1", "word2"]

  # Invitations
  invitation-delay: 120

  # Chunks
  only-adjacent-chunks: false

  # Display
  protection-message: CHAT    # CHAT, ACTION_BAR, TITLE
  show-particles: true

  # Economy
  economy:
    enabled: true
    max-price: 1_000_000_000
    formatted-number: true

BossBar display per role when entering a claim:

bossbar:
  enabled: true
  visitor:
    color: WHITE
    overlay: PROGRESS
  member:
    color: GREEN
  moderator:
    color: PURPLE
  owner:
    color: BLUE

Custom sounds for 30+ events (claim, unclaim, teleport, enter, leave, ban, kick, merge, fly, etc.) are fully configurable.

Supports Dynmap, BlueMap, Pl3xMap, and squaremap with customizable styles:

dynmap:
  enabled: true
  show-labels: true
  styles:
    normal:
      line-weight: 2
      line-opacity: 0.8
      line-color: "00FF00"
      fill-opacity: 0.3
      fill-color: "00FF00"
      label-format: "%claim_name%"
    for-sale:
      line-color: "FFCC00"
      fill-color: "FFCC00"

Same structure applies for bluemap, pl3xmap, and squaremap sections.

Default player settings configured under players.default:

players:
  default:
    max-chunks: 1
    chunk-cost: 0.0
    cost-multiplier: 1.0
    max-members: 3
    max-roles: 3
    distance: 1
    delay: 5
    fly: 300            # fly duration in seconds
    auto-fly: true
    auto-purge-bypass: false

Override per-player with /scs player <name> set-<setting> <amount> or add-<setting>.