SoapsUniverse
SoapsQuest
SoapsQuest

Pages

Integrations

Getting Started

HomeIntroductionGetting Started

Quest Authoring

Creating QuestsObjectivesRewardsConditionsTiers and DifficultiesExamples

Premium

Daily and Weekly Quests (Premium)Random Quest Generator (Premium)Quest Loot System (Premium)

Reference

GUI SystemCommands and PermissionsPlaceholdersDefault Configs

Support

FAQChangelog

Default Configs

Last updated Jul 6, 2026

Default Configs

Files created in plugins/SoapsQuest/ on first run.

All editions

File Purpose
config.yml Core settings, progress display, sounds, anti-cheat, performance
quests.yml Quest definitions and showcase quests
messages.yml Player-facing messages
gui.yml Browser, editor, and active quest menu layouts
tiers.yml Rarity tiers (common through mythic)
difficulties.yml Difficulty scaling multipliers
playerdata.yml Per-player quest instance progress (auto)
statistics.yml Completion counts by tier and difficulty (auto)
sigils.yml Sigil balances (auto)

config.yml highlights

gui:
  enabled: true
debug: false
autosave-interval: 5
default-tier: common
default-difficulty: normal
progress-display:
  mode: "actionbar"    # actionbar | chat | bossbar | none
abandon-on-drop: true
abandon-on-container-store: true
prevent-workstation-placement: true
anti-cheat:
  enabled: true
integrations:
  lands: true
  citizens: true
  mcmmo: true
  worldguard: true
  denizen: true

quests.yml

Top-level quests: map. Each key is a quest ID. See Creating Quests. Ships with starter quests and showcase_<type> entries for every objective type (admin-gated showcases in 1.1.0).

NPC links are stored in quests.yml under citizens-npcs:. See Integrations. Also editable via /sq npc link.

gui.yml

Sections: quest-browser, quest-editor, quest-details, objective-editor, condition-editor, reward-editor, player-quests.

tiers.yml / difficulties.yml

Define display, color, weight, description, and (for difficulties) multiplier blocks. See Tiers and Difficulties.

Premium only

These files are bundled only in the Premium JAR:

File Purpose
daily.yml Daily and weekly recurring quest schedules
random-generator.yml Random quest generator templates and reward pools
quest-loot.yml Chest and mob quest paper drops
generated.yml Storage for generated quest IDs (created on first generate)

Data files (do not hand-edit while server is running)

File Contents
playerdata.yml Active progress per quest instance UUID
statistics.yml Historical completion stats
sigils.yml Economy balances

Use /sq reload after editing YAML configs. Data files are written on autosave (autosave-interval minutes) and shutdown.

Reload order

/sq reload refreshes, in order:

  1. config.yml
  2. messages.yml
  3. difficulties.yml, tiers.yml
  4. quests.yml (with validation)
  5. Rewards
  6. daily.yml (Premium)
  7. quest-loot.yml (Premium)
  8. Random generator config (Premium)
  9. gui.yml
  10. Citizens NPC links in quests.yml (citizens-npcs:) when Citizens integration is enabled
  11. Integration bridges re-probed (WorldGuard, Lands, Citizens, mcMMO, Denizen)

Version 1.1.0

Discord