Configuration
Where ExyliaCapture's files are, what you can change in game, and every key of config.yml with its default.
Most of what you need is a button, not a file: run /captureadmin, click Settings and change the language, timezone, zone outline, leaderboard and Discord announcements in game. Open this page when you want a file's location or every key and default.
Where the files are#
The files live in plugins/ExyliaCapture/ and are written on the first boot with their defaults and a comment on every key. config.yml and database.yml sit at the top; everything a player reads (messages, sidebars, menus) lives in a language folder under lang/:
plugins/ExyliaCapture/
├── config.yml
├── database.yml
└── lang/
└── <code>/
├── messages.yml
├── scoreboards.yml
└── menus/The settings of each event (zones, times, rewards, schedules) are not in a file: they are stored in the database and edited from /captureadmin. See Event types.
After editing a file, run /captureadmin reload. It re-reads the files, the event configurations and the menus, and restarts the scheduler. database.yml is read at startup only, so changing the engine needs a restart. See Commands.
Change it in game#
Run /captureadmin and click Settings. Four pages cover the keys owners touch most:
| Page | What you can change |
|---|---|
| General | Language and Timezone. |
| Zone outline | Outline (on or off) and View range. |
| Leaderboard | Rows and Player heads. |
| Discord | Announcements (on or off) and Server name. |
A change is written to config.yml. Everything else on this page (outline particle and speed, leaderboard icons, the webhook URL, where events are shared) is only in the file. Times on the event, zone and Destroy The Core screens are typed as a length, such as 30s, 2m30s or 1h.
config.yml#
language#
language: defaultdefault follows the language set in ExyliaLib's config.yml. en, es, pt, fr, ru or tr set this plugin alone; each is a folder under lang/ you can edit. To translate or reword anything a player reads, edit the files in that folder. See Messages and languages.
A server that already ran the plugin before languages existed starts in custom: the first update moves its old messages.yml, scoreboards.yml and menus/ into lang/custom/ and sets language: custom, so nothing you edited is lost. A fresh install starts in default.
scheduler#
scheduler:
timezone: ""The clock that schedules are read against. Empty uses ExyliaLib's own timezone, which is where a network should set it once. Use an id such as America/New_York to give this plugin its own. An id that does not exist is logged as an error and ExyliaLib's timezone is used instead. See Schedule events.
particles#
particles:
enabled: true
interval-ticks: 40
particle: WAX_ON
view-distance: 48.0The outline drawn around a running event's zones. See Zones.
leaderboard#
leaderboard:
top-limit: 50
use-player-heads: truetop-limit is how many rows a leaderboard holds (1 to 500); use-player-heads draws each row as that player's head. The icons of the top three and of the filters are in the same block. See Statistics.
webhooks#
webhooks:
enabled: false
url: ""
server-name: ""Event starts and results posted to a Discord channel. The URL is a secret, so it is only editable in the file. See Discord webhooks.
events-scope#
events-scope: defaultWhich servers share the event configurations stored in the database. default follows the network group in ExyliaLib's config.yml (identical servers share; no group means one shared table), server gives each server its own, global shares with every server, and any other value is a group name. Read at startup.
event-visuals#
One entry per event type, keyed by its id (koth, koth_points_exclusive, koth_points_multi, koth_capture_points, conquest, payload, dtc, bounty), each with a hologram block: whether it shows, its size, offsets and view distance. What the hologram and the boss bar say is text and lives in messages.yml. A type added by an update writes its own entry on the next boot. See Customise boss bars, holograms and sidebars.
Every key of config.yml
| Key | Default | What it does |
|---|---|---|
language | default | Language of menus, messages and sidebars. |
scheduler.timezone | empty | Timezone of schedules; empty follows ExyliaLib. |
particles.enabled | true | Draw the zone outline while an event runs. |
particles.interval-ticks | 40 | Ticks between outline frames (20 = one second). |
particles.particle | WAX_ON | Any Bukkit particle name. |
particles.view-distance | 48.0 | How far a player can be and still see it (8 to 256 blocks). |
event-visuals.<type>.hologram | per type | How each type's hologram is drawn. |
leaderboard.top-limit | 50 | Rows a leaderboard holds (1 to 500). |
leaderboard.use-player-heads | true | Draw each row as the player's head. |
leaderboard.rank-materials.first / second / third | GOLD_BLOCK / IRON_BLOCK / COPPER_BLOCK | Icons of the top three rows. |
leaderboard.rank-materials.default-player | PLAYER_HEAD | Other player rows when heads are off. |
leaderboard.rank-materials.default-clan | SHIELD | Other clan rows. |
leaderboard.filter-materials.active / inactive | LIME_CONCRETE / RED_CONCRETE | Chosen and unchosen event filter. |
webhooks.enabled | false | Post starts and results to Discord. |
webhooks.url | empty | The webhook URL. Keep it private. |
webhooks.server-name | empty | Fills %server% in the messages, such as the footer. |
events-scope | default | Which servers share event configurations. |
messages.yml#
lang/<code>/messages.yml holds every text the plugin sends, from the event messages to the leaderboard screens, the boss bars and the hologram lines, plus the Discord messages. Colours work as in the rest of Exylia: see Colours. prefix fills %prefix% in every other message.
Sections of messages.yml
| Section | Contains |
|---|---|
prefix | What fills %prefix% everywhere else. |
events | Start, end, winner and timeout messages shared by every type. |
koth-capture-points, conquest, payload, dtc, bounty | Messages specific to that type. |
admin | Panel and command responses. |
leaderboard | Leaderboard screens. |
tabs | The tab strip inside the menus. |
event-list | The /capture list. |
reward-preview | How rewards are described to players. |
placeholders | The fallback words: none, unknown, not applicable, dash. |
holograms | What a hologram shows before an event has a value. |
event-types | Each type's name, three description lines and category tag. |
rewards | claimed, sent on the join that hands over waiting rewards, with %amount%. |
boss-bars | Each type's boss bar (text, colour, overlay), keyed by type id. |
hologram-lines | What each type's hologram says, keyed by type id. |
setup | What an operator reads while setting an event up: chat prompts, editor titles, selection steps. |
webhooks | The Discord messages. |
scoreboards.yml#
lang/<code>/scoreboards.yml has three sections: one sidebar per event type for a single running event, the compact lines each event adds when several run, and the shared multi-event sidebar. See Customise boss bars, holograms and sidebars.
database.yml#
The engine and its credentials. See Installation and Database.
menus/#
Menus are YAML under lang/<code>/menus/: admin/ for the /captureadmin screens and user/ for the event list, the player and clan leaderboards and the event filter. You can change icons, slots, titles, lore and sounds; the action keys on each button tie it to what it does, so keep them. menus/admin/ is rewritten from the jar on every start, so edit menus/user/ only. See Edit menus.
Migrations#
config.yml is at version 5 and scoreboards.yml at version 2. An older file is migrated on the first boot after updating and every value you set is carried across.
What each version changed
- Version 4 to 5: each type's boss bar and hologram lines moved from
config.ymltomessages.yml(boss-bars.<type>,hologram-lines.<type>), keeping your text. How the hologram is drawn stays inevent-visuals. - Version 3 to 4:
language: customis added, pointing the server at the files it already had. - Version 2 to 3: the per-type blocks moved under
event-visuals, keyed by type id.koth-capture-pointsbecamekoth_capture_points, andkoth-pointswas split intokoth_points_exclusiveandkoth_points_multi, both starting from what it said. - Version 1: the old internal section is dropped and the boss bar
colorandstyleare renamedcolourandoverlay. scoreboards.yml1 to 2:scoreboardsandcompact-linesare rekeyed the same way.
A key no file declares is deleted on load and reported once as UNKNOWN_KEY. That keeps the files clean across updates, and it is why adding your own keys does not work.
Something missing on this page? Tell us on Discord