forked from nisovin/MagicSpells
-
Notifications
You must be signed in to change notification settings - Fork 71
Mana Configuration
JasperLorelai edited this page Mar 21, 2026
·
6 revisions
This section details the mana.yml file and all the options within it. The default mana.yml can be found here.
| Option | Description | Type | Default |
|---|---|---|---|
enable-mana-system |
Whether to use the native mana system. At more advanced levels of the plugin, you may consider replacing this with a custom variable system. | Boolean | true |
default-symbol |
The symbol to use for the chat-based mana bar. | String | "=" |
default-size |
The number of characters to use in chat to represent the mana bar. | Integer | 35 |
default-max-mana |
The maximum amount of mana to give the default user. | Integer | 100 |
default-starting-mana |
The default amount of starting mana to give the default user. | Integer | default-max-mana |
default-regen-amount |
How much mana to regen per regeneration tick. | Integer | 5 |
default-regen-interval |
The frequency of mana regeneration. | Integer | 20 |
default-prefix |
Ideally use default-bar-format since 4.0 Beta 19. The prefix to use for the chat-based mana bar. |
String | "Mana:" |
default-color-full |
Ideally use default-bar-format since 4.0 Beta 19. Color to use in the chat mana bar to represent filled mana. |
Color Code (without §) |
1 |
default-color-empty |
Ideally use default-bar-format since 4.0 Beta 19. Color to use in the chat mana bar to represent empty mana space. |
Color Code (without §) |
0 |
default-bar-format |
Since 4.0 Beta 19. Supports placeholders: full_segment, empty_segment, mana, and max_mana. Segment placeholders refer to a rank's symbol (default-symbol) repeated based on progress and bar size (default-size). |
Formatted Text | "<dark_aqua>Mana: {<dark_blue><full_segment></dark_blue><black><empty_segment></black>} [<mana>/<max_mana>]</dark_aqua>" |
show-mana-on-use |
Whether to display the mana bar in chat when the player uses it. | Boolean | false |
show-mana-on-regen |
Whether to display the mana bar in chat when regeneration ticks happen. | Boolean | false |
show-mana-on-hunger-bar |
Moves the mana bar to the player's hunger bar. | Boolean | false |
show-mana-on-action-bar |
Moves the mana bar to the player's action bar. | Boolean | false |
show-mana-on-experience-bar |
The standard location for mana. This moves the mana bar to the player's exp bar. Vanilla exp is not overwritten, only visually changed. Players retain their vanilla exp count even when it displays their mana. | Boolean | true |
modifiers |
Modifiers checked before mana regen if it was caused by a Mana Rank's regen-interval or by a ManaRegenSpell. |
Modifiers | |
ranks |
A config section containing the name of a mana rank and its configuration. | Config Section of Mana Ranks |
Mana ranks can be assigned using the Mana Ranks permission.
| Option | Linked To | Notes |
|---|---|---|
symbol |
default-symbol |
|
size |
default-size |
|
max-mana |
default-max-mana |
|
starting-mana |
default-starting-mana |
|
regen-amount |
default-regen-amount |
|
regen-empty |
default-regen-empty |
|
prefix |
default-prefix |
Ideally use bar-format since 4.0 Beta 19. |
color-full |
default-color-full |
Ideally use bar-format since 4.0 Beta 19. |
color-empty |
default-color-empty |
Ideally use bar-format since 4.0 Beta 19. |
bar-format |
default-bar-format |
Since 4.0 Beta 19. |
ranks:
master:
symbol: '='
size: 35
max-mana: 200
starting-mana: 200
regen-amount: 10
regen-interval: 20
adept:
symbol: '='
size: 35
max-mana: 150
starting-mana: 150
regen-amount: 7
regen-interval: 20
novice:
symbol: '='
size: 35
max-mana: 100
starting-mana: 100
regen-amount: 5
regen-interval: 20