Introduction

SoapsQuest turns quests into physical papers. Hold one, watch lore update, right-click to claim rewards when you finish.

Requires SoapsCommon. Progress lives in YAML on disk.

What players feel

1. Receive a paper (/sq give, browser, NPC, or Premium: contract, daily, loot).
2. Complete objectives in the world.
3. Lore (and optional HUD) updates as they go.
4. Right-click a finished paper to claim rewards.

Press Q to drop a paper. Progress stays on that instance unless lock-to-player binds it.

Free vs Premium

Feature	Free	Premium
Quest papers, browser, active GUI	Yes	Yes
43+ vanilla objectives (61 with integrations)	Yes	Yes
Manual quests in quests.yml	Yes	Yes
Tiers, difficulties, conditions, sigils	Yes	Yes
Timed quests and timer HUD	Yes	Yes
Block objective anti-cheat	Yes	Yes
/sq list, /sq claim, /sq progress	Yes	Yes
Citizens fixed NPC links	Yes	Yes
In-game quest editor	No	Yes
/sq generate random generator	No	Yes
/sq contract and contract NPCs	No	Yes
Daily and weekly schedules	No	Yes
Quest loot (chests and mobs)	No	Yes
/sq sigils admin	No	Yes
/sq spawnpaper / /sq drop	No	Yes

Both jars share the same quest core. Premium adds tools that refill and sell quests without writing every paper by hand.

Editions and JARs

JAR	Edition
SoapsQuest-1.0.7-Free.jar	Free
SoapsQuest-1.0.7-Premium.jar	Premium

Install SoapsCommon first. Use a full restart after installing or swapping Free ↔ Premium. YAML edits use /sq reload. Details: Getting Started.

Who owns what

Role	Owns
Players	Hold papers, progress, claim
Staff (Free)	quests.yml, give/reset/complete, browser
Staff (Premium)	Editor, generate, contracts, dailies, loot, sigils

Next: Getting Started · Want write a quest