ZoneKoth - Random Koth Plugin v1.0

ZoneKoth Wiki​

What is ZoneKoth?​

ZoneKoth is a professional Random KOTH plugin for Minecraft servers. It automatically creates King of the Hill events at safe random locations in configured worlds. The plugin supports schematic pasting, clan/town-based capturing, WorldGuard protection checks, GriefPrevention claim checks, arrow-based direction tracking, multilingual messages, and command-based rewards.

ZoneKoth is designed for PvP, Survival, BoxPvP, Towny, Clan, and semi-competitive servers.

---

Main Features​

• Random KOTH location system
• Safe location detection
• World border protection
• WorldEdit / FAWE schematic support
• Schematic rollback system
• TPS-friendly rollback queue
• Capture and contested logic
• Clan / town team detection
• UltimateClans support
• Towny support
• GriefPrevention support
• WorldGuard support
• PlaceholderAPI support
• Actionbar direction tracker
• Arrow-based direction display
• Distance meter system
• Bossbar progress display
• Automatic scheduled events
• Command-based reward system
• Turkish and English language support
• Per-player language selection
• Admin commands
• Reloadable configuration

---

Requirements​

Required:

• Paper, Purpur, or Leaf
• Minecraft 1.19.4 - 1.21.x
• Java 17+

Optional hooks:

• WorldEdit
• FastAsyncWorldEdit
• UltimateClans
• Towny
• GriefPrevention
• WorldGuard
• PlaceholderAPI

The plugin can run without optional hooks. If WorldEdit or FAWE is not installed, schematic support will be disabled but the KOTH system will continue working.

---

Installation​

1. Download ZoneKoth.jar.
2. Place it into your server’s plugins folder.
3. Restart the server.
4. Edit the generated configuration files.
5. Add your schematics into:

plugins/ZoneKoth/schematics/

1. Restart again or use:

/zonekoth reload

---

Configuration Files​

ZoneKoth generates the following files:

plugins/ZoneKoth/config.yml
plugins/ZoneKoth/rewards.yml
plugins/ZoneKoth/lang/tr.yml
plugins/ZoneKoth/lang/en.yml
plugins/ZoneKoth/data/player-languages.yml
plugins/ZoneKoth/schematics/

---

Language System​

ZoneKoth supports multiple languages.

Default language can be changed in config.yml:

settings:
language: "en"

Available languages:

tr
en

Players can change their own language:

/zonekoth lang tr
/zonekoth lang en

Player language preferences are saved in:

plugins/ZoneKoth/data/player-languages.yml

---

Random KOTH System​

ZoneKoth automatically searches for a safe random location in the configured world.

The plugin checks:

• Solid ground
• Enough space above the location
• No lava
• No water
• No void
• No protected claims
• No WorldGuard regions
• No Towny claims
• World border limits
• Minimum distance from spawn
• Maximum distance from spawn

Example:

random-location:
worlds:
- "world"
min-x: -5000
max-x: 5000
min-z: -5000
max-z: 5000
min-y: 60
max-y: 120
max-attempts: 60
border-margin: 32.0
avoid-water: true
avoid-lava: true
avoid-void: true
avoid-protected-areas: true
min-distance-from-spawn: 500
max-distance-from-spawn: 5000

---

World Border Protection​

ZoneKoth will not create a KOTH area outside the world border.

It also checks the capture radius and schematic safety radius to prevent the event area from passing the world border.

Example:

random-location:
border-margin: 32.0

schematic:
border-safety-radius: 32.0

---

Schematic Support​

ZoneKoth supports WorldEdit and FAWE schematics.

Schematic folder:

plugins/ZoneKoth/schematics/

Example configuration:

schematic:
enabled: true
folder: "schematics"
random: true
list:
- "koth_1.schem"
- "koth_2.schem"
paste-offset:
x: 0
y: 0
z: 0
rollback-after-end: true
rollback-blocks-per-tick: 750
rollback-apply-physics: false
snapshot-max-blocks: 120000

When a KOTH starts, the selected schematic is pasted at the random location. When the KOTH ends, the plugin can rollback the area.

The rollback system is TPS-friendly and processes blocks gradually instead of restoring everything in one tick.

For large schematics, lower this value:

rollback-blocks-per-tick: 300

---

Capture System​

Players must stand inside the KOTH capture area to capture it.

The system supports:

• Solo capturing
• Clan capturing
• Town capturing
• Contested state
• Progress decrease
• Capture completion
• Reward execution

Example states:

WAITING
ACTIVE
CAPTURING
CONTESTED
CAPTURED
ENDED

Example configuration:

koth:
name: "Random KOTH"
capture-radius: 8.0
capture-time-seconds: 180
event-duration-seconds: 900
progress-decay-per-second: 2
validate-forced-location: true

---

Arrow Direction Tracker​

ZoneKoth does not require players to hold a real compass item.

Instead, the plugin shows the KOTH direction and distance through the actionbar.

Example:

KOTH » ↗ 342m away | Direction: North-East

Available arrows:

↑ North
↗ North-East
→ East
↘ South-East
↓ South
↙ South-West
← West
↖ North-West

Example configuration:

compass:
enabled: true
type: "ACTIONBAR"
update-interval-seconds: 1
show-distance: true
show-direction: true
show-arrow: true
only-in-same-world: false

---

Bossbar​

ZoneKoth can display a bossbar for active events.

The bossbar shows:

• KOTH name
• Capture progress
• Capturing team
• Contested state

Example:

bossbar:
enabled: true
color: "YELLOW"
style: "SOLID"

---

Team Detection​

ZoneKoth can detect teams using UltimateClans, Towny, or solo fallback.

Example:

team-detection:
priority:
- "ULTIMATECLANS"
- "TOWNY"
- "SOLO"

If two players are in the same clan or town, they count as the same capturing team.

If enemies are inside the capture area at the same time, the KOTH becomes contested.

---

UltimateClans Support​

Features:

• Same clan members are counted as one team
• Different clans contest the KOTH
• Clan name can be used in reward commands
• Clan placeholders supported

Reward placeholders:

%clan%
%team%
%player%

---

Towny Support​

Features:

• Same town members can capture together
• Same nation members can optionally be friendly
• KOTH can avoid Towny claims
• Town names can be used in reward commands

Example:

towny:
enabled: true
avoid-town-claims: true
same-town-friendly: true
same-nation-friendly: true

---

GriefPrevention Support​

ZoneKoth can avoid GriefPrevention claims when choosing a random KOTH location.

Example:

griefprevention:
enabled: true
avoid-claims: true

---

WorldGuard Support​

ZoneKoth can avoid WorldGuard regions.

Example:

worldguard:
enabled: true
avoid-regions: true
ignored-regions:
- "koth_allowed_area"
create-region: false
region-flags:
pvp: "ALLOW"
build: "DENY"

---

Reward System​

Rewards are given only through console commands.

Example rewards.yml:

rewards:
enabled: true
commands:
- "eco give %player% 50000"
- "crate key give %player% koth 1"
- "broadcast &6KOTH &8» &e%player% &7captured &f%koth_name%&7!"

clan-commands:
- "clan points add %clan% 10"

town-commands:
- "townyadmin town %town% addbonusblocks 5"

Available placeholders:

%player%
%winner%
%team%
%clan%
%town%
%nation%
%world%
%x%
%y%
%z%
%koth_name%
%capture_time%

Rewards are executed only once per KOTH event.

---

Commands​

Main command:

/zonekoth

Commands:

/zonekoth start
/zonekoth start random
/zonekoth start <world> <x> <z>
/zonekoth forcestart <schematic>
/zonekoth stop
/zonekoth reload
/zonekoth info
/zonekoth tp
/zonekoth compass on
/zonekoth compass off
/zonekoth lang tr
/zonekoth lang en
/zonekoth debug
/zonekoth cleanup
/zonekoth rollback
/zonekoth help

---

Permissions​

zonekoth.admin
zonekoth.reload
zonekoth.start
zonekoth.stop
zonekoth.tp
zonekoth.compass
zonekoth.lang
zonekoth.debug

---

Automatic Scheduler​

ZoneKoth can start events automatically at configured times.

Example:

scheduler:
enabled: true
times:
- "15:00"
- "20:00"
- "23:00"
timezone: "Europe/Istanbul"
warning-times:
- 300
- 60
- 30
- 10

Example messages:

KOTH » Random KOTH will start in 5 minutes!
KOTH » KOTH has started! Follow the arrow in your actionbar.

---

PlaceholderAPI​

Available placeholders:

%zonekoth_active%
%zonekoth_name%
%zonekoth_world%
%zonekoth_x%
%zonekoth_y%
%zonekoth_z%
%zonekoth_distance%
%zonekoth_direction%
%zonekoth_arrow%
%zonekoth_capturer%
%zonekoth_progress%
%zonekoth_time_left%
%zonekoth_status%

---

Performance Notes​

ZoneKoth is designed to be performance-friendly.

Important systems:

• Capture checks run every second
• Actionbar tracker updates every second
• No constant every-tick player scanning
• Rollback is processed in small chunks
• World border and protection checks prevent unsafe pastes
• Tasks are cancelled safely on plugin shutdown
• Rewards cannot be duplicated

For large schematics, recommended settings:

schematic:
rollback-blocks-per-tick: 300
rollback-apply-physics: false
snapshot-max-blocks: 120000

---

Recommended Usage​

ZoneKoth is recommended for:

• Survival servers
• Towny servers
• Clan servers
• BoxPvP servers
• PvP servers
• Faction-style servers
• Event-based servers

It is especially useful for servers that want automatic world events without manually creating KOTH arenas.