GUI System
Last updated Sep 18, 2026
GUI System
SoapsQuest inventory menus are configured in gui.yml. Disable all GUIs with config.yml → gui.enabled: false.
Layouts use MiniMessage or legacy & color codes.
Quest browser
Command: /sq browse or /sq gui
Permission: soapsquest.gui.browser
Players browse available quests and click to receive a paper. Filters (tier, difficulty, type, origin, search) are built into the browser for staff testing; layout slots are in gui.yml under quest-browser:.
Premium adds a Get a Contract button that opens the contract board.
Active quests
Command: /sq active (aliases: /sq myquests, /sq quests)
Permission: soapsquest.gui.myquests
Shows in-progress quest papers from the player's queue.
Contract board (Premium)
Opened from /sq contract, a contract NPC, or the browser button.
Configured under gui.yml → contract-request:. Players pick a difficulty, see the fee, and confirm or cancel.
See Contract Request.
Quest editor (Premium)
Command: /sq editor [questid]
Permission: soapsquest.gui.editor
Sub-menus in gui.yml:
| Section | Purpose |
|---|---|
quest-editor |
Quest list |
quest-details |
Edit one quest |
objective-editor |
Objectives |
condition-editor |
Conditions |
reward-editor |
Rewards |
objective-type-selector |
Pick objective type |
condition-type-selector |
Pick condition type |
reward-type-selector |
Pick reward type |
Changes save to quests.yml immediately.
Chat alternatives
| Command | Purpose |
|---|---|
/sq list |
Paginated quest list in chat |
/sq claim <id> |
Claim from list without GUI |
/sq progress |
All held papers with status and timer |
Version 1.0.5