Rewards Configuration

Rewards are configured in rewards. Each key is a reward module.

Example (all reward types)

rewards:
  money:
    amount: 250
    silent: false

  xp:
    levels: 2
    points: 150
    silent: false

  items:
    silent: false
    list:
      - material: DIAMOND
        amount: 3
        name: "<#7dd3ff>Quest Reward"
        lore:
          - "<#a7f3d0>Thanks for helping!"
        enchantments:
          - sharpness:3
        flags:
          - HIDE_ENCHANTS
        custom-model-data: 10
        unbreakable: false

  commands:
    silent: true
    list:
      - "say %player% completed a quest!"
      - "[SILENT]lp user %player% permission set questborn.reward true"

  effects:
    silent: false
    list:
      - "SPEED:1:120"
      - "NIGHT_VISION:0:300"

  attributes:
    silent: false
    list:
      - GENERIC_MAX_HEALTH: 2
      - GENERIC_ATTACK_DAMAGE: 1

Legacy example

Silent mode: most reward modules support silent: true to hide reward messages (if your language file has them).

Supported reward keys

  • money — gives money (Vault). Supports legacy format money: 100 or the map format shown below.

  • xp — gives experience (levels and/or points).

  • items — gives items from a list (optionally with name/lore/enchantments/flags/custom-model-data).

  • commands — runs console commands. Use %player% placeholder. Supports inline [SILENT] prefix.

  • effects — gives potion effects from a list: TYPE:amplifier:durationSeconds.

  • attributes — adds base attributes (keys are Bukkit Attribute enum names).

Last updated