Integrations

SoapsCommon does not register its own PlaceholderAPI expansion or economy commands. It provides optional bridges that other Soaps plugins use when those plugins are installed.

---

PlaceholderAPI

SoapsCommon can call PlaceholderAPI when parsing text, if PAPI is on the server. Suite plugins use this for chat messages and some menu text.

SoapsCommon does not add %soapscommon_*% placeholders.

If you see %player_name% or other PAPI tokens in a Soaps plugin's messages or GUI lore, install PlaceholderAPI. If placeholders show as literal %text%, PAPI is missing or the placeholder id is wrong.

GUI item text often uses {curly} placeholders filled by the plugin that owns the menu. Those are not PlaceholderAPI unless the plugin explicitly documents PAPI support for that field.

---

Vault

SoapsCommon includes a reflective Vault economy bridge. Suite plugins (SoapsAdmin shop, SoapsTeleporter portal costs, SoapsArena duel wagers) use it when Vault and an economy plugin are present.

SoapsCommon itself does not charge players or show balances. Configure economy in the plugin that owns the feature.

---

Required vs optional

Integration	Required?	Used for
SoapsCommon	Yes (for suite plugins)	Library and GUIs
PlaceholderAPI	No	%placeholder% in messages and some GUIs
Vault + economy plugin	No	Money costs and rewards in supported plugins

---

SoapsQuest integration flag

Some plugins expose:

integrations:
  soapsquest:
    enabled: false

That toggle lives in the consumer plugin's config, not in SoapsCommon. See that plugin's wiki for what runs when it is enabled.