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

# Introduction

ScrollQuest turns quests into real items. Players receive paper scrolls with randomized missions, watch their progress update live on the ActionBar, and right-click the scroll to claim rewards. No menus, no GUIs, just an item in the inventory.

<figure><img src="https://images.reavermc.club/Laughingthrush/explorer_bIpEf0Tnwv.gif" alt="A quest scroll showing its mission, progress bar, and rewards in the item lore"><figcaption><p>Every quest lives in the item lore: mission, progress, and rewards.</p></figcaption></figure>

{% hint style="info" %}
**New here?** Start with [Getting Started](/scrollquest/getting-started/getting-started.md) to install the plugin and hand out your first quest in under a minute.
{% endhint %}

## Showcase

{% embed url="<https://www.youtube.com/watch?v=GNo7WNSGV20>" %}

## What it does

{% tabs %}
{% tab title="For players" %}

* Get a scroll, read the mission on the item tooltip.
* Do the objective (walk, mine, fish, farm, fight, and more).
* Track progress on the ActionBar in real time.
* Right-click the finished scroll to claim money, XP, or item rewards.
  {% endtab %}

{% tab title="For server owners" %}

* Drop in the jar, three config files generate themselves.
* 53 ready-made missions across 5 rarity tiers, all editable.
* Hand out quests by command, or wire them into crates, shops, and events.
* Localize every line of text, add resource-pack textures, expose stats through PlaceholderAPI.
  {% endtab %}
  {% endtabs %}

## Features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>How Quests Work</strong></td><td>Quest lifecycle, live progress, anti-exploit, and claiming.</td><td><a href="/pages/rCQ3RKkbIalDaCRDHvqJ">/pages/rCQ3RKkbIalDaCRDHvqJ</a></td></tr><tr><td><strong>Missions &#x26; Rewards</strong></td><td>12 mission types, chance-based rewards, and custom missions.</td><td><a href="/pages/xIn3PHxgzQxCOb6dQXnO">/pages/xIn3PHxgzQxCOb6dQXnO</a></td></tr><tr><td><strong>Configuration</strong></td><td>Rarities, sounds, titles, cleanup modes, and quest expiration.</td><td><a href="/pages/si4doTAnhvPnRhsTVR7E">/pages/si4doTAnhvPnRhsTVR7E</a></td></tr><tr><td><strong>Messages &#x26; Localization</strong></td><td>Translate every string. Colors, gradients, month names, AM/PM.</td><td><a href="/pages/OnE7fznPDPnixXJruKdx">/pages/OnE7fznPDPnixXJruKdx</a></td></tr><tr><td><strong>Placeholders</strong></td><td>10 PlaceholderAPI placeholders for scoreboards and holograms.</td><td><a href="/pages/GLWX8RcQmo7lmEMQ2esN">/pages/GLWX8RcQmo7lmEMQ2esN</a></td></tr><tr><td><strong>Resource Packs</strong></td><td>Per-rarity CustomModelData for custom scroll textures.</td><td><a href="/pages/C1gfT6eZ582uAghahgFV">/pages/C1gfT6eZ582uAghahgFV</a></td></tr></tbody></table>

## Quick facts

|                           |                                                                 |
| ------------------------- | --------------------------------------------------------------- |
| **Platform**              | Paper, Spigot, and Paper forks (Purpur, Pufferfish, and others) |
| **Minecraft**             | 1.16 and newer, including 26.1+                                 |
| **Java**                  | 17 or newer (Java 25 for MC 26.1)                               |
| **Hard dependencies**     | None                                                            |
| **Optional soft-depends** | Vault (money rewards), PlaceholderAPI (placeholders)            |

## Where to go next

{% content-ref url="/pages/jzwlYGRCslj6BlzKrbiu" %}
[Installation](/scrollquest/getting-started/getting-started.md)
{% endcontent-ref %}

{% content-ref url="/pages/cEBgisA1POwTISRrpYvw" %}
[Download](/scrollquest/getting-started/download.md)
{% endcontent-ref %}

{% content-ref url="/pages/LUra35fYYfBtRQS3HH2K" %}
[Commands & Permissions](/scrollquest/reference/commands-and-permissions.md)
{% endcontent-ref %}

## Get the plugin

ScrollQuest is a premium plugin. Buy it from any of these marketplaces:

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>SpigotMC</strong></td><td>Buy on the SpigotMC marketplace.</td><td><a href="https://www.spigotmc.org/resources/scrollquest.129258/">https://www.spigotmc.org/resources/scrollquest.129258/</a></td></tr><tr><td><strong>BuiltByBit</strong></td><td>Buy on BuiltByBit.</td><td><a href="https://builtbybit.com/resources/scrollquest-paper-mission-quests.79020/">https://builtbybit.com/resources/scrollquest-paper-mission-quests.79020/</a></td></tr><tr><td><strong>PixelEast</strong></td><td>Buy on the PixelEast store.</td><td><a href="https://pixeleast.com/product/466906-scrollquest-paper-quests">https://pixeleast.com/product/466906-scrollquest-paper-quests</a></td></tr></tbody></table>

See the [Download](/scrollquest/getting-started/download.md) page for what you get and how to set it up.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://zarrowtan-resources.gitbook.io/scrollquest/getting-started/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.