SoapsCommon Wiki

Last updated Jul 6, 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

Paper 1.21 or higher
Java 21

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