SoapsUniverse
SoapsCommon
SoapsCommon

Getting Started

HomeIntroductionGetting Started

Configuration

ConfigurationDefault Config Files

Features

GUI SystemGUI AnimationsIntegrations

Other

FAQChangelog

Changelog

Last updated Sep 18, 2026

Changelog

Version history for SoapsCommon. Written for server owners.

1.4.2

Current release. Use this build with suite plugins that list SoapsCommon 1.4.2 as a dependency.

Production readiness (2026-06-11)

  • Added SoapsCommandSandbox — shared allowlist/blocklist for YAML [command] and [console] actions with audit logging
  • Added SoapsChatInput — shared timeout/cancel chat capture (replaces per-plugin AsyncPlayerChatEvent handlers)
  • Added SoapsYamlFiles.atomicSave() — crash-safe YAML writes adopted across the suite
  • GUI: requires-online clicks blocked for offline targets; open-permission denial message; close-action skips offline players
  • GuiManager.closeAllActive() and automatic GUI shutdown when a consumer plugin disables
  • ActionRegistry: [console] routed through sandbox; bracket-aware [multi] split; handler exceptions log full stack traces
  • Unit tests: command sandbox, action registry, chat input, YAML atomic save, text parsing

1.4.1

  • Fixed menu animation crashes on busy event boards (rain effect)
  • Intro animations no longer fight with other effects on the same menu
  • Roulette and refresh timing improvements on animated menus

1.4.0

  • Added animated menus: cycle, intro, shift, rain, roulette, click-flash, refresh
  • Menu items can trigger animations with click actions
  • Menus can auto-refresh on a timer
  • Simpler GUI override files (system-gui.yml cosmetic merge)
  • Removed old multi-file gui/skins/ override model
  • Requires Paper 1.21+
  • Install SoapsCommon 1.4.0 before updating suite plugins that depend on it

1.3.0

Breaking cleanup release.

  • Cleaner startup banners across all suite plugins
  • Single gui.enabled setting (old settings.gui-enabled removed)
  • Update SoapsCommon and all suite plugins together on this version

1.2.1

  • Fixed GUI clicks on dynamically placed items (schematic cards, room browsers, and similar menus)
  • No config changes required; update the JAR alongside any plugin that uses SoapsCommon GUIs

1.2.0

Early GUI engine and shared text utilities. Plan a full upgrade to 1.4.x if you are still on 1.2.x.