Getting Started
Install SIR+, understand the extra admin controls, and prepare for addon-based extensions.
What changes in SIR+?
SIR+ keeps the same module and command-provider foundation as Modern SIR, but adds a real runtime extension layer on top.
The practical differences are:
/sircommand aliases:sir-plus,sir+,sirplus,sirp/sir addonssupport- addon enable or disable state persistence
- provider command override controls
- a public
SIRApiartifact for addon development - extra migration coverage, including
CMI
If you only want the stock built-in features, SIR+ still works as a normal all-in-one plugin. If you want custom logic, it gives you a first-class addon pipeline instead of forcing you to patch the base jar.
Runtime layout
The stock SIR+ data folder looks like Modern SIR with one important extra branch:
plugins/SIR-Plus/
config.yml
bossbars.yml
webhooks.yml
users/
modules/
commands/
addons/
states.yml
my-addon.jar
back-ups/What is new compared to base SIR?
| Path or feature | Why it exists |
|---|---|
addons/ | Home for addon jars and addon state |
addons/states.yml | Persists enabled or disabled addon state |
/sir addons | GUI and CLI addon control |
/sir commands [provider] override [command] [state] | Per-command override control inside a provider |
SIRApi | Public API jar for custom addon projects |
Basic install flow
- Put the SIR+ jar in
plugins/. - Start the server once so
plugins/SIR-Plus/is generated. - Review the shared config and the stock
modules/andcommands/folders. - If you plan to extend the plugin, prepare the
addons/folder. - Drop addon jars into
plugins/SIR-Plus/addons/. - Restart or reload according to your testing flow.
If you are migrating from another stack instead of starting clean, do that before you begin custom addon work so your base data layout is stable.
Admin tools to learn first
The main command in SIR+ expands the base SIR admin tree with one more admin branch:
/sir modules/sir commands/sir addons/sir reload/sir migrate
The most important SIR+ additions are:
| Command | Purpose |
|---|---|
/sir addons | Opens the addon GUI on supported versions |
/sir addons [addon] [enable/disable/toggle] | Changes addon state from CLI |
/sir commands [provider] enabled [state] | Enables or disables a whole provider |
/sir commands [provider] override [command] [state] | Enables or disables override behavior for one command inside the provider |
Choose your next page
- Open Modules & Providers if you want the built-in feature inventory.
- Open Commands & Permissions if you are wiring staff permissions or checking overrides.
- Open Addon Runtime if you need the loader, descriptor, and state model.
- Open Addons API if you are ready to compile against
SIRApi. - Open Migration Guide if this server already runs Legacy SIR, Modern SIR, EssentialsX, or CMI.
Documentation Tree
Learn what SIR+ adds on top of SIR and where to start if you plan to work with addons.
Supported Plugins
Compatibility overview for the server plugins, migration sources, and ecosystems that matter to SIR+.
Last updated on