Attributes
An attribute is what a skill actually buffs. Each skill points at one attribute, and every level applies a modifier to it whose size is incrementPerLevel × level, combined using the skill's operation.
Operations
The operation decides how a level bonus combines with the attribute's value. It matches Minecraft's own attribute modifier operations:
| Operation | Meaning | Example (incrementPerLevel 0.02, level 10) |
|---|---|---|
add_value | Flat amount added to the attribute | +0.2 to the raw value |
add_multiplied_base | Percentage of the attribute's base value | +20% of the base value |
add_multiplied_total | Percentage of the final value, after other modifiers | +20% of everything else combined |
incrementPerLevel may be negative if you want a skill to reduce an attribute.
Custom Attributes
Vanilla Minecraft has no attribute for some effects, so Experience Skills adds three of its own (under the experienceskills namespace):
| Attribute | Used by | Effect |
|---|---|---|
swim_speed | Swim Speed skill | Increases movement speed while in water |
lure_speed | Fishing Speed skill | Reduces the wait before a fish bites |
fishing_luck | Fishing Luck skill | Improves the fishing loot table roll |
mining_luck | Mining Luck skill | Grant extra ore drop. Each level adds 0.2 to the drop count (rounded down), so you get +1 ore every 5 levels, up to +4 at level 20. |
pickaxe_mining_speed | Pickaxe Mining Speed skill | Grant extra ore drop. Each level adds 0.2 to the drop count (rounded down), so you get +1 ore every 5 levels, up to +4 at level 20. |
shovel_mining_speed | Shovel Mining Speed skill | Grant extra ore drop. Each level adds 0.2 to the drop count (rounded down), so you get +1 ore every 5 levels, up to +4 at level 20. |
axe_mining_speed | Axe Mining Speed skill | Grant extra ore drop. Each level adds 0.2 to the drop count (rounded down), so you get +1 ore every 5 levels, up to +4 at level 20. |
hoe_mining_speed | Hoe Mining Speed skill | Grant extra ore drop. Each level adds 0.2 to the drop count (rounded down), so you get +1 ore every 5 levels, up to +4 at level 20. |
These behave like any other attribute — the skill keeps a modifier on them in sync, and the mod implements what each one does.
Vanilla Attributes Used
The remaining built-in skills buff standard Minecraft attributes: Movement Speed, Block Break Speed, Attack Damage, Max Health, Jump Strength, Oxygen Bonus, Armor Toughness, Block Interaction Range and Entity Interaction Range.
For developers
When you register a new custom attribute for your own skill, Experience Skills will keep a modifier on it in sync for you — but you must still add the attribute to the player's AttributeSupplier and implement whatever it actually does. See Adding an Attribute.