> For the complete documentation index, see [llms.txt](https://cjcrafter.gitbook.io/weaponmechanics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cjcrafter.gitbook.io/weaponmechanics/weapon-modules/damage.md). # Damage ```yaml Damage: Base_Damage: Base_Explosion_Damage: Fire_Ticks: Enable_Owner_Immunity: Ignore_Teams: Armor_Damage: Mechanics: Head: Bonus_Damage: Mechanics: Body: Bonus_Damage: Mechanics: Arms: Bonus_Damage: Mechanics: Legs: Bonus_Damage: Mechanics: Feet: Bonus_Damage: Mechanics: Backstab: Bonus_Damage: Mechanics: Critical_Hit: Chance: <1-100> Bonus_Damage: Mechanics: Kill: Mechanics: Damage_Modifiers: # see below for more information Explosion: Damage_Modifiers: # see below for more information Dropoff: - ``` Damage is calculated by summing base damage, and then applying all [#damage-modifiers](#damage-modifiers "mention"). #### Base\_Damage The amount of damage before any damage modifiers are applied. #### Base\_Explosion\_Damage The amount of damage the [Explosion](/weaponmechanics/weapon-modules/explosion.md) deals (at the center of the explosion). #### Fire\_Ticks Lights the damaged entity on fire for a set amount of time (time in ticks). For example, `Fire_Ticks: 100` will light the entity on fire for 5 seconds if a projectile from this weapon OR the explosion hits it). #### Enable\_Owner\_Immunity Use `true` to prevent the shooter from taking damage from their shots. This makes the shooter immune to their own [Explosion](/weaponmechanics/weapon-modules/explosion.md). #### Ignore\_Teams By default, guns will respect teams that prevent damage (Teams are added by Minecraft using the `/team` command). Use `Ignore_Teams: true` to enable friendly fire. #### Armor\_Damage Defines how much damage to apply to the victim's armor. You probably want this number to be small, like `1` or `2`. #### Mechanics The mechanics to trigger when damaging an entity. Use the [Mechanics](https://cjcrafter.gitbook.io/mechanics/) wiki. * `@Source{}` -> The shooter. * `@Target{}` -> The entity being damaged (the victim). #### Head * `Bonus_Damage` -> Defines how much additional damage head shots deal. * `Mechanics` -> Mechanics to trigger after a head shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was shot in the head. #### Body * `Bonus_Damage` -> Defines how much additional damage body shots deal. * `Mechanics` -> Mechanics to trigger after a body shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was shot in the chest. #### Legs * `Bonus_Damage` -> Defines how much additional damage leg shots deal. * `Mechanics` -> Mechanics to trigger after a leg shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was shot in the legs. #### Feet * `Bonus_Damage` -> Defines how much additional damage a foot shot deals. * `Mechanics` -> Mechanics to trigger after a foot shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was shot in the foot. #### Backstab Backstabs happen whenever the damage source comes from behind (In the $$180^{\circ}$$ area behind the victim). * `Bonus_Damage` -> Defines how much additional damage a foot shot deals. * `Mechanics` -> Mechanics to trigger after a foot shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was backstabbed. #### Critical\_Hit * `Chance` -> Chance for a critical hit. Use `100` for 100% chance. * `Bonus_Damage` -> Defines how much additional damage a foot shot deals. * `Mechanics` -> Mechanics to trigger after a foot shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was critically hit. #### Kill * `Mechanics` -> Mechanics to trigger after a foot shot. * `@Source{}` -> The shooter. * `@Target{}` -> The entity who was shot in the foot. #### Damage\_Modifiers The [#damage\_modifiers](#damage_modifiers "mention") to override the base damage modifiers (Defined in the `config.yml`). #### Explosion.Damage\_Modifiers The [#damage\_modifiers](#damage_modifiers "mention") to override the base damage modifiers but for explosions (Defined in the `config.yml`). #### Dropoff Defines how much projectile travel distance will increase or decrease damage. * `travel distance` * How far must the projectile go before this dropoff activates? * If the projectile has traveled `9` blocks and this list only has `10 -3`, then damage won't be decreased by `3` since that `10` blocks wasn't reached. * See [#100](https://github.com/WeaponMechanics/MechanicsMain/issues/100) if you want a "smooth" dropoff instead. * `damage amount` * The amount to increase (`+`) or decrease (`-`) damage. * This number should probably *always* be negative since you want projectiles to deal less damage --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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.md?ask= ``` 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.