# Damage Modifiers

Damage modifiers modify the amount of damage dealt based on my factors, like armor, enchantments, potions, movement, hit point, and entity type.

Every weapon, by default, uses the `Damage_Modifiers` section from config.yml. However, you might want your weapon to override those modifiers. Check out [#damage\_modifiers](https://cjcrafter.gitbook.io/weaponmechanics/weapon-modules/damage/..#damage_modifiers "mention") from the [](https://cjcrafter.gitbook.io/weaponmechanics/weapon-modules/damage "mention") module. 

```yaml
  Damage_Modifiers:
    Min: 20%   
    Max: 300% 
    Per_Armor_Point: -3%
    Armor:
      - IRON_HELMET -5%
    Enchantments:
      - projectile_protection -8%
      - protection -4%

    # Modifiers for where the bullet hits the body
    Head: +50%
    Body: +0%
    Arms: -20%
    Legs: -20%
    Feet: -50%
    Back: +20%

    # Moving targets are not braced for impact
    Sneaking: -5%
    Walking: +0%
    Swimming: +5%
    Sprinting: +5%
    In_Midair: +5%

    # Player holding a shield and facing the damage direction
    Shielding: -100%

    Entities:
      - ZOMBIE +50%
      - PLAYER -50%
    Potions:
      - weakness +10%
```

#### Min

The minimum percentage of damage. `0%` means it is *possible* for a bullet to deal 0 damage. You probably want to set this a bit higher, like `20%`. 

#### Max

The maximum percentage of damage. You should set this a bit higher then `100%`.

#### Per\_Armor\_Point

Gets the armor value of the damaged entity (includes the armor they are wearing, custom armor attributes, and per-entity armor attributes). Remember that full diamond armor is 20 armor points, so don't set this number too high (`-5%` is probably the highest you want to go).

#### Armor

A list of armor pieces and their hardcodes resistances.

{% hint style="warning" %}
This feature is hard to use correctly, so you should probably use [#per\_armor\_point](#per_armor_point "mention") instead.
{% endhint %}

#### Enchantments

A list of enchantments and their modifiers. The modifier is multiplied by the enchantment level. Use the [References #Enchantment](https://app.gitbook.com/s/IIUkVnlH40vVBzLhWWQ8/references#enchantment "mention") list.

The following example will do 8% less damage for each projectile protection level and 5% less for each level of protection. 

```yaml
    Enchantments:
      - projectile_protection -8%
      - protection -4%
```

{% hint style="warning" %}
In `1.12.2`, the enchantments use the [old format](https://helpch.at/docs/1.12.2/org/bukkit/enchantments/Enchantment.html).
{% endhint %}

#### Head

Headshot damage modifier (headshots deal high damage?)

#### Body

Body shot damage modifier (body shots deal medium damage?)

#### Arms

Arm shot damage modifier (arm shots deal less damage?)

#### Legs

Leg shot damage modifier (leg shots deal less damage?)

#### Feet

Foot shot damage modifier (foot shots do minor damage?)

#### Sneaking

Modify damage if the victim is sneaking (as if they are braced for impact).

#### Walking

Modify damage if the victim is walking.

#### Swimming

Modify damage if the victim is swimming in water.

#### Sprinting

Modify damage if the victim is sprinting.

#### In\_Midair

Modify damage if the victim is in the air when damaged. 

#### Shielding

Reduce incoming damage when the victim is blocking with their shield and facing the damage. 

#### Entities

A list of [entity](https://app.gitbook.com/s/IIUkVnlH40vVBzLhWWQ8/references#entity "mention") and modifiers. 

The following example does double damage to zombies:

```yaml
    Entities:
      - zombie 100%
```

#### Potions

A list of [potion-effect](https://app.gitbook.com/s/IIUkVnlH40vVBzLhWWQ8/references#potion-effect "mention") and modifier.

The following example does 10% more damage to entities with weakness.

```yaml
    Potions:
      - weakness +10%
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cjcrafter.gitbook.io/weaponmechanics/weapon-modules/damage/damage-modifiers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.