Stats

Introduction

Stats are values that affect all kinds of mechanics across Players, Mobs, Items, Skills, and more. While Stats system can be complicated to learn at first, its versatility will enable you to do very advanced things, such as combat changes, technical utilities, and the creation of new game design elements.

Stats are defined in thestats.yml file. This file can exist in the root directory of MythicMobs (/plugins/MythicMobs/) or in a Pack folder.

WARNING: To be able to use Stats on Items, Crucible must be installed

Custom Stat Options
Modifiers
Built In Stats
Implementations with Configurations
- Mobs
- Items
Examples
- Example Custom Stats

Custom Stat Options

Options that can be used in the Stat in order to better customize it

Option	Description
Enabled	If the stat is currently enabled
AlwaysActive	If the stat is forcefully applied to every registry of every entity
Type	The Type of the stat
Display	The name with which the stat is displayed
Formatting	How the stat is shown on items. Depends on the Modifier used
ShowInLore	Whether to show the tooltips formatting for each modifier
Priority	The priority with which the stat will take effect, compared to others. Lower values make it so the stat will trigger before stats with higher values
MinValue	Minimum value for the stat
MaxValue	Max value for the stat
Triggers	What triggers the stat effect. Can be any MythicMobs trigger, minus the "on" bit. (For instance: to use `onAttack`, one needs to write `ATTACK` as a trigger) As of v.5.4.0, only damaging triggers are available; keep an eye on dev builds for expanded functionality.
ParentStats	A list of other stats that this stat relies on
TriggerStats	A list of stats that the triggering entity may have and their FormulaKey, separated by a space. The FormulaKey can then be used in other Formulas to fetch its value from the trigger's. Here is an example
Formula	A formula for the base value if this stat has parent stats
FormulaKey	A key you can use in formulas, when this stat is the parent of another
BaseValue	A static base value if it doesn't have parents
ExecutionPoint	For stats that modify a trigger, can be `PRE` or `POST`. determines whether the stat is evaluated before or after any mechanics
Skills	The skills that get executed when the stat is activated

Custom Stat Types

The values that the Type Option can be set to

Type	Description
`STATIC`	A static value. Does nothing on its own, but can be referenced via placeholders
`DAMAGE_BONUS`	This stat adds a flat amount of bonus damage
`DAMAGE_MODIFIER`	Modifies the damage using a formula
`PROC`	A chance to execute skills

Specific Type Options

A list of options only available if the specified type is used in the stat

DAMAGE_MODIFIER

Option	Description
DamageType	Specify a custom damage type. Use `ALL` to modify the final total damage of the skill
Conditions	Specify conditions which can affect the Modifier
DamageFormula	Define a formula for how the damage is modified. See HERE for an example of this Some additional keys the damage formula can use are: - `d` to express the damage's original value - `v` to express the stat's value

DAMAGE_BONUS

Option	Description
DamageType	Specify a custom damage type

Tooltips Formatting

Formatting	Description
Additive	The tooltip to show for additive modifiers
Multiply	The tooltip to show for multiply modifiers
Compound	The tooltip to show for compound modifiers
Setter	The tooltip to show for setter modifiers
Rounding	The amount of numbers after the point in the value of the stat
ShowInItemLore	Whether the tooltips should be shown in an items's lore whenever `{stats-each}` is used. Defaults to true, overridden by the ShowInLore options if they are set

ShowInLore	Description
Additive	Whether to show the Additive modifier tooltip in an item's lore
Multiply	Whether to show the Multiply modifier tooltip in an item's lore
Compound	Whether to show the Compound modifier tooltip in an item's lore
Setter	Whether to show the Setter modifier tooltip in an item's lore

EXAMPLE_STAT:
  Enabled: true
  AlwaysActive: false
  Type: STATIC
  FormulaKey: 'SPD'
  Formatting:
    Additive: '+<value> Speed'
    Multiply: '+<value>% Speed'
    Compound: 'x<value>% Speed'
    Static: 'Force <value> <display>'
    Rounding: 2
  ShowInLore:
    Compound: false # optional

Modifiers

Modifiers can be used to adjust stats after their base value is defined.

Modifier	Description
`ADDITIVE`	Adds to the base value of a stat
`ADDITIVE_MULTIPLIER`	Adds a multiplier the base value of a stat
`COMPOUND_MULTIPLIER`	Multiplies the base value of a stat, then adds it to the base value
`SETTER`	Overrides all modifiers and base values, and forces the stat to be what is defined

Note that stat modifiers can be applied to and by mobs, players, items, enchants, and auras. For example, an item may add to or multiply its wielder's attack speed, while an attack may temporarily apply a COMPOUND MULTIPLIER to half a target's attack speed.

`ADDITIVE`

The ADDITIVE modifiers are straightforward: they add to the base stat.

`ADDITIVE_MULTIPLIER`

The ADDITIVE_MULTIPLIER multiply the value of the base stat by the specified value.
They all pool together (i.e. additive multipliers of 2 and 3 becoming a multiplier of 5, NOT 6) to then multiply the base stat after additives.

`COMPOUND_MULTIPLIER`

Finally, the COMPOUND_MULTIPLIER multiplies all the ADDITIVE results afterwards - this is a great place for to apply effect changes such as debuffs, since they would typically be calculated after additive stat additions and multipliers.

Stat Calculation

The two ADDITIVE_MULTIPLIER and COMPOUND_MULTIPLIER modifiers can be easy to mix up; however, this example should make it a bit more clear:

Lets say you have these modifiers:

 8 base value
 10 additive
 2 additive
 5 multiply
 3 multiply
 2 compound   (effectively x2)
 0.4 compound (effectively -60%)

...the resulting math MythicMobs would calculate this is as follows:

(8 + 10 + 2) * (5 + 3) * (2 * 0.4) = 128

(base + additive + additive) * (additive_multiplier + additive_multiplier) * (compound_multiplier * compound_multiplier) = final stat

Regular multipliers are additive, and compound multipliers are multiplicative. You can think of it as "+10%" for Additive Multipliers vs. "x10%" for Compound Multipliers.

Built-In Stats

These stats are inherently supported by MythicMobs, and can be configured in the stats.yml file in the plugin's root directory (/plugins/MythicMobs/) or inside Pack folders. (/plugins/MythicMobs/Packs/CoolPack/) The player inherits the BaseValue of these stats; Mobs also inherit them as defaults, unless overrides are specified in the Stats: sub-section of their config.

Stat	Description
ATTACK_DAMAGE	Base Damage Output
ATTACK_SPEED	Attack cooldown frequency. Typically only used for Players.
BONUS_DAMAGE	Additional Modifier for dealing extra damage
CRITICAL_STRIKE_CHANCE	Chance to land a Critical Strike (Chance-based Crit)
CRITICAL_STRIKE_DAMAGE	Damage dealt via Critical Strike
CRITICAL_STRIKE_RESILIENCE	Resistance to Critical Strike
DAMAGE_REDUCTION	Generic damage reduction
DEFENSE	Defense
DODGE_CHANCE	Chance for an attack to fail when attempting to damage. Reduced by opponent's DODGE_NEGATION.
DODGE_NEGATION	Reduces opponent's DODGE_CHANCE.
HEALTH	Health values
HEALTH_REGENERATION	Rate of Health Regeneration
LIFESTEAL_CHANCE	Chance for damage dealt to heal the attacker
LIFESTEAL_POWER	How much healing LifeSteal does.
MOVEMENT_SPEED	Movement Speed.
PARRY_CHANCE	Chance to mitigate and reflect damage from sources that melee you from the front. Reduced by opponent's PARRY_NEGATION.
PARRY_COUNTERATTACK	How much damage is returned to the opponent when parrying.
PARRY_POWER	How much damage is mitigated by Parry.
PARRY_NEGATION	Reduces the PARRY_CHANCE of the opponent.
SCALE	The scale of the entity
STEP_HEIGHT	The step height attribute
ARMOR	The armor attribute
ARMOR_TOUGHNESS	The armor toughness attribute
BURNING_TIME	The burning time attribute
EXPLOSION_KNOCKBACK_RESISTANCE	The explosion knockback resistance attribute
FALL_DAMAGE_MULTIPLIER	The fall damage multiplier attribute
GRAVITY	The gravity attribute
JUMP_STRENGTH	The jump strength attribute
KNOCKBACK_RESISTANCE	The knockback resistance attribute
MOVEMENT_EFFICIENCY	The movement efficiency attribute
OXYGEN_BONUS	The oxygen bonus attribute
SAFE_FALL_DISTANCE	The safe fall distance attribute
SNEAKING_SPEED	The sneaking speed attribute
WATER_MOVEMENT_EFFICIENCY	The water movement efficiency attribute
BLOCK_BREAK_SPEED	The block break speed attribute
BLOCK_INTERACTION_RANGE	The block interaction range attribute
ENTITY_INTERACTION_RANGE	The entity interaction range attribute
FLYING_SPEED	The flying speed of the entity
FOLLOW_RANGE	The follow range of the entity

Built-in Stats Breakdown

This is a detailed breakdown of the built-in stats provided by MythicMobs. For custom stats, see Custom Stat Examples.

`DODGE_NEGATION`

Chance for an attack to land damage. Reduces opponent's DODGE_CHANCE. As shown below, the displayed name and lore elements of a stat can be customized, such as 'Accuracy' instead of 'Dodge Negation'

Configuration

DODGE_NEGATION:
  Enabled: false
  AlwaysActive: false
  Display: 'Accuracy'
  Formatting:
    Additive: '+<value> Accuracy'
    Multiply: '+<value> Accuracy'
    Compound: 'x<value> Accuracy'
  BaseValue: 0

`ATTACK_DAMAGE`

Base Damage Output

Configuration

ATTACK_DAMAGE:
  Enabled: true
  AlwaysActive: false
  Display: 'Damage'
  Formatting:
    Additive: '+<value> Damage'
    Multiply: '+<value> Damage'
    Compound: 'x<value> Damage'
  BaseValue: 1

`ATTACK_SPEED`

Attack cooldown frequency. Typically only used for Players.

Configuration

ATTACK_SPEED:
  Enabled: true
  AlwaysActive: false
  Display: 'Attack Speed'
  Formatting:
    Additive: '+<value> Attack Speed'
    Multiply: '+<value> Attack Speed'
    Compound: 'x<value> Attack Speed'
  BaseValue: 4.0

`BONUS_DAMAGE`

Additional Modifier for dealing extra damage

Configuration

BONUS_DAMAGE:
  Enabled: false
  AlwaysActive: false
  Display: 'Bonus Damage'
  Formatting:
    Additive: '+<value> Bonus Damage'
    Multiply: '+<value> Bonus Damage'
    Compound: 'x<value> Bonus Damage'
  BaseValue: 0

`CRITICAL_STRIKE_CHANCE`

Chance to land a Critical Strike (Chance-based Crit)

Configuration

CRITICAL_STRIKE_CHANCE:
  Enabled: false
  AlwaysActive: false
  Display: 'Critical Strike'
  Formatting:
    Additive: '+<value> Critical Strike'
    Multiply: '+<value> Critical Strike'
    Compound: 'x<value> Critical Strike'
  BaseValue: 0
  MinValue: 0
  Skills:
  - particles{p=crit;a=50;hS=1;y=1;s=1} @trigger

`CRITICAL_STRIKE_DAMAGE`

Damage dealt via Critical Strike

Configuration

CRITICAL_STRIKE_DAMAGE:
  Enabled: false
  AlwaysActive: true
  Display: 'Critical Damage'
  Formatting:
    Additive: '+<value> Critical Damage'
    Multiply: '+<value> Critical Damage'
    Compound: 'x<value> Critical Damage'
  BaseValue: 1

`CRITICAL_STRIKE_RESILIENCE`

Resistance to Critical Strike

Configuration

CRITICAL_STRIKE_RESILIENCE:
  Enabled: false
  Display: 'Resilience'
  AlwaysActive: false
  Formatting:
    Additive: '+<value> Resilience'
    Multiply: '+<value> Resilience'
    Compound: 'x<value> Resilience'
  BaseValue: 0

`DAMAGE_REDUCTION`

Generic damage reduction

Configuration

DAMAGE_REDUCTION:
  Enabled: false
  AlwaysActive: false
  Display: 'Damage Reduction'
  Formatting:
    Additive: '+<value> Damage Reduction'
    Multiply: '+<value> Damage Reduction'
    Compound: 'x<value> Damage Reduction'
  BaseValue: 0

`DEFENSE`

Defense

Configuration

DEFENSE:
  Enabled: false
  AlwaysActive: false
  Display: 'Defense'
  Formatting:
    Additive: '+<value> Defense'
    Multiply: '+<value> Defense'
    Compound: 'x<value> Defense'
  BaseValue: 0

`DODGE_CHANCE`

Chance for an attack to fail when attempting to damage. Reduces opponent's ACCURACY.

Configuration

DODGE_CHANCE:
  Enabled: false
  AlwaysActive: false
  Display: 'Dodge'
  Formatting:
    Additive: '+<value> Dodge Chance'
    Multiply: '+<value> Dodge Chance'
    Compound: 'x<value> Dodge Chance'
  BaseValue: 0
  Skills: []

`HEALTH`

Health values

Configuration

HEALTH:
  Enabled: false
  AlwaysActive: true
  Display: 'Health'
  Formatting:
    Additive: '+<value> Health'
    Multiply: '+<value> Health'
    Compound: 'x<value> Health'
  BaseValue: 20
  MinValue: 1

`HEALTH_REGENERATION`

Rate of Health Regeneration

Configuration

HEALTH_REGENERATION:
  Enabled: false
  AlwaysActive: false
  Display: 'Health Regeneration'
  Formatting:
    Additive: '+<value> Regeneration'
    Multiply: '+<value> Regeneration'
    Compound: 'x<value> Regeneration'
  BaseValue: 0
  MaxValue: 1000000
  MinValue: 0
  Frequency: 60

`LIFESTEAL_CHANCE`

Chance for damage dealt to heal the attacker

Configuration

LIFESTEAL_CHANCE:
  Enabled: false
  AlwaysActive: false
  Display: 'Lifesteal Chance'
  Formatting:
    Additive: '+<value> Lifesteal Chance'
    Multiply: '+<value> Lifesteal Chance'
    Compound: 'x<value> Lifesteal Chance'
  BaseValue: 0

`LIFESTEAL_POWER`

How much healing LifeSteal does.

Configuration

LIFESTEAL_POWER:
  Enabled: true
  AlwaysActive: false
  Display: 'Lifesteal Power'
  Formatting:
    Additive: '+<value> Lifesteal Power'
    Multiply: '+<value> Lifesteal Power'
    Compound: 'x<value> Lifesteal Power'
  BaseValue: 0.1

`MOVEMENT_SPEED`

Movement Speed.

Configuration

MOVEMENT_SPEED:
  Enabled: false
  AlwaysActive: true
  Display: 'Movement Speed'
  Formatting:
    Additive: '+<value> Movement Speed'
    Multiply: '+<value>% Movement Speed'
    Compound: 'x<value>% Movement Speed'
  ParentStats:
  - SPEED
  Formula: '0.2 + (0.2 / (1 + e^(-0.005 * (SPD - 1000))))'

`PARRY_CHANCE`

Chance to mitigate and reflect damage from sources that melee you from the front.

Configuration

PARRY_CHANCE:
  Enabled: false
  AlwaysActive: false
  Display: 'Parry Chance'
  BaseValue: 0
  Priority: 0
  Formatting:
    Additive: '+<value> Parry Chance'
    Multiply: '+<value> Parry Chance'
    Compound: 'x<value> Parry Chance'
  FrontAngle: 180
  UsableMaterials:
    - WOODEN_SWORD
    - STONE_SWORD
    - GOLDEN_SWORD
    - IRON_SWORD
    - DIAMOND_SWORD
    - NETHERITE_SWORD
  Skills: []

`PARRY_COUNTERATTACK`

How much damage is returned to the opponent when parrying.

Configuration

PARRY_COUNTERATTACK:
  Enabled: false
  AlwaysActive: false
  Display: 'Parry Counterattack'
  BaseValue: 1
  Formatting:
    Additive: '+<value> Parry Counterattack'
    Multiply: '+<value> Parry Counterattack'
    Compound: 'x<value> Parry Counterattack'

`PARRY_NEGATION`

Affects and lowers the PARRY_CHANCE of the opponent. As shown below, the displayed name and lore elements of a stat can be customized, such as 'Expertise' instead of 'Parry Negation'

Configuration

PARRY_NEGATION:
  Enabled: false
  AlwaysActive: false
  Display: 'Expertise'
  Formatting:
    Additive: '+<value> Expertise'
    Multiply: '+<value> Expertise'
    Compound: 'x<value> Expertise'
  BaseValue: 0

`PARRY_POWER`

How much damage is mitigated by Parry.

Configuration

PARRY_POWER:
  Enabled: false
  AlwaysActive: false
  Display: 'Parry Power'
  BaseValue: 0.5
  Formatting:
    Additive: '+<value> Parry Power'
    Multiply: '+<value> Parry Power'
    Compound: 'x<value> Parry Power'

`SCALE`

The Scale of the entity

Configuration

SCALE:
  Enabled: false
  AlwaysActive: false
  Display: 'Scale'
  BaseValue: 1
  Formatting:
    Additive: '+<value> Scale'
    Multiply: '+<value> Scale'
    Compound: 'x<value> Scale'

Implementations with Configurations

It's important to be aware that players get all of their base stat values from the stats.yml file, while mobs get only some of their base values from the stats.yml file: if another value is specified as one of their stats, that is applied.

Mobs

This example features Some_Mob and three configured stats: CRITICAL_STRIKE_CHANCE as configured in the Stats: section, but also its Health and Damage. The Health and Damage stat types are natively handled in the typical format of a mob's configuration. Other stats that are configured on the mob are: ATTACK_DAMAGE, ATTACK_SPEED, and MOVEMENT_SPEED.

Some_Mob:
  Health: 50
  Damage: 10
  Stats:
  - CRITICAL_STRIKE_CHANCE 0.2

Items

ExampleItem:
  Id: BLAZE_ROD
  Display: 'Test'
  Stats:
  - CRITICAL_STRIKE_CHANCE 0.5 ADDITIVE
  - CRITICAL_STRIKE_DAMAGE 2.0 ADDITIVE
  - HEALTH 20to30 ADDITIVE

WARNING: To be able to use Stats on Items, Crucible must be installed

Examples

Example Custom Stats

These stats are created by the end user. Included are some examples.

`ARMOR_GENERIC`

Generic Armor based damage reduction. can be applied to gear.

ARMOR_GENERIC:
  Enabled: false
  AlwaysActive: false
  Type: DAMAGE_MODIFIER
  Triggers:
    - DAMAGED
  ExecutionPoint: PRE
  Display: 'Generic Armor'
  DamageFormula: 'd - v'
  BaseValue: 0
  Formatting:
    Additive: '+<value> Generic Armor'
    Multiply: '+<value> Generic Armor'
    Compound: 'x<value> Generic Armor'

`ARMOR_BLUNT`

Armor based damage reduction based on the BLUNT DamageType.

ARMOR_BLUNT:
  Enabled: false
  AlwaysActive: false
  Type: DAMAGE_MODIFIER
  Triggers:
    - DAMAGED
  ExecutionPoint: PRE
  Display: 'Blunt Armor'
  DamageType: BLUNT
  DamageFormula: 'd - v'
  BaseValue: 0
  Formatting:
    Additive: '+<value> Blunt Armor'
    Multiply: '+<value> Blunt Armor'
    Compound: 'x<value> Blunt Armor'

`ARMOR_SHARP`

Armor based damage reduction based on the SHARP DamageType.

ARMOR_SHARP:
  Enabled: false
  AlwaysActive: false
  Type: DAMAGE_MODIFIER
  Triggers:
    - DAMAGED
  ExecutionPoint: PRE
  Display: 'Sharp Armor'
  DamageType: SHARP
  DamageFormula: 'd - v'
  BaseValue: 0
  Formatting:
    Additive: '+<value> Sharp Armor'
    Multiply: '+<value> Sharp Armor'
    Compound: 'x<value> Sharp Armor'

`DAMAGE_BLUNT`

Damage Output for the BLUNT DamageType.

DAMAGE_BLUNT:
  Enabled: false
  AlwaysActive: false
  Type: DAMAGE_BONUS
  Priority: 1
  Triggers:
    - ATTACK
  ExecutionPoint: PRE
  Display: 'Blunt Damage'
  DamageType: BLUNT
  BaseValue: 0
  Formatting:
    Additive: '+<value> Blunt Damage'
    Multiply: '+<value> Blunt Damage'
    Compound: 'x<value> Blunt Damage'

`DAMAGE_SHARP`

Damage Output for the SHARP DamageType.

DAMAGE_SHARP:
  Enabled: false
  AlwaysActive: false
  Type: DAMAGE_BONUS
  Priority: 2
  Triggers:
    - ATTACK
  ExecutionPoint: PRE
  Display: 'Sharp Damage'
  DamageType: SHARP
  BaseValue: 0
  Formatting:
    Additive: '+<value> Sharp Damage'
    Multiply: '+<value> Sharp Damage'
    Compound: 'x<value> Sharp Damage'

`FIRE_RESISTANCE`

Configured to grant resistance to the FIRE, FIRE_TICK DamageCause.

FIRE_RESISTANCE:
  Enabled: false
  AlwaysActive: false
  Display: 'Fire Resistance'
  Formatting:
    Additive: '+<value> Fire Resistance'
    Multiply: '+<value> Fire Resistance'
    Compound: 'x<value> Fire Resistance'
  Type: DAMAGE_MODIFIER
  Triggers:
    - DAMAGED
  Conditions:
    - (damageCause FIRE || damageCause FIRE_TICK)
  ExecutionPoint: PRE
  DamageFormula: 'd * (1 - v)'
  MaxValue: 1
  MinValue: 0

`SPEED`

May be used in the MOVEMENT_SPEED stat calculation to affect speed with a formula.

SPEED:
  Enabled: true
  AlwaysActive: false
  Type: STATIC
  FormulaKey: 'SPD'
  Formatting:
    Additive: '+<value> Speed'
    Multiply: '+<value>% Speed'
    Compound: 'x<value>% Speed'

`ICE_DAMAGE`

Here is a more complex example that also involves TriggerStats

ICE_DAMAGE:
  Enabled: true
  Type: DAMAGE_MODIFIER
  Priority: 50
  Triggers:
    - ATTACK
  ExecutionPoint: PRE
  Display: '&f֍'
  DamageType: ALL
  BaseValue: 0
  TriggerStats:
  - LIGHTNING_DEFENSE LD
  - AIR_DEFENSE AD
  - EARTH_DEFENSE ED
  - FIRE_DEFENSE FD
  - AETHER_DEFENSE AE
  - VOID_DEFENSE VD
  DamageFormula: '1 + d * ( LD + AD - ED - FD + 0.5 * ( AE - VD ) ) / 100'
  Formatting:
    Rounding: 2
    Additive: '&a+<value>'
    Multiply: '&a+<value>%'
    Compound: '&ax<value>%'