Skip to content

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:

OperationMeaningExample (incrementPerLevel 0.02, level 10)
add_valueFlat amount added to the attribute+0.2 to the raw value
add_multiplied_basePercentage of the attribute's base value+20% of the base value
add_multiplied_totalPercentage 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 its own, under the experienceskills namespace:

AttributeEffectDefaultSkill
Lure Speed
lure_speed
Added to your cast's Lure level, so fish bite sooner. Only whole points count.0
0–1,024
Fishing Speed Experience Bottle
Fishing Luck
fishing_luck
Added to your cast's Luck of the Sea level for better loot. Only whole points count.0
0–1,024
Fishing Luck Experience Bottle
Swim Speed
swim_speed
Multiplies how fast you move and rise while swimming.1
0–1,024
Swim Speed Experience Bottle
Mining Luck
mining_luck
Extra items from every ore broken, rounded down: 0.2 per level is +1 drop every 5 levels.0
0–1,024
Mining Luck Experience Bottle
Pickaxe Mining Speed
pickaxe_mining_speed
Multiplies mining speed while holding a pickaxe.1
0–1,024
Pickaxe Breaking Speed Experience Bottle
Shovel Mining Speed
shovel_mining_speed
Multiplies mining speed while holding a shovel.1
0–1,024
Shovel Breaking Speed Experience Bottle
Axe Mining Speed
axe_mining_speed
Multiplies mining speed while holding an axe.1
0–1,024
Axe Breaking Speed Experience Bottle
Hoe Mining Speed
hoe_mining_speed
Multiplies mining speed while holding a hoe.1
0–1,024
Hoe Breaking Speed Experience Bottle
Floating Mining Speed
floating_mining_speed
Eases the off-ground mining penalty. Vanilla divides mining speed by 5 while you are not on the ground; each point lowers that divisor by 1, so 4 removes it.0
0–4
Floating Breaking Speed Experience Bottle

These behave like any other attribute: the skill keeps a modifier on them in sync, and the mod implements what each one does. Other mods and commands such as /attribute can read and change them too.

Vanilla attributes used ​

The remaining built-in skills buff standard Minecraft attributes: Movement Speed, Attack Damage, Max Health, Jump Strength, Oxygen Bonus, Armor Toughness, Submerged Mining Speed, Block Interaction Range and Entity Interaction Range.

For developers

When you register a new custom attribute with ExperienceSkillsAPI.registerAttribute, Experience Skills adds it to players and keeps the skill's modifier on it in sync. You still have to implement whatever the attribute actually does. See Adding an attribute.

Released under the MIT License.