SoapsQuest Wiki
Last updated Oct 28, 2026
Physical quest papers with live lore. Players hold a paper, complete objectives in the world, and right-click to claim rewards.
Version 1.0.7
Flow: Get a paper → track progress on the lore → claim rewards.
Two jars: Free (core papers and authoring in YAML) and Premium (generator, contracts, schedules, loot, in-game editor). See Introduction.
Start here
| Page | Description |
|---|---|
| Getting Started | Install Free or Premium, verify, reload policy |
| Creating Quests | Write quests in quests.yml (both editions) |
| Config Reference | Full shipped YAML, one file per page |
| Upgrading to 1.0.7 | What to do after the jar update |
I want to…
| Goal | Edition | Page |
|---|---|---|
| Hand out a paper quest | Free | Want give a quest |
| Write a kill / break quest | Free | Want write a quest |
| Generate random quests | Premium | Want generate quests |
| Offer player contracts | Premium | Want contracts |
| Daily / weekly delivery | Premium | Want dailies |
Browse
| Section | Pages |
|---|---|
| Configure | Configuration · Objectives · Rewards · Conditions · Tiers |
| Free core | Creating Quests · GUI System |
| Premium | Generator · Contracts · Contract NPC · Dailies · Loot |
| Admin | Commands · Placeholders · Integrations |
| Help | FAQ · Troubleshooting · Examples · Changelog |
Requirements
| Requirement | Details |
|---|---|
Plugins (depend) |
SoapsCommon |
| Server | Paper / Spigot 26.1–26.3 · Folia not supported |
| Java | 21+ (Java 25 recommended) |
Downloads are ZIPs. Extract the Free or Premium .jar. Soft deps: Integrations.
Still stuck? Ask about this page