Mana Attributes

This API adds a mana system controlled by entity attributes.

Default implementation

LivingEntities can have up to _manaattributes:maxmana amounts of mana. Mana is regenerated by _manaattributes:manaregeneration every _manaattributes:mana_tickthreshold ticks.

When mana is reduced, regeneration is stopped for _manaattributes:mana_regeneration_delaythreshold ticks.

When mana is <= 0, regeneration is stopped for _manaattributes:depleted_mana_regeneration_delaythreshold ticks.

_manaattributes:reservedmana describes the percentage amount of maximum mana that is currently not available.

Default attribute values

• _manaattributes:maxmana: 0
• _manaattributes:manaregeneration: 0
• _manaattributes:mana_tickthreshold: 20
• _manaattributes:mana_regeneration_delaythreshold: 20
• _manaattributes:depleted_mana_regeneration_delaythreshold: 60
• _manaattributes:reservedmana: 0

All default values for players can be set in the server config.

Customization

The client config allows customizing the HUD element.

Using the mana system

Java

Casting a "LivingEntity" to the "ManaUsingEntity" interface gives access to all relevant methods.

Data packs

Mana Attributes implements several data driven methods to interact with the current mana value of an entity.

• the "manaattributes:add_mana" enchantment effect allows adding a defined amount to the current mana
• the "manaattributes:mana_using_entity" entity sub predicate passes when the current mana of an entity matches the defined range

Example

This enchantment reduces mana of the attacker by 2, as long as the attacker has at least 5 mana:

{
    "anvil_cost": 1,
    "description": {
        "translate": "enchantment.manaattributes.test"
    },
    "effects": {
        "minecraft:post_attack": [
            {
                "affected": "attacker",
                "effect": {
                    "type": "manaattributes:add_mana",
                    "amount": {
                        "type": "minecraft:linear",
                        "base": -2.0,
                        "per_level_above_first": -2.0
                    }
                },
                "enchanted": "attacker",
                "requirements": {
                    "condition": "minecraft:entity_properties",
                    "entity": "direct_attacker",
                    "predicate": {
                        "type_specific": {
                            "type": "manaattributes:mana_using_entity",
                            "mana_amount": {
                                "min": 5.0
                            }
                        }
                    }
                }
            }
        ]
    },
    "max_cost": {
        "base": 25,
        "per_level_above_first": 8
    },
    "max_level": 1,
    "min_cost": {
        "base": 5,
        "per_level_above_first": 8
    },
    "slots": [
        "hand"
    ],
    "supported_items": "#minecraft:swords",
    "weight": 5
}