Event Catalog

CyberTokens uses the shared base Event Catalog through CyberEventEngine 0.1.1. This gives CTK event-based earning without the full advanced XEV surface used by XLV and XTK.

Canonical event list

For the full shared syntax, aliases, arguments, and base-versus-advanced split, start with the shared Event Catalog.

Where CTK uses events

CTK area	Why it matters
`events.yml`	Defines global rules that grant the single CTK currency
Event reward flow	Rolls `amount` when an enabled rule matches
Base CEV aliases	Accepts CLV-style aliases for supported base events

How CTK rewards matching events

Pattern	CTK behavior
Direct events like `KILL_MONSTER` or `BREAK_BLOCK`	Matching expressions roll `amount` once per valid occurrence.
Batched `NO_ARGS` events like `MOVE[60]`	CTK can batch hits and pay them according to the event interval.
`TIMED_EXP[count]`	CTK rolls the configured amount once every `count` seconds.
Base optional integrations	RivalHarvesterHoes, RivalPickaxes, AxHoes, and AxPickaxes block-break style events are available when their APIs are present.

Reward gating in CTK

apply.on-creative blocks or allows rewards while the player is in creative mode.
apply.permission adds a plugin-level permission gate before the reward is paid.
Expression filters such as TIMED_EXP[300]:PERMISSION=group.vip still work through the shared event engine.

CTK-oriented examples

KILL_MONSTER:TYPE_EXACT=ZOMBIE
BREAK_BLOCK:TYPE_EXACT=IRON_ORE
MOVE[60]
TIMED_EXP[300]:PERMISSION=cybertokens.events.timed
AX_PICKAXES_BLOCK_BREAK:AMOUNT=10-50

Next reading

Configure earning rules in events.yml.
Review balance, formatting, and storage behavior in Economy Overview.
Keep shared syntax changes aligned with the shared Event Catalog.