# Enchantment Decay<\/p>\n
_Magic is an incredible force, coming from days of old, that allows you to improve your power over the world.
\nOne of the traces remaining of this ancient knowledge that you could stumble upon on your travels is Enchantments.
\nBut as time passed by, this knowledge eroded, and even that you may get from the few remains of the old civilisation
\nthat mastered this art isn’t even perfect. And yet, you were able to recreate it. You were able to put together
\nyour own enchanting table, and infuse the very power accumulated throughout your journey into your very tools.
\nBut as expected, all the knowledge you could accumulate is still lacking, and you realize that as you make use of
\nyour enchanted gear, the magic slowly wears off…_<\/p>\n
\u26a0\ufe0f this mod, as it stands, is highly unbalanced. Hence, any input about how to improve that would be gladly welcome.
\nPlease share those on the appropriate Github discussion<\/p>\n
## How it works<\/p>\n
Enchantments each have a more or less specific way to affect your life.
\nThis mod will hook itself on many occasions upon which enchants are used, and register their use as a potential
\nsource of decay.
\nHence, each time an enchantment affects your gameplay, there will be a chance it decays a small bit. And when the decay
\nreaches a certain level, the enchantment will go down a level, and the decay reset.<\/p>\n
You will be able to see the decay level of you tool next to the enchantment name. But as you will venture the world,
\nwhen you discover enchanted loot, there will be a chance it is _immune to decay_. You will recognize these occurences
\nwith a green `\u02e3` before the name.<\/p>\n
## How to configure<\/p>\n
In your game’s `config` folder, after the first launch, will be generated a `enchantment_decay.properties` file.
\nWithin this file, you will find everything you need to configure the mod.<\/p>\n
### Default values<\/p>\n
The configuration file includes a few default values for the mod to use, including:
\n * The **default max decay**: This value indicates how much can an enchantment decay, by default
\n * The **default decay probability**: This value indicates, out of a hundred, the probability for an enchantment to
\n decay upon use, by default. Set to 0 to disable all decay by default.
\n * The **loot decay probability**: This value indicates, out of a hundred, the probability for an enchantment
\n applied on some generated loot to already have some decay. This will not affect decay immune enchantments.
\n Set to 0 to disable all decay on generated loot.
\n * The **loot decay max percentile**: This value indicates the maximum percentile an enchantment generated
\n upon loot can be decayed, compared to the enchantment’s maximum decay.
\n * The **decay immune loot probability**: This value indicates, out of a hundred, the probability for an enchant applied
\n on some generated loot to be decay-immune.<\/p>\n
### Enchantment-specific values<\/p>\n
The configuration files also support some per-enchantment specific values: **Example:**<\/p>\n “`properties ## Enchantments control<\/p>\n This mod uses enchantment tags in order to work. Each tag corresponds to a potential source of decay (suc as `kill` for All of these enchantments are registered as `enchantment_decay:decay\/ You can simply make use of a datapack in order to overhaul or add to these tags, thus being able to change which The `blacklist` tag is the one and only exception, as it defines enchantments that cannot decay. ## Damage types<\/p>\n As of 1.20, Enchantment Decay also uses damage types, in order to apply decay on armor upon receiving certain types The used tags for this are all registered as `enchantment_decay:decay\/ ## Showcase<\/p>\n
\n * The **max decay**: registered as `decay.max.
\n instances of this very enchantment.
\n * The **decay probability**: registered as `decay.probability.
\n hundred, the probability for an instance of this enchantment to decay upon use.<\/p>\n
\ndecay.max.minecraft.efficiency=50
\ndecay.probability.minecraft.efficiency=8
\n“`
\nThe above example would make it so any instance of the vanilla Efficiency enchantment will be able to have up to 49
\nas a decay value before going down a level, and that upon each use, it will have a 8% chance to decay.<\/p>\n
\nkilling, `fall` for falling, `hurt` for getting hurt, `damage` for when the gear piece gets damaged, etc.)<\/p>\n
\n`data\/enchantment_decay\/tags\/enchantments\/decay\/` folder within a datapack.<\/p>\n
\nenchantment gets to decay on what occasion.<\/p>\n
\nBy default, this tag only contains curses.<\/p>\n
\nof damage. To do this, each decay source can be linked to a damage source tag, that will indicate whether the
\nsubject enchantments should be able to receive decay from such damage.<\/p>\n
\n`data\/enchantment_decay\/tags\/damage_type\/decay\/` folder within a datapack.<\/p>\n