# Multi-Step quests

Learn how to create multiple step quests!

```yaml
10: # Multiple step quest
    name: 'Week 1 - Advanced Miner'
    steps:
      1:
        type: block-break
        variable: coal_ore
        required-progress: 10
        points: 0
        info:
          - "&7Mine &e10 coal ores"
      2:
        type: block-break
        variable: iron_ore
        required-progress: 10
        points: 5
        info:
          - "&7Mine &e10 iron ores"
      3:
        type: block-break
        variable: diamond_ore
        required-progress: 10
        points: 25
        info:
          - "&7Mine &e10 diamond ores"
    item:
      material: golden_pickaxe:0
      name: '&eAdvanced Miner &7(&e%step%&7/&6%steps%&7)'
      lore:
        - '&7Mine various ores'
        - '%info%'
        - ''
        - '&7Progress &e%total_progress%&7/&e%required_progress%'
```

This quest has 3 steps:

* Mine 10 coal ores (no rewards)
* Mine 10 iron ores (gives 5 points)
* Mine 10 diamond ores (gives 25 points)

After completing all 3 steps, the quest will complete.

### How to create a quest with multiple steps

As in the example, create a section `steps` and add quest parameters to each step section as desired.

### Info parameter

Each step can contain a list of information which you can use inside the quest icon (`%info%`).

### Icon placeholders related to steps system

* `%step%` - current step
* `%steps%` - number of steps
* `%info%` - information from step `info` parameter

### Global quest parameters

Some values like type, required-progress, whitelist, blacklist etc. can be used globally by adding them to the quest section instead of the step section.

Example:

```yaml
yamlCopy10: # Multiple step quest
    name: 'Week 1 - Advanced Miner'
    required-progress: 10
    points: 5
    steps:
      1:
        type: block-break
        variable: coal_ore
        info:
          - "&7Mine &e10 coal ores"
      2:
        type: block-break
        variable: iron_ore
        info:
          - "&7Mine &e10 iron ores"
      3:
        type: block-break
        variable: diamond_ore
        info:
          - "&7Mine &e10 diamond ores"
```

In this example, all steps require 10 progress and give 5 points (per step).


---

# 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://battlepass.advancedplugins.net/quests/multi-step-quests.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.