> For the complete documentation index, see [llms.txt](https://qm0-1.gitbook.io/questmaster-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qm0-1.gitbook.io/questmaster-docs/readme.md).

# QuestMaster Document

Welcome to **QuestMaster**, a flexible Minecraft Missions plugin that lets you create **normal and global missions** using simple YAML files.

This guide will help you understand:

* Mission Configuration
* Mission Types
* Custon Items and Rewards
* Global Missions (VCT)

### Example

{% tabs %}
{% tab title="Example 1" %}
Normal Mission (No Time)

```yml
missions:
  ExpertMiner:
    name: "ExpertMiner"
    type: BREAK_BLOCK
    objective: DIAMOND_ORE
    amount: 10
    rewards:
      - "item:mystic_pickaxe"
      - "xp:2l"
      - "give:gold_ingot 5"
      - "command:gamemode survival %player%"
    description:
      - "Mine 10 diamond ores"
      - "and show your mining skills!"
      - "rewards:"
      - " - lvl (2)"
      - " - Golden Ingot (5)"
      - " - Mystic Pickaxe (1)"
    conditions:
      - "min_level: 5"
      - "world: world"
      - "require_item_hand: DIAMOND_PICKAXE"
      - "require_item_offhand: SHIELD"
```

{% endtab %}

{% tab title="Example 2" %}
Normal Mission (With Time)

```yml
missions:
  BlacksmithApprentice:
    name: "BlacksmithApprentice"
    type: CRAFT
    objective: IRON_SWORD
    time: "00;01;00"
    amount: 1
    rewards:
      - "give:shield 1"
    description:
      - "Craft an iron sword."
      - "rewards:"
      - " - Shield (1)"
```

{% endtab %}

{% tab title="Example 3" %}
Global Missions

```yml
missions:
  ShinyCollector:
    enabled: false
    name: "ShinyCollector"
    type: COLLECT_ITEM
    objective: DIAMOND_PICKAXE
    global: true
    global-time: "00;01;00;timer_3"
    max-players: 2
    amount: 3
    rewards:
      - "give:emerald 2"
    description:
     - "Collect 3 diamonds."
     - "rewards:"
     - " - Emerald (2)"
```

{% endtab %}
{% endtabs %}