SoapsQuest Wiki

Last updated Jul 6, 2026

SoapsQuest is a physical quest paper system for Paper servers. Players carry quest items in their inventory, complete objectives in the world, and claim rewards by using the paper.

Version 1.1.0

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	Unlock 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` (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
Server	Paper 1.21+ (or a Paper fork such as Purpur)
Java	21 or newer
Required plugin	SoapsCommon
Optional	Vault (economy), PlaceholderAPI, MythicMobs, Lands, Citizens, mcMMO, WorldGuard, Denizen

Free vs Premium (summary)

Feature	Free	Premium
Physical quest papers	Yes	Yes
37+ objective types (43 vanilla in 1.1.0)	Yes	Yes
Quest browser GUI	Yes	Yes
Active quests GUI (`/sq active`)	Yes	Yes
Manual quests in `quests.yml`	Yes	Yes
Tiers and difficulties	Yes	Yes
Sigils as rewards and conditions	Yes	Yes
In-game quest editor GUI	No	Yes
Random quest generator	No	Yes
Daily and weekly quests	No	Yes
Quest loot (chests and mobs)	No	Yes
`/sq sigils` admin commands	No	Yes
`/sq drop` world placement	No	Yes

See Introduction for the full matrix.