# 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](#file-creation)
2. [Category registration](#category-registration)
3. [Use in commands and placeholders](#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!

{% code title="woodcutter.yml" %}

```yaml
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
...
```

{% endcode %}

## 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](/odailyquests/configuration/configuration-file.md#quests-per-category).

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%`.


---

# 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/quests/create-a-category.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.