Getting started

Introduction

What ExyliaCapture is, the eight event types it ships, and how the docs are organised.

ExyliaCapture is a zone-capture event plugin. It is not one configurable KOTH: it registers eight event types, each with its own logic, and a server can run as many configured events at once as it likes — of different types, at the same time.

Everything is created from in-game menus: /captureadmin opens a panel where an event is created, given a zone with the shared selection wand, configured, given rewards and scheduled. No YAML is edited by hand, and the events themselves live in the database, not in a file.

The event types

KOTH

Hold the zone until the capture timer runs out. Can end the event or reset and run forever.

KOTH Points

Points every second while inside. Exclusive gives them to one holder; multi gives them to everyone in the zone.

KOTH Capture Points

Each completed capture is worth one point and frees the zone again. First to the target wins.

Conquest

Several zones at once, each worth its own points, disputed by clans. Needs a clan plugin.

Payload

Escort a minecart along a rail path. It advances, stalls when disputed and rolls back when left.

Destroy The Core

Break a core block for points. It regenerates on a timer and the race is to the target.

Bounty

No zone: one player is the target. Whoever kills them wins; if they survive the clock, they do.

Eight type identifiers, because KOTH Points registers twice: koth, koth_points_exclusive, koth_points_multi, koth_capture_points, conquest, payload, dtc and bounty.

Requirements

Requirement	Detail
Server	Paper 1.21 or newer. Folia supported.
Java	21
Required dependencies	`ExyliaLib`, `packetevents`
Optional dependencies	`PlaceholderAPI`, `ViaVersion`, a clan plugin, Apollo or Feather, `ExyliaStaff`

What ExyliaLib brings

Typed configuration with migrations, the database, the menus, the zone selection wand, holograms, boss bars, scoreboards, placeholders, rewards and the client integrations. Without it the plugin does not start.

What is stored where

Thing	Where
Event configurations, zones, settings, rewards, schedules	Database (`capture_event_configs`)
Player and clan statistics	Database, global and per event
Rewards owed to an offline player	Database (`capture_pending_rewards`)
Boss bars, holograms, particles, leaderboard look	`config.yml`
Sidebars	`scoreboards.yml`
Every message	`messages.yml`
Menu layouts	`menus/`

How to read this documentation

Getting started

Installation and a first event running from the panel.

Configuring

The eight types and their settings, zones, rewards and schedules.

Systems

Clan support, statistics and everything drawn on screen.

Reference

Commands, placeholders, configuration files, the API and the FAQ.

Something missing on this page? Tell us on Discord