Create a category

Since version 3.0, you have the option to create your own categories. This allows you to organize your quests in several ways, if you wish.

For example, by difficulty: easy, medium, hard... Or by profession: woodcutter, hunter, miner, builder... Or even by rank: player, vip, supervip...

The possibilities are endless!

Creating a category is very simple and can be done in just a few steps.

Summary

1. File creation

2. Category registration

3. Use in commands and placeholders

File creation

To create a category, you must create the file that will contain the quests. This file must be located in the ODailyQuests/quests/ folder, where the default files easy.yml, medium.yml, and hard.yml are already present.

The name of the file is very important, as it will determine the name of the category, and therefore the behavior of commands, placeholders, etc. For example, if your file is named woodcutter.yml, the name of the category will be woodcutter. If it is named my_super_category.yml, the name of the category will be my_super_category.

In order for the quests in your file to be read correctly, it is essential to include quests: on the first line. If you go back to the top of the default files, you will see that it is always there.

Once this line has been added, you can start writing your quests. It's as simple as that!

woodcutter.yml

quests:
  1:
    name: "&aWoodcutter"
    menu_item: OAK_LOG
    description:
      - "&bCut down 20 oak logs."
      - "&bReward: &c100$&b."
    quest_type: BREAK
    required: OAK_LOG
    required_amount: 20
    reward:
      reward_type: MONEY
      amount: 100
...

Category registration

In order for the plugin to load the quests from your new category, you simply need to mention it in the quests_per_category parameter of the configuration file. In this section, you can also choose the number of quests assigned per category.

More information right here.

Once this is done, you don't need to do anything else. Your category will be loaded automatically, and quests will be assigned to you!

Use in commands and placeholders

For commands and placeholders that require the category name, it simply corresponds to the entry you specified in quests_per_category, i.e., the file name without the extension.

If, for example, your file is woodcutter.yml, then your category is called woodcutter. To display all quests in the category, you will need to use the command /dq show woodcutter. A placeholder will look like %odailyquests_woodcutter_5%.