Top-Level Options
linked-inventory
Name of the inventory config opened by /boosters.
default-stacking-mode
Default stacking mode for booster types that do not define their own override.
Recommended values:
allow-permanent-with-temporary
Controls whether a temporary booster may be active while a permanent booster of the same type already exists.
notify-on-expiry
If enabled, players receive an expiry message when a temporary booster ends.
auto-save-interval
How often active boosters are saved to storage. The module already saves on disconnect, but htis setting may be helpful incase of a unexpected crash.
expiration-check-interval
How often the system scans for expired boosters. This can be tweaked for performance, entirely up to you.
Formatting template used for booster list placeholders and menu-style displays.
list-no-boosters
Fallback line shown when the player has no active boosters.
max-stack-count
The maximum number of boosters of the same type a player can have active at once.
For example, if this is 1, a player cannot hold multiple active boosters of that same type unless the stacking mode allows extending the existing one.
Optional cap for advanced booster setups.
For most servers, this can be left at the default unless you are intentionally allowing larger stacked boosts.
Optional duration cap for advanced setups.
Useful if you want to stop players from building extremely long booster durations.
booster-type-overrides
Use this section to override stacking and limits for specific booster types.
If a type has no override, it inherits the defaults above.
Recommended modes
Prevents a player from activating another temporary booster of the same type while one is already active.
This is a good choice when you want boosters to be controlled and predictable.
If the player already has that booster type active, using another one increases the remaining duration instead of creating a new separate active effect.
This is a good choice for currency boosters like money or souls.
Placeholder Prefixes
The placeholder-settings section lets you define the %prefix% used in booster lists for each booster type.
