Total rewards file

All you need to know about the total rewards file.

This file lets you define rewards after a certain number of quests have been completed, either in total or by category.

Reward syntax is the same as for quests. The syntax and types are described here. However, you can add a message parameter, which will be sent to the player when the reward is given. Rewards are given automatically as soon as the milestone is reached. If the total number of quests is reset, the reward will be given to the player again.

The category names used to define reward levels must be exactly the same as those defined in the quest configuration. Please refer to this page for more information.

Default total_rewards.yml file

# ========================================================
# TOTAL REWARDS CONFIGURATION
# This configuration file defines rewards for players
# based on the total number of quests they have completed.
# It includes both global total rewards and category-specific
# total rewards.
# ========================================================
enabled: false # Set to true to enable total rewards functionality

# ========================================================
# GLOBAL TOTAL QUEST REWARDS
# Rewards granted when a player completes a total number
# of quests, regardless of category.
# ========================================================
global_total_rewards:
  50:
    reward_type: COMMAND
    message: "&aCongrats %player%! You have completed 50 quests and earned a reward!"
    commands:
      - "eco give %player% 1000"
  100:
    reward_type: COMMAND
    message: "&aCongrats %player%! You have completed 100 quests and earned a reward!"
    commands:
      - "eco give %player% 2500"
  200:
    reward_type: COMMAND
    message: "&aCongrats %player%! You have completed 200 quests and earned a reward!"
    commands:
      - "eco give %player% 5000"

# ========================================================
# CATEGORY-SPECIFIC TOTAL QUEST REWARDS
# Rewards granted when a player completes a total number
# of quests within a specific category.
# ========================================================
category_total_rewards:

  easy:
    10:
      reward_type: COMMAND
      message: "&aCongrats %player%! You have completed 10 quests in category easy and earned a reward!"
      commands:
        - "eco give %player% 500"
    50:
      reward_type: COMMAND
      message: "&aCongrats %player%! You have completed 50 quests in category easy and earned a reward!"
      commands:
        - "eco give %player% 1000"

  medium:
    10:
      reward_type: COMMAND
      message: "&aCongrats %player%! You have completed 10 quests in category medium and earned a reward!"
      commands:
        - "eco give %player% 1000"
    50:
      reward_type: COMMAND
      message: "&aCongrats %player%! You have completed 50 quests in category medium and earned a reward!"
      commands:
        - "eco give %player% 2000"

  hard:
    10:
      reward_type: COMMAND
      message: "&aCongrats %player%! You have completed 10 quests in category hard and earned a reward!"
      commands:
        - "eco give %player% 2000"
    50:
      reward_type: COMMAND
      message: "&aCongrats %player%! You have completed 50 quests in category hard and earned a reward!"
      commands:
        - "eco give %player% 4000"