BitAspire Wiki
SIR+SIR+

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:

  • /sir command aliases: sir-plus, sir+, sirplus, sirp
  • /sir addons support
  • addon enable or disable state persistence
  • provider command override controls
  • a public SIRApi artifact 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 featureWhy it exists
addons/Home for addon jars and addon state
addons/states.ymlPersists enabled or disabled addon state
/sir addonsGUI and CLI addon control
/sir commands [provider] override [command] [state]Per-command override control inside a provider
SIRApiPublic API jar for custom addon projects

Basic install flow

  1. Put the SIR+ jar in plugins/.
  2. Start the server once so plugins/SIR-Plus/ is generated.
  3. Review the shared config and the stock modules/ and commands/ folders.
  4. If you plan to extend the plugin, prepare the addons/ folder.
  5. Drop addon jars into plugins/SIR-Plus/addons/.
  6. 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:

CommandPurpose
/sir addonsOpens 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

Last updated on

On this page