BitAspire Wiki
XenoLevelsXenoLevels

exp-events.yml

Map gameplay events to EXP rewards.

exp-events.yml defines the gameplay triggers that award EXP for a XenoLevels system.

Section layout

exp-events:
  custom-section:
    enabled: true
    events:
      - 'KILL_MOB:NATURE=HOSTILE'
      - 'TIMED_EXP[300]:PERMISSION=group.vip'
    exp: '5, 10'
    partial-excessive: true
    apply:
      on-creative: false
      permission: ''
  • enabled toggles the section on or off.
  • events accepts one or more event expressions. Use the XLV Event Catalog for XLV behavior notes and the shared Event Catalog for the canonical syntax.
  • exp sets a single value or a min, max range for the EXP reward.
  • partial-excessive allows proportional leftovers on EXCESSIVE events such as SMELT, DROP_ITEM, or PICKUP_ITEM.
  • apply.on-creative decides whether creative-mode players can receive EXP.
  • apply.permission requires a permission node before XLV can pay the reward.

Practical examples

  • BREAK_BLOCK:TYPE_EXACT=WHEAT::AGE=7
  • TIMED_EXP[300]:PERMISSION=group.vip
  • RIVAL_HARVESTER_HOES_BLOCK_BREAK:CROP=WHEAT::AGE=7

Pro tip

Prefer canonical event names from the shared catalog, especially the explicit Rival block-break names. That keeps future migrations and documentation aligned.

Last updated on

On this page