FAQ

Last updated Sep 18, 2026

FAQ

Common questions from server owners.

General

Does SoapsQuest need a database?
No. Progress, statistics, and sigils are stored in YAML under plugins/SoapsQuest/.

Does /sq reload work?
Yes. /sq reload validates quests.yml before applying changes. Use a full restart only for first install or JAR upgrades.

What happened to /sq abandon?
Removed in 1.0.5. Press Q to drop the paper and release it. Progress stays on the instance.

Can another player continue my quest?
Yes, if they pick up the dropped paper and the quest is not lock-to-player. Bound papers can only be picked up by the owner.

Do chests pause quests?
Storing a paper in a chest, ender chest, or shulker pauses tracking until picked up again. Hoppers and workstations cannot move quest papers.

Progress and anti-cheat

Can players farm break quests by placing and breaking blocks?
No, when anti-cheat.break is enabled (default). Player-placed blocks do not count for break or harvest objectives.

Does anti-cheat affect place and collect quests?
Yes. Place farming (break your own block, place again) and collect farming (drop and pick up items) are blocked when those toggles are on. See Default Configs.

Does creative mode count for block objectives?
No, when anti-cheat.creative is enabled (default).

Can I upgrade Free to Premium without losing configs?

Yes. Replace the Free jar with Premium and restart (or /sq reload after restart).

Existing files (config.yml, quests.yml, messages.yml, gui.yml, data) are never overwritten
Missing Premium files (random-generator.yml, daily.yml, contract-request.yml, quest-loot.yml) are created from defaults
New keys added in plugin updates are merged into existing YAML without changing your values

Console logs: Premium upgrade: added ... Existing configs were not modified. when new Premium files are created.

Permissions and commands

Why does /sq list click not give quests?
List clicks use /sq claim and require soapsquest.list.click. They do not use soapsquest.give.

Why can't my players open the browser?
Grant soapsquest.gui.browser. Also check config.yml → gui.enabled: true.

What's the difference between conditions.permission and root permission?
conditions.permission locks browser pickup. Root permission: on the quest gates progress after the paper is already held.

Premium

I have Premium but /sq generate says disabled.
Set random-generator.enabled: true in random-generator.yml, then /sq reload.

Contracts vs fixed NPC quests?
/sq npc link always gives one quest. /sq npc broker opens the contract board and rolls a random temporary quest (Premium).

Can Free use sigils?
Yes. Sigils work as rewards and conditions in both editions. Only Premium adds /sq sigils admin commands.

Integrations

MythicMobs objectives do not progress.
Install MythicMobs. No config toggle is needed; detection is automatic.

Citizens NPC does nothing on click.
Create and spawn the NPC in Citizens first. Link with /sq npc link or /sq npc broker. Check console for Citizens integration enabled.

Quest needs WorldGuard but I don't have it.
Quests requiring a missing integration are skipped quietly. Remove or change those objectives, or install the plugin.

Troubleshooting reload errors

Shard write error on /sq reload.
Fixed in 1.0.5. Update to the latest jar. Reload now flushes player shards synchronously.

Reload aborted on quests.yml.
Fix the listed syntax or validation errors. The previous config stays active until reload succeeds.

Version 1.0.5