Skip to content
JasperLorelai edited this page Mar 21, 2026 · 6 revisions

Description:

This section details the mana.yml file and all the options within it. The default mana.yml can be found here.

Configuration:

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:

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.

Example:

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

Clone this wiki locally