SoapsCommon Wiki

Last updated Sep 18, 2026

SoapsCommon is the shared library behind every Soaps plugin. You install it once, and the rest of the suite can use the same menus, text formatting, and startup checks.

Version 1.4.2

Quick Links

Page	Description
Introduction	What SoapsCommon does and why you need it
Getting Started	Install and verify it is working
Configuration	Shared config keys used by other plugins
GUI System	How YAML menus work across the suite
GUI Animations	Animated menu effects
Integrations	Vault and PlaceholderAPI
Default Config Files	GUI schema defaults and `_settings.yml`
FAQ	Common questions
Changelog	Version history

Requirements

Requirement	Details
Plugins	None
Server	Paper 26.2
Spigot	26.2
Folia	Not supported
Java	21+
Tested on	Paper 26.2, Java 25

SoapsCommon has no player commands and no permissions of its own. Other Soaps plugins list it as a required dependency in their plugin.yml.