Main Info

The config.yml file controls all in-game zones, including their behavior, capture mechanics, rewards, and visual effects.

messages Section

messages:
  enter-zone: true
  exit-zone: true

• enter-zone — shows a message when a player enters the zone.

• exit-zone — shows a message when a player exits.

zones Section

Each zone is a separate block with a unique ID (e.g., farm, arena).

General Zone Parameters

Parameter	Description
name	Display name of the zone (supports color codes via &).
position-type	Geometry type: circle, cube, single-chunk, or multi-chunk.
use-teams	If true, the zone is linked to teams defined in teams.yml.
spawn-delay	Delay before the zone appears after server startup (in ticks; 20 = 1 second).

Positioning Types

1

circle — Circular Zone

position: "200,64,200"
horizontal-radius: 25
vertical-radius: 20

• position — center coordinates in "x,y,z" format.

• horizontal-radius — radius along the X/Z plane.

• vertical-radius — height above/below the center.

2

cube — Cubic Zone

position: "300,64,300"
horizontal-radius: 15
vertical-radius: 10

• A cube centered at position with dimensions 2×horizontal-radius on X/Z and 2×vertical-radius on Y.

3

single-chunk

• The zone covers a single chunk (16×256×16). Any block position inside the chunk can be used for position.

4

multi-chunk

chunk-list:
  - "-1,0"
  - "0,0"
perimeter-min-y: 0
perimeter-max-y: 256

• chunk-list — list of chunks in "x,z" format (chunk coordinates, not block coordinates).

• perimeter-min/max-y — vertical bounds for perimeter-type effects.

capture Section

capture:
  mode: ADD
  max-capture: 100
  add-interval: 20
  message-on-catch: "&6Captured!"

Parameter	Description
mode	ADD — players add capture points. multiplier — accelerates capture for the player's team.
max-capture	Maximum capture points (usually 100 = 100%).
add-interval	Interval between point additions (in ticks).
multiplier	Only used with mode: multiplier (e.g., 1.2 = +20% speed).
message-on-catch	Message shown upon full capture.

rewards Section

rewards:
  - "give %player% wheat 16"
reward-chances: false
reward-type: all

Parameter	Description
rewards	List of commands. Supports %player% placeholder.
reward-chances	If true, each reward must use format chance:30;give ....
reward-type	all — all participants, random — random participant, leader — capture leader.

despawn and respawn Sections

despawn:
  delay: 1200
  commands-on-despawn-zone:
    - "say Zone disappearing!"

respawn:
  delay: 300
  commands-on-spawn-zone:
    - "say Zone appeared!"

• delay — zone lifetime or respawn cooldown (in ticks).

• Commands execute on the respective events.

placeholders Section

placeholders:
  1:
    type: bossbar
    delay: 20
    timer: "&a%zone_name% | Remaining: %zonecapture_despawn_timer%"

Supported placeholders:

• %zone_name%

• %zonecapture_percent%

• %zonecapture_despawn_timer% — in seconds

• %capturezones_team_name% — name of the capturing team

teams Section

teams:
  - red
  - blue

Required if use-teams: true. Team names must match keys in teams.yml.

---

teams.yml File

teams:
  red:
    name: "Reds"
    permission: "team.red"
    color: "&c"
    particle-colors: "#FF0000"

Parameter	Description
name	Display name of the team.
permission	Permission required to join the team.
color	Chat prefix color (using & codes).
particle-colors	Particle color in HEX format (#RRGGBB or RRGGBB).