Reference

Configuration

config.yml key by key, the messages file and its sections, the admin menu files, and where items, trackers and arenas are configured.

Everything is generated in plugins/ExyliaSpecials/ on first start, with comments. Edit the files there and run /specialsadmin reload, or change config.yml and the messages in game from Settings in /specialsadmin (see Commands).

File	What it holds
`config.yml`	Language, action bar, states, duels. Below.
`lang/<language>/messages.yml`	Every line the plugin sends.
`lang/<language>/items/*.yml`	The items. See Special items.
`lang/<language>/trackers/*.yml`	The trackers. See Stat trackers.
`lang/<language>/menus/admin/*.yml`	The admin screens, rewritten from the jar on every start and reload.
`arenas.yml`	The duel arenas. See Duels.
`database.yml`	ExyliaLib's database connection.

config.yml

language: default
 
actionbar:
  enabled: true
 
states:
  clear-on-death: true
  flight-landing-grace: 4s
  reveal-on-attack: true
  undying-effects:
    - '[PARTICLE] TOTEM_OF_UNDYING;count:60;offset:0.6,1,0.6;speed:0.4;y:1'
    - '[RING_PULSE] END_ROD;radius:1.6;rings:2;spacing:0.4;points:18;y:0.1;ticks:4;interval:0.04'
    - '[SOUND] BLOCK_BEACON_POWER_SELECT;0.8;1.6'
 
duels:
  allowed-commands: [msg, tell, w, r, reply]
  broadcast-results: true
  copies:
    enabled: true
    max-per-arena: 16

Older versions also had combat and vanilla-cooldowns here. They moved to ExyliaCombat; on the first start a copy goes to exyliacombat-export.yml. See Combat.

language

Value
`default`	Follows the language in ExyliaLib's `config.yml`.
`en`, `es`, `fr`, `pt`, `ru`, `tr`	This plugin only.
anything else	A language of your own, started as a copy of English.

The language also picks the folder items and trackers are read from — see Installation.

actionbar

enabled (true). See Cooldowns.

states

See States.

duels

See Duels.

messages.yml

lang/<language>/messages.yml holds every line, grouped:

Section
`prefix`	`%prefix%` in every other line.
`actionbar`	The action bar's layout.
`items`	Refusals when using an item, used up, expired, the `ON`/`OFF` of `%status%`, and the `limit-` and `badge-` lines of `%limit%` and `%limit_badge%`.
`tools`	Crowbar, compressor, filter and prospector replies.
`stattrack`	Applying trackers, and the empty victim slot.
`delivery`	Items received, or waiting for the next join.
`states`	The bar of each state, the last stand celebration, flight ending, vanish broken.
`duels`	Challenges, refusals, countdown, boss bars, results, broadcasts and every arena editor line.
`admin`	Replies of every command and editor.

A line may start with [sound:NAME|volume|pitch] to play a sound. An empty line sends nothing. State bars and duel titles are ExyliaLib effects: a title, action bar, boss bar, sound and particle each. None ships a firework.

The admin menus

lang/<language>/menus/admin/ has the eight screens: root, items, tools, item, stattracks, cooldowns, arenas and arena. They are rewritten from the jar on every start and every reload: an edit does not survive.

Something missing on this page? Tell us on Discord