# Attachment

Attachments are items you can addon or "attach" to your guns. These will modify the stats of your weapon to change the damage, ammo, recoil, etc.

```yaml
Attachment:
  Priority: <priority> 
  Maximum_Stack_Amount: <amount>
  Item: <ItemSerializer>
  Denying:
    Attachments:
      - REQUIRE <attachment>
      - DENY <attachment>
    Mechanics: <Mechanics>
  Attach_Mechanics: <Mechanics>
  Detach_Mechanics: <Mechanics>
  Modifiers: <Modifier>
  Per_Weapon_Modifiers:
    <WeaponTitle>: <Modifier>
    <etc>: <Modifier>
  Armor_Modifiers: <Armor Modifier>
  Per_Armor_Modifiers:
    <ArmorTitle>: <Armor Modifier>
    <etc>: <Armor Modifier>
```

#### Priority

Priority decides the "priority" or order of the attachment when the weapon has multiple attachments. Lower numbers mean the modifiers are applied earlier. Higher numbers mean the modifiers are applied later. This means that when using `Set_Mechanics` and `Set` modifiers, a higher `Priority` can overwrite the effects of other attachments. You can use negative numbers if you would like.

<details>

<summary><strong>More information if you are confused...</strong></summary>

Let's say you have two attachments:

```yaml
# This is the low-priority attachment since 5 < 10
My_First_Attachment:
  Priority: 5
  Item:
    Type: IRON_NUGGET
    Name: "<yellow>My First Attachment"
  Modifiers:
    Damage_Modifier: 
      Damage: ADD 2.5  # adds 2.5 damage to the base amount

# This is the high-priority attachment since 10 > 5
My_Second_Attachment:
  Priority: 10
  Item:
    Type: IRON_NUGGET
    Name: "<yellow>My First Attachment"
  Modifiers:
    Damage_Modifier: 
      Damage: SET 5.2  # replaces the existing damage with 5.2 damage
```

If your weapon has both `My_First_Attachment` *and* `My_Second_Attachment`, the damage effects of `My_First_Attachment` are removed since `My_Second_Attachment` has a higher priority.

</details>

#### Maximum\_Stack\_Amount

This number decides how many copies of this attachment can be on the same weapon. Defaults to `1`.

#### Item

This is the item that the attachment appears as in the game. You will drag and drop this item onto your weapon to view the changes. Uses the [item serializer](https://github.com/WeaponMechanics/MechanicsMain/wiki/General#item-serializer).

#### Denying

This section allows you to prevent specific attachments from being used together. It also allows for having another attachment REQUIRED before using this attachment.

* `Attachments`
  * Use `REQUIRE` to require an attachment
  * Use `DENY` to prevent an attachment
* `Mechanics`
  * The [Mechanics](https://github.com/WeaponMechanics/MechanicsMain/wiki/Mechanics) to play when an attachment is denied.

#### Attach\_Mechanics

The [Mechanics](https://github.com/WeaponMechanics/MechanicsMain/wiki/Mechanics) to play when the attachment is added to a weapon.

**`Detach_Mechanics`**

The [Mechanics](https://github.com/WeaponMechanics/MechanicsMain/wiki/Mechanics) to play when the attachment is removed from a weapon.

#### Modifiers

The modifiers that change the weapon's damage, recoil, ammo, etc. If you want to have different modifiers per weapon, you can use `Per_Weapon_Modifiers`. Here is an example:

```yaml
My_Cool_Attachment:
  Item:
    Type: DIAMOND
    Name: "<#00ffff>My Cool Attachment"
  Modifiers:
    Damage_Modifier:
      Damage: ADD 0.5
  Per_Weapon_Modifiers:
    AK-47:
      Damage_Modifiers:
        Damage: ADD 1.5
```

In this example, the AK-47 weapon will deal 1.5 more damage instead of just 0.5 more.

#### Armor\_Modifiers

If you want this attachment to modify armor (It only works for \*armor attachments\*; weapon attachments cannot modify the armor). If you want different modifiers per piece of armor, you can use `Per_Armor_Modifiers` (See above for example using weapons instead of armors).&#x20;


---

# 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/weaponmechanicsplus/attachment.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.