Introduction

Last updated Sep 18, 2026

Introduction

SoapsQuest gives players physical quest papers instead of a menu-only quest log. Each paper shows live progress on its lore. When every objective is done, the player right-clicks the paper to claim rewards.

Progress is stored in YAML on disk. No database is required.


How it works

  1. A player receives a quest paper (/sq give, browser, NPC, contract, daily reset, or loot drop).
  2. Objectives track in the world (kills, blocks broken, items collected, etc.).
  3. Lore and optional HUD lines update as progress changes.
  4. The player right-clicks a completed paper to claim rewards.

Multiple copies of the same quest ID queue behind the active paper. Different quest IDs can all be active at once.

To release a paper, press Q to drop it. Progress stays on the instance. Another player can pick it up and continue unless lock-to-player is set.


Free vs Premium

Feature Free Premium
Quest papers, browser, active GUI Yes Yes
43+ vanilla objectives (61 with integrations) 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 (/sq npc link) 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 editions ship the same quest core. Premium adds authoring and distribution tools for large servers.


Editions and JARs

JAR Build
SoapsQuest-1.0.5-Free.jar Free edition
SoapsQuest-1.0.5-Premium.jar Premium edition

Install SoapsCommon first. Use a full server restart after installing or upgrading.


Version 1.0.5