Rewards

Rewards

Rewards are bonuses players can claim when reaching certain levels in a job.

File Structure

• rewards/<job>_rewards.yml - Reward definitions
• gui/<job>_rewards_gui.yml - Reward GUI layout

Reward Properties

rewards:
  diamond_kit:                      # Unique reward ID
    name: "Diamond Mining Kit"
    description: "A starter kit"
    required-level: 10
    enabled: true
    repeatable: false
    cooldown-hours: 0
    permission: ""
    gui-slot: 0
    economy-reward: 1000
    commands:
      - "[console] give {player} diamond 5"
    items:
      - material: DIAMOND_PICKAXE
        amount: 1
        display-name: "<aqua>Miner's Pickaxe"
        enchantments:
          EFFICIENCY: 3
          UNBREAKING: 2

Reward Content Types

Economy Reward

economy-reward: 5000

Items

items:
  - material: DIAMOND
    amount: 10
  - nexo-id: "custom_pickaxe"
    amount: 1
  - itemsadder-id: "namespace:custom_item"
    amount: 1

Commands

commands:
  - "[console] give {player} diamond 5"
  - "[player] spawn"
  - "[message] <green>You claimed your reward!"

Repeatable Rewards

rewards:
  daily_bonus:
    name: "Daily Mining Bonus"
    required-level: 1
    repeatable: true
    cooldown-hours: 24
    economy-reward: 500

Commands

Command	Description
/jobs rewards open <job>	Open rewards GUI for a job
/jobs rewards claim <job> <reward_id>	Claim a specific reward
/jobs admin reset <player> [job]	Reset player data (includes rewards)