# 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](/odailyquests/quests/rewards.md). 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](/odailyquests/quests/create-a-category.md) for more information.

<details>

<summary>Default total_rewards.yml file</summary>

```yaml
# ========================================================
# 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"
```

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ordwenplugins.gitbook.io/odailyquests/configuration/total-rewards-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.