Events file
Every key an event can carry in events.yml, what it does, its default, and what the plugin does when one is written wrongly.
events.yml is the list of events the plugin can pick from. Each event is one block under events, and the key of the block is the event's id, which is what commands use. The file ships with eight working events covering all seven types. Add, edit and delete freely, this file is never touched by an upgrade.
One event
events:
cobble_rush:
enabled: true
weight: 10
type: MINING
display-name: "&b&lStone Rush"
action: "&fBreak the most stone"
duration: 10m
team-mode: INHERIT
targets:
default: 0
STONE: 1
COBBLESTONE: 1
rewards:
"1":
commands:
- "eco give %player% 10000"| Key | What it does | Default |
|---|---|---|
enabled | Whether the scheduler can pick this event and /event start can start it. | true |
weight | How often it comes up compared to the others. A share of the total, not a percentage. | 1 |
type | MINING, FARMING, LOGGING, FISHING, ENCHANTING, COMBAT or FARMPOINTS. | required |
display-name | Shown on the board and in every message. Colour codes work. | the id |
action | One short line telling players what to do. | empty |
duration | How long the event runs, written like 10m. | event-defaults.duration |
team-mode | FORCE always makes it a team event, NEVER keeps it solo, INHERIT follows config.yml. | INHERIT |
targets | What counts and how much each is worth. See below. | none |
settings | The optional settings for this type. See Event types. | the type's defaults |
rewards | What each place gets. See Rewards. | none |
targets
One line per block, crop, log, fish or mob, with the points it is worth. default is the value for anything not listed. The shipped mining events set default: 0 so only listed blocks score, and timber_run sets default: 1 so any unlisted log still scores one.
targets:
default: 0
COAL_ORE: 1
DIAMOND_ORE: 15
ANCIENT_DEBRIS: 25Names are Minecraft's own, in capitals with underscores. For a COMBAT event the names are mob names, or the single word HOSTILE with one value to cover every hostile mob. An ENCHANTING or FARMPOINTS event has no targets.
The same values are used in a team event, where every member's points are added into one island total.
What happens when something is wrong
The plugin reads the file at startup and on /event reload, and every problem is reported with the file, the event and the key named. Only the broken part is affected.
| Problem | What happens |
|---|---|
type missing or not one of the seven | That event is skipped, everything else loads |
| A block, mob, item or enchantment name the running version does not have | That event is skipped, with the name in the warning |
A MINING, FARMING, LOGGING or FISHING event with no targets and default: 0 | That event is skipped, since it could never score |
A COMBAT event with neither HOSTILE nor a mob list | That event is skipped |
weight below 1 | Corrected to 1 |
duration written wrongly | The default from config.yml is used |
team-mode not one of the three words | INHERIT is used |
A reward key that is not a place, a range or participation | That reward block is skipped |
| A reward block that gives nothing | That reward block is skipped |
A skipped event does not stop the plugin. If every event is skipped, the console says no usable events were found and nothing can start until the file is fixed.
Testing an event
/event list shows every event with its type and whether it is enabled. /event start <id> starts one now. /event start <id> team or solo overrides the team mode for that run, and force ends a running event first. See Commands.
While testing on your own, set event-defaults.min-participants to 0 in config.yml or nobody is paid. See Rewards.