# Daily Quests

Daily Quests is an optional feature that provides randomized quests every day for each player individually.

It's also used for the Battle Pass feature to reward players with battle pass XP.

Quests configuration files located in the /ExcellentQuests/quests/ directory.

Quests feature can be disabed in the config.yml -> Features -> Quests

You can create as many quests as you want!

# Battle Pass Mode

Battle Pass Mode makes daily quests only available during the Battle Pass seasons.

You can toggle it in the config.yml -> Quests -> BattlePassMode (disabled by default).

# Quests Amount

You can set different amount of daily quests for players based on their rank or permissions.

This can be achieved with the config.yml -> Quests -> AmountPerRank setting.

By default it's 3 daily quests for all players, 4 quests for players with the vip rank, and 5 quests for premium rank.

# Quest Configuration

Quest configuration is quite simple! See Quest Type for available quest types and objectives.

# Quest type.
Type: break_block

# Quest display name. Use %quest_name% placeholder to insert it in GUIs and messages.
Name: Deepslate Ores
# Quest description. Use %quest_description% placeholder to insert it in GUIs and messages.
Description:
- '<gray>Mine certain deepslate ores to get reward!</gray>'

# Quest icon.
# Available options: https://nightexpressdev.com/nightcore/configuration/item-formation/
Icon:
  Material: minecraft:deepslate_gold_ore
  Lore: []

# Quest objectives.
Objectives:
  # Possible amount of objectives to be picked from the List below.
  Amount:
    Min: 1
    Max: 3
  # List of objectives available for this quest.
  # - [MIN] and [MAX] values sets possible amount of objective a player will need to complete.
  # - [WEIGHT] defines a chance for the objective to be picked on quest generation.
  # - [UNIT WORTH] defines a worth of 1 unit from the objective's amount value. 
  #     This value used in the UnitBonus setting of rewards to make certain objectives more or less rewardable.
  #     For example, a UnitBonus of 1.0 for objective with UNIT WORTH = 2.0 and total amount of 10 will result in 10 * 2.0 * 1.0 = +20 bonus value.
  List:
    minecraft:deepslate_coal_ore: 15;30 30.0 1.0 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_iron_ore: 12;24 15.0 1.5 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_copper_ore: 12;24 15.0 1.5 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_gold_ore: 10;20 10.0 3.0 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_redstone_ore: 12;24 10.0 2.5 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_lapis_ore: 12;24 10.0 2.5 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_diamond_ore: 7;14 5.0 5.0 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]
    minecraft:deepslate_emerald_ore: 3;9 5.0 10.0 # [MIN];[MAX] [WEIGHT] [UNIT WORTH]

# Rewards for completing the quest.
Rewards:
  # Battle Pass XP reward.
  BattlePassXP:
    # Base XP reward value.
    Base: 5.0
    # Bonus XP value per quests's objective.
    # For example, a UnitBonus of 1.0 for a quest mining 200 stones will result in 1.0 * 200 = +200 XP bonus.
    # The [UNIT WORTH] objective parameter will also affect the bonus value.
    UnitBonus: 1.0
  # Custom rewards from the rewards.yml config file.
  # Set Custom: [] for no custom rewards.
  Custom:
  - gold_ingot
  - money_100

# Quest completion time (in seconds).
# Once a player accepted the quest, they'll have to finish it in this time. Otherwise a quest will fail.
CompletionTime: 21600