FAQ

Last updated Jul 6, 2026

FAQ

Does SoapsCommon add any commands?

No. Players never run a SoapsCommon command. All commands come from the plugins that depend on it.

Do I need to configure SoapsCommon?

Usually no. Install the JAR and restart. Tune gui.enabled, settings.debug, and menu YAML files in each suite plugin's own folder.

Shaded or standalone JAR?

Shaded: Each suite plugin JAR already contains SoapsCommon. You only install that plugin's JAR.
Standalone: You install SoapsCommon.jar plus each suite plugin that lists it under depend.

Do not run both models at once.

Why did SoapsAdmin (or another plugin) disable on startup?

The plugin checks that SoapsCommon is loaded and compatible. Fix:

Add or update SoapsCommon.jar
Match versions (check the plugin download page)
Full server restart

There is no plugins/SoapsCommon/gui/ folder by default. Menus live in each plugin's data directory. For SoapsAdmin, edit plugins/SoapsAdmin/gui/.

Do I need Vault or PlaceholderAPI for SoapsCommon?

No. They are optional. Individual suite plugins document when they need Vault (money) or PAPI (placeholders).

Which version do I need?

Use the SoapsCommon version listed on the download page for your suite plugins. As of this wiki, the library is 1.4.2. SoapsAdmin 1.4.2 and other current suite builds expect SoapsCommon 1.4.x.

What server software and Java version are required?

Paper 26.1+ with Java 25+. Paper 1.21.x with Java 21+ also works. Spigot 1.21.x is supported with limited features (see each plugin's docs). Folia is not supported.

Where is the developer API documented?

This wiki is for server owners. Java API details are in the root README.md in the SoapsCommon source repo for plugin authors.