SoapsQuest Wiki
Last updated Sep 18, 2026
SoapsQuest is a physical quest paper system for Paper 26.2 / Spigot 26.2. Players carry quest items in their inventory, complete objectives in the world, and claim rewards by using the paper.
Version 1.0.5
Quick links
| Page | Description |
|---|---|
| Introduction | What SoapsQuest does and Free vs Premium |
| Getting Started | Install, verify, and first reload |
| Creating Quests | quests.yml structure and fields |
| Objectives | All objective types |
| Integrations | Lands, Citizens, mcMMO, WorldGuard, Denizen |
| Rewards | XP, money, items, commands, sigils, quest chains |
| Conditions | Start requirements and costs |
| Tiers and Difficulties | Rarity and scaling |
| GUI System | Browser, editor, and active quest menus |
| Daily and Weekly Quests | Recurring quest schedules (Premium) |
| Random Quest Generator | /sq generate with partial filters (Premium) |
| Contract Request | Random contracts (Premium) |
| Set up a contract NPC | Citizens contract NPC walkthrough (Premium) |
| Quest Loot System | Chest and mob drops (Premium) |
| Commands and Permissions | Full command reference |
| Placeholders | PlaceholderAPI expansion |
| Default Configs | Every config file explained |
| Examples | Copy-paste quest examples |
| FAQ | Common server owner questions |
| Changelog | Version history |
Requirements
| Requirement | Details |
|---|---|
| Plugins | SoapsCommon |
| Server | Paper 26.2 |
| Spigot | 26.2 |
| Folia | Not supported |
| Java | 21+ |
| Tested on | Paper 26.2, Java 25 |
Optional integrations
| Plugin | Purpose |
|---|---|
| Vault | Economy rewards and costs |
| PlaceholderAPI | Placeholders and placeholder objectives |
| MythicMobs | Mythic mob kill objectives |
| WorldGuard | Region objectives |
| Lands | Land objectives |
| Citizens | NPC objectives, quest givers, contract brokers |
| mcMMO | Skill objectives |
| Denizen | Script objectives and rewards |
Free vs Premium (summary)
| Feature | Free | Premium |
|---|---|---|
| Physical quest papers | Yes | Yes |
| 43 vanilla objective types (61 with integrations) | Yes | Yes |
| Quest browser and active quests GUIs | Yes | Yes |
Manual quests in quests.yml |
Yes | Yes |
| Tiers, difficulties, timed quests | Yes | Yes |
| Sigils as rewards and conditions | Yes | Yes |
| Block objective anti-cheat | Yes | Yes |
Q-drop custody and /sq claim |
Yes | Yes |
| In-game quest editor GUI | No | Yes |
| Random quest generator | No | Yes |
| Random contracts | No | Yes |
| Daily and weekly quests | No | Yes |
| Quest loot (chests and mobs) | No | Yes |
/sq sigils admin commands |
No | Yes |
/sq spawnpaper admin placement |
No | Yes |
See Introduction for the full matrix.
Links
- Website: SoapsUniverse.com
- Discord: discord.gg/mawAzwFq
Created by AlternativeSoap