Main Configuration
Configure zKoth settings in config.yml
The config.yml file contains global settings for the zKoth plugin.
Debug Settings
# Displays more information in the console
enableDebug: false
# Enables time debugs for performance measurement
enableDebugTime: falsePerformance Settings
# Milliseconds between PlayerMoveEvent checks
# Higher values reduce server load but decrease responsiveness
playerMoveEventCooldown: 50
# Milliseconds between scheduler ticks
schedulerMillisecond: 1000Message Display Timing
Cooldown Messages
Seconds before KOTH start when messages are displayed:
displayMessageCooldown:
- 300 # 5 minutes
- 120 # 2 minutes
- 60 # 1 minute
- 30
- 10
- 5
- 4
- 3
- 2
- 1Capture Messages
Seconds remaining during capture when messages are displayed:
displayMessageKothCap:
- 300
- 120
- 60
- 30
- 10
- 5
- 4
- 3
- 2
- 1Default Values
Placeholder values when no data is available:
# Displayed when no player is capturing
noPlayer: 'X'
# Displayed when player has no faction/team
noFaction: 'X'
# Displayed when no KOTH is active
noKoth: 'X'Scoreboard Settings
# Radius (in blocks) for scoreboard display
# Players within this distance see the KOTH scoreboard
scoreboardRadius: 50Capture Permission
Optionally require permission to capture KOTHs:
# Require permission to capture a KOTH
enableCapturePermission: false
# Permission required (only if above is true)
capturePermission: "zkoth.capture"Spectators are always blocked from capturing, regardless of this setting.
Team Capture Transfer
teamCaptureTransfer:
# A teammate already inside the zone takes over the capture
# when the capturer leaves, dies or disconnects
enable: true
# Team IDs that never count as a real team
# (Wilderness, SafeZone and WarZone for Factions plugins)
ignoredTeamIds:
- "0"
- "-1"
- "-2"The timer is not reset during a transfer: the teammate continues the capture where it stopped. Without a team plugin, every player is their own team, so no transfer happens.
Chest Settings
# Seconds before loot chests are removed
removeChestSec: 120Default Player Result
Values for score placeholders when position doesn't exist:
defaultPlayerResult:
playerName: "X"
points: 0
teamName: "X"
teamId: "X"
teamLeader: "X"Complete Example
# Debug settings
enableDebug: false
enableDebugTime: false
# Performance
playerMoveEventCooldown: 50
schedulerMillisecond: 1000
# Cooldown message timings
displayMessageCooldown:
- 300
- 120
- 60
- 30
- 10
- 5
- 4
- 3
- 2
- 1
# Capture message timings
displayMessageKothCap:
- 60
- 30
- 10
- 5
- 4
- 3
- 2
- 1
# Default placeholders
noPlayer: 'None'
noFaction: 'No Team'
noKoth: 'No KOTH'
# Scoreboard
scoreboardRadius: 100
# Capture permission
enableCapturePermission: false
capturePermission: "zkoth.capture"
# Loot chest removal time
removeChestSec: 180
# Default score display
defaultPlayerResult:
playerName: "---"
points: 0
teamName: "---"
teamId: "---"
teamLeader: "---"