Configuration Reference
config.yml
Main plugin configuration file located at plugins/LandClaimPlugin/config.yml.
General Settings
| Key | Type | Default | Description |
|---|---|---|---|
prefix | String | <dark_gray>[<gold>LandClaim<dark_gray>]</gold> | Chat prefix (MiniMessage format) |
language | String | en-US | Locale file to load from locales/ folder |
requireConnectedClaims | Boolean | false | Require new claims to touch existing claims |
allowDiagonalConnections | Boolean | true | Allow diagonal adjacency for connected claims |
cooldownUnstuck | Integer | 30 | Seconds cooldown for unstuck command |
Placeholder Brackets
For all messages and placeholders, the plugin supports both angle brackets <owner> and curly braces {owner} interchangeably.
Claim Limits
| Key | Type | Default | Description |
|---|---|---|---|
chunkClaimLimit | Integer | 5 | Default max chunks per player |
maxWarps | Integer | 3 | Default max warps per player |
Permission overrides: landclaim.limit.<n>, landclaim.warps.limit.<n>
Multi-Profile System
| Key | Type | Default | Description |
|---|---|---|---|
multiProfilesEnabled | Boolean | false | Enable multi-profile support |
maxProfilesPerPlayer | Integer | 2 | Max profiles a player can own |
WARNING
If you disable multiProfilesEnabled after players have already created multiple profiles, they will lose access to all secondary profiles. This setting should be treated as permanent once enabled.
Auto-Claim Defaults
| Key | Type | Default | Description |
|---|---|---|---|
autoClaimDefault | Boolean | false | Auto-claim enabled by default for new players |
autoUnclaimDefault | Boolean | false | Auto-unclaim enabled by default |
World & Command Blocking
| Key | Type | Default | Description |
|---|---|---|---|
blockWorld | List | [world_nether, world_the_end] | Worlds where claiming is disabled |
blockCmd | List | [setwarp, warp] | Commands blocked inside others' claims |
Protection Gaps
| Key | Type | Default | Description |
|---|---|---|---|
worldguardGap | Integer | 0 | Minimum chunks between claims and WorldGuard regions (0 = disabled) |
minClaimGap | Integer | 0 | Minimum chunks between different players' claims (0 = disabled) |
Database
| Key | Type | Default | Description |
|---|---|---|---|
database.type | String | SQLITE | Database backend: SQLITE or MYSQL |
database.host | String | localhost | MySQL host |
database.port | Integer | 3306 | MySQL port |
database.databaseName | String | landclaim | MySQL database name |
database.username | String | root | MySQL username |
database.password | String | password | MySQL password (or set LANDCLAIM_DB_PASSWORD env var) |
database.tablePrefix | String | lc_ | Prefix for all SQL tables |
database.maximumPoolSize | Integer | 10 | HikariCP max pool size |
database.minimumIdle | Integer | 2 | HikariCP min idle connections |
database.connectionTimeout | Long | 30000 | Connection timeout in ms |
Redis (Cross-Server Sync)
| Key | Type | Default | Description |
|---|---|---|---|
redis.enabled | Boolean | false | Enable Redis pub/sub sync |
redis.host | String | localhost | Redis host |
redis.port | Integer | 6379 | Redis port |
redis.password | String | "" | Redis password (empty = no auth) |
redis.channel | String | landclaim:sync | Pub/sub channel name |
Map Integrations
Each map plugin has identical configuration:
| Key | Type | Default | Description |
|---|---|---|---|
<map>.enabled | Boolean | true | Enable this map hook |
<map>.fillColor | String | 3366FF | Fill color (hex) |
<map>.fillOpacity | Double | 0.3 | Fill opacity (0.0-1.0) |
<map>.borderColor | String | 3366FF | Border color (hex) |
<map>.borderOpacity | Double | 0.8 | Border opacity (0.0-1.0) |
Supported maps: dynmap, bluemap, squaremap, pl3xmap
Visualization
| Key | Type | Default | Description |
|---|---|---|---|
actionbarUpdateInterval | Integer | 20 | Ticks between actionbar updates |
Permission Flags
Complete list of permission flags used across roles, trusted players, and visitor settings.
Block Interaction Flags
| Flag | Description |
|---|---|
USE_DOORS | Open/close doors |
USE_TRAPDOORS | Open/close trapdoors |
USE_FENCE_GATES | Open/close fence gates |
USE_CONTAINERS | Access chests, barrels, hoppers, etc. |
USE_WORKSTATIONS | Use crafting tables, anvils, enchanting tables, etc. |
USE_BEDS | Sleep in beds |
USE_REDSTONE | Use buttons, levers, pressure plates |
USE_LECTERNS | Read lecterns |
USE_BELLS | Ring bells |
Entity Interaction Flags
| Flag | Description |
|---|---|
DAMAGE_ANIMALS | Harm passive mobs |
DAMAGE_MONSTERS | Harm hostile mobs |
BREED_ANIMALS | Breed animals |
SHEAR_ENTITIES | Shear sheep |
TRADE_VILLAGERS | Trade with villagers |
FEED_ANIMALS | Feed animals |
LEASH_ENTITIES | Use leads on entities |
MODIFY_ARMOR_STANDS | Edit armor stands |
MODIFY_ITEM_FRAMES | Rotate/place items in frames |
Vehicle Flags
| Flag | Description |
|---|---|
RIDE_VEHICLES | Enter minecarts, boats, etc. |
PLACE_VEHICLES | Place vehicles |
DESTROY_VEHICLES | Break vehicles |
Misc Flags
| Flag | Description |
|---|---|
USE_ENDER_PEARLS | Throw ender pearls |
USE_CHORUS_FRUIT | Eat chorus fruit |
PICKUP_ITEMS | Pick up dropped items |
DROP_ITEMS | Drop items from inventory |
Administrative Flags
These flags grant control over the claim management systems.
| Flag | Description |
|---|---|
CLAIM_LAND | Allow members to claim new chunks for the owner's profile |
ADMIN_MENU | Allow members to open the /claim menu while standing in the claim |
MANAGE_SETTINGS | Access to claim settings (PvP, Color, Toggles) |
MANAGE_MEMBERS | Access to member management (Add/Remove/Trust) |
MANAGE_ROLES | Access to role management (Create/Edit/Delete) |
Owner-Only Restrictions
Even with ADMIN_MENU and management flags, the following actions are strictly owner-only for regular player claims:
- Abandoning/Deleting the entire profile or claim.
- Renaming the claim.
- Transferring Ownership.
Admin & Server Land
Administrators with the landclaim.admin permission have special bypasses for managing server-owned land.
- Admin Profile: A global, dedicated profile (UUID
00000000-0000-0000-0000-000000000000) is used for all Server Land. - Management Bypass: Any player with
landclaim.admincan manage the Admin Profile using/claim admin menu. - Full Control: Unlike regular members, admins bypass the "Owner-Only" restrictions when managing the Admin Profile, allowing them to Rename (e.g., to "Spawn") or Abandon server chunks.
- Command Bypass:
/claim admin claimallows instant claiming for the server profile, bypassing all connection and limit checks.
Default Roles
Every new ClaimProfile gets two built-in roles:
Member
Priority: 100 (lower priority than CoOwner) Flags: USE_DOORS, USE_TRAPDOORS, USE_FENCE_GATES, USE_CONTAINERS, USE_WORKSTATIONS, USE_BEDS, USE_REDSTONE
CoOwner
Priority: 10 (higher priority than Member) Flags: All 25 flags listed above
Menu Configuration
All GUI menus are fully configurable via YAML files in the plugins/LandClaimPlugin/menus/ directory. Each menu config lets you customize:
- Materials — Item types for buttons, fillers, and navigation
- Display Names — MiniMessage-formatted text for all items
- Lore — Item descriptions and instructions
- Layout — Slot positions and structure patterns
Available menu configs:
mainmenu.yml— Main claim management GUIprofile-selector.yml— Profile selector GUIClaimSettings.yml— Claim settings toggles- And many more for members, allies, warps, roles, etc.