Integrations

SoapsQuest optionally integrates with Lands, Citizens, mcMMO, WorldGuard, and Denizen. All integrations are soft-dependencies and use reflection when the plugin is present.

MythicMobs and PlaceholderAPI are detected automatically — no integrations entry required.

By default (integrations.auto-detect: true), each integration turns on when its plugin is installed. Set an integration to false to force-disable it:

integrations:
  auto-detect: true
  # worldguard: false   # example: disable even when WorldGuard is installed

---

WorldGuard

Objective	Example
wg_enter_region	target: spawn, amount: 1
wg_leave_region	target: arena
wg_time_in_region	target: farm, amount: 10 (minutes; or use seconds: for exact seconds)

---

Lands

Objective	Example
lands_enter_land	target: MyKingdom
lands_visit_land	target: ANY, amount: 5
lands_claim_chunks	amount: 4
lands_land_level	target: MyKingdom, level: 10
lands_deposit	amount: 1000
lands_member_count	target: MyLand, amount: 5

---

Citizens

NPC quest givers

Configure NPC links in quests.yml under citizens-npcs::

citizens-npcs:
  "42":
    quest: lumberjack
    message: "<green>Take this contract!"
  "Quest Giver":
    quest: daily_hunt
    message: "<yellow>Good luck!"

Or link in-game: /sq npc link <npcId> <questId> [message]

Objectives

Objective	Example
citizens_talk_npc	target: 42 or Blacksmith
citizens_deliver_npc	target: 42, item: WHEAT:32 (right-click NPC with items)
citizens_kill_npc	target: Bandit

---

mcMMO

Objective	Example
mcmmo_skill_level	target: MINING, amount: 50
mcmmo_skill_gain	target: EXCAVATION, amount: 5
mcmmo_power_level	amount: 100
mcmmo_ability	target: SUPER_BREAKER, amount: 3
mcmmo_xp_gain	target: MINING, amount: 5000

---

Denizen

Feature	Example
denizen_run objective	target: my_quest_step (use /sq denizen signal <script> or Denizen script reward)
reward.denizen	denizen: quest_complete_fanfare

---

New vanilla objectives (1.1.0)

Type	Example
playtime	amount: 30 (minutes, active quest)
enter_world	target: NETHER
kill_player	amount: 3
advancement	target: minecraft:story/mine_stone
equip	target: DIAMOND_CHESTPLATE, slot: CHEST
smith	target: ANY

Admin showcase quests for every type use permission: soapsquest.admin.