Commands and Permissions

Main command: /soapsquest (alias /sq). Both are identical.

Running /sq with no arguments opens the help menu (filtered by your permissions).

---

Player commands

Command	Permission	Description
/sq help	soapsquest.use	Command list (permission-filtered)
/sq info	soapsquest.use	Version and edition (Free/Premium)
/sq browse	soapsquest.gui.browser	Quest browser GUI
/sq gui	soapsquest.gui.browser	Same as browse
/sq list	soapsquest.list	Paginated quest ID list
/sq list <page>	soapsquest.list	Specific page
/sq claim <questid>	soapsquest.list.click	Claim a quest (same as clicking in /sq list)
/sq active	soapsquest.gui.myquests	Your active quests GUI
/sq active <player>	soapsquest.progress.others	Another player's active quests
/sq myquests	soapsquest.gui.myquests	Alias for active
/sq quests	soapsquest.gui.myquests	Alias for active
/sq progress	soapsquest.progress	Chat summary of all quest papers you hold
/sq progress <player>	soapsquest.progress.others	Another player's held papers
/sq statistic	soapsquest.statistic	Your completion stats

To give up a quest paper, press Q to drop it. Progress is kept; another player can pick it up and continue. Storing a paper in a chest only pauses tracking until you pick it up again.

---

Admin commands

Command	Permission	Description
/sq reload	soapsquest.reload	Reload configs (validates quests.yml first)
/sq give [player] <questid>	soapsquest.give	Give quest paper
/sq remove <questid>	soapsquest.remove	Remove quest from config (writes file immediately)
/sq copy <source> <newid>	soapsquest.copy	Duplicate a quest
/sq reset <player> <questid>	soapsquest.reset	Reset progress on held paper(s)
/sq complete <player> <questid>	soapsquest.complete	Force-complete held paper(s)
/sq debug toggle	soapsquest.debug	Toggle debug logging
/sq statistic <player>	soapsquest.admin	View another player's stats
/sq npc link <npc-id|name> <quest-id> [message]	soapsquest.admin	Link a Citizens NPC to give a quest on right-click
/sq npc broker <npc-id|name> [message]	soapsquest.admin (Premium)	Contract NPC
/sq npc brokers	soapsquest.admin (Premium)	List contract NPCs
/sq npc unbroker <npc-id|name>	soapsquest.admin (Premium)	Remove contract NPC

| /sq denizen signal <script> [player] | soapsquest.use / admin for other players | Signal denizen_run objective progress |

Reward commands

Command	Permission
/sq addreward <quest> xp <amount>	soapsquest.addreward
/sq addreward <quest> money <amount>	soapsquest.addreward
/sq addreward <quest> sigils <amount>	soapsquest.addreward (Premium)
/sq addreward <quest> command <cmd>	soapsquest.addreward
/sq addreward <quest> item	soapsquest.addreward (held item)
/sq listreward <quest>	soapsquest.listreward
/sq removereward <quest> <index>	soapsquest.removereward

Premium commands

Command	Permission	Description
/sq editor [questid]	soapsquest.gui.editor	In-game quest editor
/sq generate [type] [count|amount] [objective] [min] [max] [difficulty] [tier] [material]	soapsquest.generate	Random quest generator (lone number after type = amount)
/sq contract [difficulty]	soapsquest.contract	Take a random contract paper
/sq sigils balance <player>	soapsquest.sigils	Show Sigil balance
/sq sigils give|take|set <player> <amount>	soapsquest.sigils	Modify Sigils
/sq sigils reset <player>	soapsquest.sigils	Reset Sigils to 0
/sq spawnpaper <questid> [x y z [world]]	soapsquest.drop	Spawn a fresh unbound paper in the world
/sq drop <questid> ...	soapsquest.drop	Alias for spawnpaper

Generator cooldown bypass: soapsquest.generate.bypass-cooldown

---

Timed quest HUD (config.yml)

Global display options under quest-timer-display::

Option	Description
paper-name	Append countdown to the paper item name
action-bar	Live countdown in the action bar (default: true)
boss-bar	Boss bar for the most urgent active timed quest
chat-reminder-seconds	Periodic chat reminders (0 = off)

Timer lore on the paper always updates when a deadline is armed.

---

Block objective anti-cheat (config.yml)

Key	Default	Effect
anti-cheat.enabled	true	Master toggle
anti-cheat.break	true	Break/harvest ignore player-placed blocks
anti-cheat.place	true	Place ignores farm re-placements
anti-cheat.collect	true	Collect ignores self-farmed drops
anti-cheat.creative	true	No block/collect progress in creative

See Default Configs.

---

Permissions reference

Player defaults

Permission	Description	Default
soapsquest.use	Base command access	Everyone
soapsquest.gui.browser	Quest browser	Everyone
soapsquest.gui.myquests	Active quests GUI	Everyone
soapsquest.list	Quest list command	Everyone
soapsquest.list.click	Click/claim quests from /sq list	Everyone
soapsquest.statistic	Own statistics	Everyone
soapsquest.progress	/sq progress for yourself	Everyone

Staff defaults

Permission	Description	Default
soapsquest.admin	NPC/Denizen (others), others' statistics	OP
soapsquest.give	Give papers	OP
soapsquest.reload	Reload	OP
soapsquest.remove	Remove quests	OP
soapsquest.copy	Copy quests	OP
soapsquest.reset	Reset held progress	OP
soapsquest.complete	Force-complete held papers	OP
soapsquest.addreward	Add rewards via command	OP
soapsquest.removereward	Remove rewards	OP
soapsquest.listreward	List rewards	OP
soapsquest.progress.others	/sq active <player>, /sq progress <player>	OP
soapsquest.debug	Debug toggle	OP
soapsquest.gui.editor	Editor GUI (Premium)	OP
soapsquest.generate	Generator (Premium)	OP
soapsquest.contract	Take contracts (Premium)	true
soapsquest.contract.bypass-cooldown	Skip contract cooldown	OP
soapsquest.contract.bypass-cost	Skip contract fee	OP
soapsquest.sigils	Sigil admin (Premium)	OP
soapsquest.drop	Spawnpaper command (Premium)	OP

Wildcard

soapsquest.* grants all nodes above.

---

Per-quest permission

Use conditions.permission on a quest to lock browser pickup:

conditions:
  permission: "rank.vip"

Root-level permission: on the quest gates progress after pickup. See Conditions.

---

Version 1.0.5