# Weapon System

## Overview

Weapons are responsible for these gameplay actions:

1. Reloading
2. Changing fire modes
3. Equip/UnEquip animations
4. Firing

The functions above are implemented in the **FPSWeapon** component:

<figure><img src="/files/4X4oaifSedXyBj7UlRv2" alt="" width="400"><figcaption><p>FPSWeapon component.</p></figcaption></figure>

<figure><img src="/files/3QNlNhYshMPJGHTiPOPJ" alt="" width="399"><figcaption><p>Weapon settings.</p></figcaption></figure>

1. **Character Controller**: override controller for this weapon.
2. **Recoil Anim Data**: procedural recoil settings.
3. **Camera Shake**: recoil camera shakes.
4. **Ik Offset**: translation offset for the arms.
5. **Left Clavicle Offset**: translation offset for the left arm.
6. **Right Clavicle Offset**: translation offset for the right arm.
7. **Aim Point Offset**: translation offset for the aiming socket.
8. **Right Hand Sprint Offset**: rotation offset activated when tactical sprinting.
9. **Ads Blend**: blend between absolute and additive aiming.
10. **Fire Rate**: in rounds-per-minute.
11. **Ammo**: default ammo size.
12. **Aim Fov**: field-of-view when aiming.
13. **Full Auto**: whether the weapon supports full auto.
14. **Use Fire Clip**: whether to use firing animation.
15. **Has Equip Override**: whether to use custom equip animation.
16. **Has Fire Out**: whether to lock the bolt after firing.
17. **Use Sprint Trigger Discipline**: whether to use gun safety when sprinting.
18. **Fire Sounds**: firing sounds played randomly.
19. **Fire Pitch Range**: range for the pitch.
20. **Fire Volume Range**: range for the volume.
21. **Weapon Event Sounds**: reloading sounds played via animation events.

## Weapon mesh

The weapon model has these components:

<figure><img src="/files/hky3PnjLeSFzUkUbuvTv" alt="" width="400"><figcaption><p>Model components.</p></figcaption></figure>

**Animator** is used to animate gun parts (bolt, mag, etc.), which are automatically synced with the character's movements.

**FPS Bone Visibility** is responsible for hiding or unhiding bones, based on animation events.

**FPS Weapon Sound** plays sounds related to the weapon (e.g. reloading, firing).


---

# 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://kinemation.gitbook.io/fps-animation-pack-unity/gameplay/weapon-system.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.