Configuration

General Settings

lang: en_US.yml

database: false
database-settings:
  hostname: localhost
  port: 3306
  database_name: test_server
  username: root
  password: pass

command-aliases:
  claim:
    - /territory
  unclaim:
    - /unterritory
  claims:
    - /territories

Set database to true and fill in database-settings to use MySQL/MariaDB instead of the default flat-file storage. The command-aliases section adds extra command names that map to the built-in commands.

Claim Settings

auto-purge: true
auto-purge-checking: 60
auto-purge-time-without-login: 14d

claims-worlds-mode:
  world: SURVIVAL
  world_nether: SURVIVAL
  world_the_end: SURVIVAL
  example_world: DISABLED
  example_only_claims: SURVIVAL_REQUIRING_CLAIMS

protection-message: ACTION_BAR

keep-chunks-loaded: false

max-length-claim-name: 16
max-length-claim-description: 50

claim-invitations-system: false
claim-invitation-expiration-delay: 120

claim-confirmation: false

claim-fly-disabled-on-damage: true
claim-fly-message-auto-fly: true

enter-leave-messages: true
enter-leave-title-messages: true
enter-leave-chat-messages: true

claims-visitors-off-visible: true

teleportation-delay-moving: false

map-type: SCOREBOARD

expulsion-location: {}

Available protection-message types: ACTION_BAR, TITLE, SUBTITLE, CHAT. Available map-type values: CHAT, SCOREBOARD.

BossBar

bossbar: true
bossbar-settings:
  color: YELLOW
  style: SOLID

Available colors: yellow, blue, green, pink, purple, red, white. Available styles: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20.

Permission Groups

Permission groups define limits per group. The admin and vip groups in the snippet below are activated through scs.group.<name>; default is the implicit fallback.

groups:
  admin:
    permission: scs.group.admin
    max-claims: 0
    max-radius-claims: 0
    teleportation-delay: 0
    max-members: 0
    claim-cost: 0
    claim-cost-multiplier: 0
    max-chunks-per-claim: 0
    claim-distance: 0
    max-chunks-total: 0
    chunk-cost: 0
    chunk-cost-multiplier: 0
  vip:
    permission: scs.group.vip
    max-claims: 15
    max-radius-claims: 2
    teleportation-delay: 0
    max-members: 5
    claim-cost: 50
    claim-cost-multiplier: 2
    max-chunks-per-claim: 10
    claim-distance: 0
    max-chunks-total: 50
    chunk-cost: 0
    chunk-cost-multiplier: 0
  default:
    max-claims: 1
    max-radius-claims: 1
    teleportation-delay: 5
    max-members: 2
    claim-cost: 100
    claim-cost-multiplier: 2
    max-chunks-per-claim: 4
    claim-distance: 0
    max-chunks-total: 20
    chunk-cost: 0
    chunk-cost-multiplier: 0

A value of 0 means "unlimited" (or "no delay/cost") depending on the field.

Per-Player Overrides

You can override the group limits for specific players in the players section:

players:
  Xyness:
    max-claims: 0
    max-radius-claims: 0
    teleportation-delay: 0
    max-members: 0
    claim-cost: 0
    claim-cost-multiplier: 0
    max-chunks-per-claim: 0
    claim-distance: 0
    max-chunks-total: 20
    chunk-cost: 0
    chunk-cost-multiplier: 0

Blocked Lists

The interact and item-usage settings (InteractBlocks, Items, Entities, SpecialBlocks) reference four lists in config.yml. Two extra lists let you exclude specific blocks from the build/destroy checks.

blocked-interact-blocks:
  - FURNACE
  - BLAST_FURNACE
  - ANVIL
  - DAMAGED_ANVIL
  - BREWING_STAND
  - CHISELED_BOOKSHELF
  - COMPOSTER
  - DISPENSER
  - DROPPER
  - ENCHANTING_TABLE
  - HOPPER
  - JUKEBOX
  - STONECUTTER
  - BARREL
  - BEACON
  - CRAFTING_TABLE
  - SHULKER_BOX
  - CHEST
  - ENDER_CHEST
  - TRAPPED_CHEST
  - DRAGON_EGG
  - RESPAWN_ANCHOR
  - CAULDRON
  - LAVA_CAULDRON
  - WATER_CAULDRON
  - WHITE_SHULKER_BOX
  - ORANGE_SHULKER_BOX
  - MAGENTA_SHULKER_BOX
  - LIGHT_BLUE_SHULKER_BOX
  - YELLOW_SHULKER_BOX
  - LIME_SHULKER_BOX
  - PINK_SHULKER_BOX
  - GRAY_SHULKER_BOX
  - LIGHT_GRAY_SHULKER_BOX
  - CYAN_SHULKER_BOX
  - PURPLE_SHULKER_BOX
  - BLUE_SHULKER_BOX
  - BROWN_SHULKER_BOX
  - GREEN_SHULKER_BOX
  - RED_SHULKER_BOX
  - BLACK_SHULKER_BOX
  - CRAFTER
  - WHITE_BED
  - ORANGE_BED
  - MAGENTA_BED
  - LIGHT_BLUE_BED
  - YELLOW_BED
  - LIME_BED
  - PINK_BED
  - GRAY_BED
  - LIGHT_GRAY_BED
  - CYAN_BED
  - PURPLE_BED
  - BLUE_BED
  - BROWN_BED
  - GREEN_BED
  - RED_BED
  - BLACK_BED
  - OAK_SIGN
  - SPRUCE_SIGN
  - BIRCH_SIGN
  - JUNGLE_SIGN
  - ACACIA_SIGN
  - CHERRY_SIGN
  - DARK_OAK_SIGN
  - MANGROVE_SIGN
  - BAMBOO_SIGN
  - CRIMSON_SIGN
  - WARPED_SIGN
  - OAK_HANGING_SIGN
  - SPRUCE_HANGING_SIGN
  - BIRCH_HANGING_SIGN
  - JUNGLE_HANGING_SIGN
  - ACACIA_HANGING_SIGN
  - CHERRY_HANGING_SIGN
  - DARK_OAK_HANGING_SIGN
  - MANGROVE_HANGING_SIGN
  - BAMBOO_HANGING_SIGN
  - CRIMSON_HANGING_SIGN
  - WARPED_HANGING_SIGN
  - OAK_WALL_SIGN
  - SPRUCE_WALL_SIGN
  - BIRCH_WALL_SIGN
  - ACACIA_WALL_SIGN
  - CHERRY_WALL_SIGN
  - JUNGLE_WALL_SIGN
  - DARK_OAK_WALL_SIGN
  - MANGROVE_WALL_SIGN
  - BAMBOO_WALL_SIGN
  - OAK_WALL_HANGING_SIGN
  - SPRUCE_WALL_HANGING_SIGN
  - BIRCH_WALL_HANGING_SIGN
  - ACACIA_WALL_HANGING_SIGN
  - CHERRY_WALL_HANGING_SIGN
  - JUNGLE_WALL_HANGING_SIGN
  - DARK_OAK_WALL_HANGING_SIGN
  - MANGROVE_WALL_HANGING_SIGN
  - CRIMSON_WALL_HANGING_SIGN
  - WARPED_WALL_HANGING_SIGN
  - BAMBOO_WALL_HANGING_SIGN
  - CRIMSON_WALL_SIGN
  - WARPED_WALL_SIGN
  - LOOM
  - SMOKER

blocked-items:
  - ENDER_PEARL
  - BOW
  - CROSSBOW
  - TRIDENT
  - FLINT_AND_STEEL
  - FIRE_CHARGE
  - BUCKET
  - WATER_BUCKET
  - LAVA_BUCKET
  - CHORUS_FRUIT
  - FIREWORK_ROCKET
  - FIREWORK_STAR
  - ENDER_EYE
  - FISHING_ROD
  - LEAD

blocked-entities:
  - VILLAGER
  - SHEEP
  - ITEM_FRAME
  - GLOW_ITEM_FRAME
  - ARMOR_STAND
  - PAINTING
  - BOAT
  - MINECART
  - HORSE
  - DONKEY
  - MULE
  - PIG
  - STRIDER
  - LLAMA

special-blocks:
  - SPAWNER

ignored-break-blocks:
  - BEDROCK

ignored-place-blocks:
  - BEDROCK