Mana Attributes

Mana Attributes

This API adds a mana system controlled by entity attributes.

Default implementation

LivingEntities can have up to _manaattributes:max_mana_ amounts of mana. Mana is regenerated by _manaattributes:mana_regeneration_ every _manaattributes:mana_tick_threshold_ ticks.

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

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

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

Default attribute values

• _manaattributes:max_mana_: 0
• _manaattributes:mana_regeneration_: 0
• _manaattributes:mana_tick_threshold_: 20
• _manaattributes:mana_regeneration_delay_threshold_: 20
• _manaattributes:depleted_mana_regeneration_delay_threshold_: 60
• _manaattributes:reserved_mana_: 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
}