Configuration
Main Config
config.yml controls global behavior.
| Option | Description |
|---|---|
language | Message and generated config language. |
max-level | Global maximum upgrade level. |
upgrade-cooldown | Cooldown in seconds between upgrade attempts. |
storage.type | Player data storage backend. |
name-suffix.enabled | Whether upgraded items receive a visible level suffix. |
name-suffix.format | Text format appended to the item name. |
name-suffix.repeat-symbol | Symbol used by {symbol} and {stars} placeholders. |
Storage
storage:
type: FILE
Supported values:
| Value | Behavior |
|---|---|
FILE | Stores player data in local YAML files. |
SQLITE | Stores player data in a local SQLite database. |
DATABASE | Uses the shared MySQL or MariaDB settings from database.yml. |
MYSQL / MARIADB | Accepted as compatibility aliases for DATABASE. |
Use database.yml when using a shared database backend.
Name Suffix
name-suffix:
enabled: true
format: " &e[+{level}]"
repeat-symbol: "★"
Supported placeholders:
| Placeholder | Meaning |
|---|---|
{level} | Current upgrade level. |
{count} | Current upgrade level. |
{symbol} | The configured repeat-symbol. |
{stars} | repeat-symbol repeated by level. |
Failure Penalty
failure-penalty:
enabled: true
level-drop-threshold: 5
level-drop-amount: 1
item-destruction:
enabled: false
destruction-threshold: 8
destruction-chance: 0.3
When enabled, failed upgrades can drop levels after the configured threshold. Optional item destruction can be enabled for high-risk upgrade ranges.
Feedback
failure-feedback controls title feedback after failure.
feedback-sounds controls success, failure, level-drop, and item-destroyed sounds. Sound names support Bukkit enum names and namespaced custom sound keys:
feedback-sounds:
success:
enabled: true
name: "ENTITY_PLAYER_LEVELUP"
volume: 1.0
pitch: 1.0
MMOItems Native Upgrade Compatibility
mmoitems-upgrade-compat:
enabled: false
native-upgrade-coexist: false
use-item-max-level: true
stat-source: TEMPLATE
This section controls compatibility with MMOItems' native upgrade data.
| Option | Description |
|---|---|
enabled | Uses MMOItems UpgradeTemplate behavior when enabled. |
native-upgrade-coexist | Keeps MMOItems native upgrade and plugin upgrade as separate systems when enabled. |
use-item-max-level | Uses the item's own MMOItems max-level data when available. |
stat-source | TEMPLATE uses MMOItems templates; PLUGIN uses contents/upgrade-gains/ while syncing level data. |
Keep this disabled when you want MMOitemsUpgrade to be the primary upgrade system and only use its configured gains.