FAQ

Short answers. Prefer the linked guide for steps.

Why do I need SoapsCommon?

Every Soaps suite plugin depends on it. The Event Engine (on by default) builds join kits, rewards, and live events from /soaps. See Introduction.

Plugin red / no SoapsCommon folder?

Library-only installs may create no folder. That can be normal. Suite plugins red with no folder of their own usually means a ZIP left in plugins/ instead of the jar. See Troubleshooting.

Enable vs Start vs Kind?

Kind (type: automation or type: event) drives list filters. Staff-start means when.type: manual and needs Start, not only Enable.

	Automation (Kind)	Event (Kind)
Enable	Listens for its When	Allowed to run; listens if When is not manual
Start	Not required	Required when When is manual
Disable	Stops listening	Blocks new starts

Full walkthrough: Event GUI.

Do I edit YAML to make events?

Build in the Event GUI. Files also save under events/ and automations/.

Restart vs reload?

Canonical table: Getting Started.

Where are shipped defaults?

Config Reference. Showcases: Examples.

Do I need Vault or PlaceholderAPI?

No for Common to load. Vault for money types. PAPI for %soaps_event_*% and %…% in text. Setup: Vault Setup · Placeholders.

Can I turn the engine off?

Yes. Want library only.

How do players mute event spam?

/soaps mute (or the player events GUI). Muted players skip broadcast Dos and boss bars. Join prompts still appear.

Reach / deliver / join teleport did nothing?

Location world missing or still blank. Type here while standing at the spot. See Troubleshooting.