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 messagesEconomy 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, actionbarBossBar 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.2Map 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)