SoapsTraits Wiki
Last updated Sep 18, 2026
Version: 1.0.0
Author: AlternativeSoap
Minecraft API: Paper 26.2
SoapsTraits gives each player a class-style trait with passive stat bonuses and configurable combat effects. Traits are defined in YAML, assigned automatically from MMOCore classes or manually with commands, and edited in-game through a GUI.
Requirements
| Requirement | Details |
|---|---|
| Plugins | SoapsCommon |
| Server | Paper 26.2 |
| Spigot | Not supported |
| Folia | Not supported |
| Java | 21+ |
| Tested on | Paper 26.2, Java 25 |
Optional
| Plugin | Notes |
|---|---|
| MythicLib | Stat modifiers (recommended) |
| MMOCore | Class binding, mana, combat tag (recommended) |
Quick links
- Introduction - What the plugin does and how it fits your server
- Getting Started - Install, first reload, assign a trait
- Traits Configuration - Full
traits.ymlschema - Triggers - When effects run
- Conditions - Rules that must pass
- Actions - What happens when an effect fires
- Commands and Permissions -
/stsreference - Examples - Copy-paste trait ideas
Main command
/sts
Alias: /soapstraits
Run /sts with no arguments to see the full usage list in chat.
Config files
| File | Purpose |
|---|---|
config.yml |
Server settings, default trait, tick interval |
traits.yml |
All trait definitions |
messages.yml |
Chat and GUI text |
playerdata.yml |
Per-player trait assignments (auto-managed) |
Support
Docs in this folder match SoapsTraits 1.0.0. After updates, run /sts reload and check the console for config warnings.