> For the complete documentation index, see [llms.txt](https://docs.infimagames.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infimagames.com/product/tactical-fps-animation-packs/guides-and-tutorials/editor/firing-running-dry-and-jams.md).

# How to Set Up Firing, Running Dry and Jams

Change how one of our weapons fires, jams and runs dry, such as a burst-only version or one that jams often, and fit a silencer, then see it in the showcase.

{% hint style="info" %}
This page is about our demo showcase Blueprints. The Blueprints are mainly meant for showcase purposes, and aren't intended to be used as an FPS template out of the box.
{% endhint %}

#### Table of Contents

* [Introduction](#introduction)
* [Before You Start](#before-you-start)
* [Make a Burst-Only Weapon](#make-a-burst-only-weapon)
* [Make the Weapon Jam More Often](#make-the-weapon-jam-more-often)
* [Make a Weapon That Never Runs Dry](#make-a-weapon-that-never-runs-dry)
* [Fit a Silencer](#fit-a-silencer)
* [Racking the Weapon](#racking-the-weapon)
* [Trigger Discipline](#trigger-discipline)

***

### Introduction

***

In this guide, I'll show you how to change the way one of our weapons fires, jams and runs dry, and how to fit a silencer. I'll use the Pistol. The Assault Rifle works the same way.

{% hint style="info" %}
The pack doesn't include hit detection, damage or gameplay ammo, since it's an art pack. The round count only drives the animations, such as the animated magazine, the empty reloads and the locked slide. See "Where do I add hit detection and damage?" in the [FAQ](https://docs.infimagames.com/product/tactical-fps-animation-packs/getting-started/faq.md).
{% endhint %}

***

### Before You Start

***

1. Duplicate `DA_TFA_Pistol` into a folder of your own. It's in `Weapons/Pistol/Demo/Data`.
2. In `L_TFA_Pistol_Showcase`, select the character.
3. Set its **WeaponComponent**'s **Weapon Config** to your copy.

{% hint style="warning" %}
Work in your own copy. An update can replace the original.
{% endhint %}

Step by step: [How to Customize a Weapon's Settings and Fit a Scope](https://docs.infimagames.com/product/tactical-fps-animation-packs/guides-and-tutorials/editor/add-a-weapon-and-scopes.md#customize-a-weapons-settings)

***

### Make a Burst-Only Weapon

***

{% stepper %}
{% step %}

#### Set the Fire Modes

1. Open your copy of the data asset.
2. Under **Weapon > Firing**, set **Fire Modes** to two entries, **Safety** and **Burst**.

<div align="left" data-with-frame="true"><figure><img src="https://3271331258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuuZjeeFspZ4mvcxHpS6M%2Fuploads%2FWnJIREST2WuA822YFHU8%2FSL-FIR-01.png?alt=media&amp;token=7bea1d71-5339-4f7e-9ba8-d7cbbdc37449" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Check the Burst Count

**Burst Count** is how many rounds each trigger pull fires in Burst. The Pistol already has 3.
{% endstep %}

{% step %}

#### Test It in Play

1. Hit **Play**.
2. Press **V** until you're in Burst. The weapon starts in Semi.
3. Pull the trigger.

The Pistol fires three rounds per pull, paced by **Fire Rate RPM**.
{% endstep %}
{% endstepper %}

<details>

<summary>The firing fields</summary>

The firing fields are under **Weapon > Firing**, apart from Consumes Ammo, which is under **Weapon > Magazine (Cosmetic)**.

| Field                                            | What it does                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Fire Modes**                                   | The modes V steps through in the showcase, in order. Safety, Semi and Auto on our weapons. Remove Auto for a semi-only weapon, add **Burst** for burst fire.                                                                                                                                           |
| **Burst Count**                                  | Rounds per trigger pull in Burst.                                                                                                                                                                                                                                                                      |
| **Fire Rate RPM**                                | The pace of Auto and Burst.                                                                                                                                                                                                                                                                            |
| **Uses Recoil**                                  | The weapon kick, with the values under Procedural Offsets > Recoil and Recoil Spring.                                                                                                                                                                                                                  |
| **Uses Muzzle Flash**, **Muzzle Flash System**   | The muzzle flash.                                                                                                                                                                                                                                                                                      |
| **Consumes Ammo** (Weapon > Magazine (Cosmetic)) | Each shot takes a round from the magazine.                                                                                                                                                                                                                                                             |
| **Live Round Eject Force Scale**                 | Multiplies the eject force for a live round thrown out by a rack or a jam clear. A live round is much lighter than a casing, so it flies faster at the same force. Set it to the live round's mass divided by the casing's mass. Ours are 0.103 (Pistol) and 0.114 (Assault Rifle). 1 changes nothing. |

The fire mode switch plays on top of whatever is playing, so switching right after a reload doesn't cut it off. The flash and the shots leave the muzzle of the fitted handguard or barrel when that part has its own muzzle socket, and the receiver's **Socket Muzzle** otherwise.

</details>

***

### Make the Weapon Jam More Often

***

{% stepper %}
{% step %}

#### Raise the Malfunction Chance

In your copy, under **Weapon > Malfunctions**, set **Malfunction Chance** to 0.5, one shot in two. The Pistol ships with 0.05, one shot in 20.

<div align="left" data-with-frame="true"><figure><img src="https://3271331258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuuZjeeFspZ4mvcxHpS6M%2Fuploads%2FkgDyee94fl8frwf8LCey%2FSL-FIR-02.png?alt=media&amp;token=b277b8cd-57f4-4169-ae93-362079895cdb" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Test It in Play

1. Hit **Play**.
2. Fire a few rounds until the weapon jams.
3. Press **R** to clear it.

A jammed weapon holds its jammed pose with the casing stuck in the port, and the trigger only dry fires.

<div align="left"><figure><img src="https://3271331258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuuZjeeFspZ4mvcxHpS6M%2Fuploads%2FZXWinPF1LwxV8XRrSswJ%2FSL-FIR-03.png?alt=media&amp;token=090512fa-6012-47b9-adc7-07913f31f460" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

* To turn the random jams off, set **Malfunction Chance** to 0.
* **J** jams the weapon on demand in the showcase.

| Weapon        | Malfunctions                                   | Rack-only clear |
| ------------- | ---------------------------------------------- | --------------- |
| Pistol        | TapRack, Stovepipe, DoubleFeed, StovepipeQuick | Rack, on **K**  |
| Assault Rifle | TapRack, MagSwipe                              | Rack, on **K**  |

<details>

<summary>How jams work</summary>

| Where                             | Field                                   | What it does                                                                                                                                                                                                                                  |
| --------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data asset, Weapon > Malfunctions | **Malfunction Chance**                  | The chance per shot. 0 means never. The Pistol uses 0.05, one shot in 20, and the Assault Rifle about 0.033, one in 30.                                                                                                                       |
| Data asset, Weapon > Malfunctions | **FP and TP WEP Malfunction Jam Poses** | The weapon pose held while jammed, in the same order as the malfunction lists. Our weapons use the first frame of each clear.                                                                                                                 |
| Data asset, Weapon > Malfunctions | **Malfunction Sounds**                  | A sound per malfunction, in the same order as FP Malfunctions, played at the ejection port when the weapon jams. Leave an entry empty for no sound. The Pistol's two stovepipes have one, and so do the Assault Rifle's TapRack and MagSwipe. |
| Weapon Component, Options         | **Random Malfunctions**                 | Turns the random jams on or off for this character.                                                                                                                                                                                           |

* Any reload, the magazine check, a rack (K) and Play Malfunction clear the jam with the clear for that jam. A clear that plays to its end takes the stuck round. A clear that is cut short leaves the weapon jammed.
* While jammed, every other action is refused, and so are switching weapons, holstering, the grip and the fire mode. Aiming, moving and switching views still work.
* The last round never jams, and a jam never repeats the previous malfunction.
* If the end of a reload is still playing when the weapon jams, the jam blends it out and shows the main magazine, so a jam never leaves a magazine floating.
* The Pistol has scoped versions of its jam clears, made for its own scope. They play on their own while the scope is fitted.

</details>

***

### Make a Weapon That Never Runs Dry

***

By default, after the last round the trigger only dry fires, the Pistol's slide locks back, and a reload refills the magazine.

{% stepper %}
{% step %}

#### Untick Runs Dry

In your copy, under **Weapon > Empty Weapon**, untick **Runs Dry**.

<div align="left" data-with-frame="true"><figure><img src="https://3271331258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuuZjeeFspZ4mvcxHpS6M%2Fuploads%2FUmVu5dJfth0eImI939Y7%2FSL-FIR-04.png?alt=media&amp;token=ff181581-fab4-4806-b9cb-bd106bd6966c" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Test It in Play

1. Hit **Play**.
2. Keep firing.

The weapon refills itself, so the slide never locks and the empty reload never plays.
{% endstep %}
{% endstepper %}

<details>

<summary>How running dry and the locked slide work</summary>

Our reload montages mark the moment the new magazine reaches the well with an `AN_TFA_ActionEvent` whose **Event Name** is `MagazineSeated`. The weapon refills on that frame, so the round count, the empty state and the chambered round all change there.

* A reload cut short before the magazine seats refills nothing. One cut short after it stays full.
* An empty reload cut short after the magazine seats, before the slide or bolt is released, ends loaded with the slide or bolt forward.

| Field                  | What it does                                                                                            |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| **WEP Empty Pose**     | A pose of the receiver that holds the slide or bolt back after the last round, until a reload.          |
| **Releases Slide**     | Actions that let the slide go, such as the Pistol's empty holster.                                      |
| **Locks Slide**        | Actions that end with the slide locked, such as the Pistol's empty draw.                                |
| **Blocked when Empty** | Actions that don't play at all while the slide is locked, such as the Pistol's inspect and malfunction. |

While the slide is locked, Reload and Reload Quick play the empty reload. An action with an `<Action>_Empty` entry in **Actions** plays that instead, such as the rifle's `Inspect_Empty` and the Pistol's `Holster_Empty` and `Equip_Empty`.

</details>

***

### Fit a Silencer

***

Both weapons come with a silencer, `SM_TFA_Pistol_ATT_Silencer` and `SM_TFA_AR_ATT_Silencer`. Their data assets already have the silenced sounds set.

{% stepper %}
{% step %}

#### Set Mesh Silencer

In your copy, under **Meshes > Weapon**, set **Mesh Silencer** to `SM_TFA_Pistol_ATT_Silencer`.

<div align="left" data-with-frame="true"><figure><img src="https://3271331258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuuZjeeFspZ4mvcxHpS6M%2Fuploads%2F7qcGmhONVrWKsanbknxa%2FSL-FIR-05.png?alt=media&amp;token=fa40f0a0-d944-4363-84d8-7ec79b2ed772" alt="" width="470"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Test It in Play

1. Hit **Play**.
2. Fire.

The shot leaves the tip of the silencer, with the silenced flash and sound. In the showcase, **N** can fit the silencer too.
{% endstep %}
{% endstepper %}

<details>

<summary>The silencer fields</summary>

| Field                                                  | What it does                                                                                                 |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| **Muzzle Flash System Silenced**                       | The flash while a fitted silencer is the muzzle. Left empty, the normal flash plays from the tip of the can. |
| **FP Fire Sound Silenced**, **TP Fire Sound Silenced** | The shot sound with a silencer.                                                                              |
| **FP Fire Tail Silenced**, **TP Fire Tail Silenced**   | Optional. The tail with a silencer. Leave it empty if your silenced shot sound has its tail built in.        |

The shot sounds come from `AN_TFA_FireSound` notifies in the weapon fire montage. They play the normal sounds until a silencer is fitted, then the silenced ones. Each view has its own fields, so first person uses the FP ones and third person the TP ones.

</details>

***

### Racking the Weapon

***

Press **K** in the showcase to rack the weapon by hand.

* The round in the chamber flies out as a live round, the next one chambers, and the magazine loses one round.
* Racking the last round locks the slide back.
* Racking a jammed weapon clears the jam.
* Nothing plays while the slide is locked.

<details>

<summary>Where the rack comes from</summary>

The rack is the data asset's **Rack** entry in **Actions**, so a weapon without one doesn't rack. The Pistol also has a `Rack_Scope` entry for when its scope is fitted. Both our weapons list Rack in **Blocked when Empty**. The round that flies out comes from the `AN_TFA_EjectRound` notify in the rack montage (see [How to Use the Demo Animation Notifies & States](https://docs.infimagames.com/product/tactical-fps-animation-packs/guides-and-tutorials/editor/how-to-use-the-demo-animation-notifies-and-states.md)).

</details>

***

### Trigger Discipline

***

Leave the weapon idle in the showcase and the finger comes off the trigger, after 2 to 6 seconds with the Pistol (2 to 8 with the Assault Rifle).

* It stays off until you do something. Walking, running and looking don't bring the finger back.
* Aiming, a tactical sprint (Left Alt), firing or any action brings it back.
* To turn it off for a weapon, clear **FP Trigger Discipline Safe** in your copy. It's under **Animation > Trigger Discipline**.

<details>

<summary>The trigger discipline fields</summary>

| Field                                      | What it does                                                                                                                              |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **FP and TP Trigger Discipline Safe**      | The finger coming off the trigger.                                                                                                        |
| **FP and TP Trigger Discipline Safe Pose** | The held pose with the finger off.                                                                                                        |
| **FP and TP Trigger Discipline Ready**     | The finger going back on.                                                                                                                 |
| **Trigger Discipline Idle Min**, **Max**   | The random idle time before it plays. A data asset made from scratch has 6 to 12 seconds, the Pistol 2 to 6 and the Assault Rifle 2 to 8. |

An empty third person field uses the first person animation. Both our weapons only have first person trigger discipline animations, which only move the trigger finger, so one animation works in both views. With **Fire Waits for Ready** (Weapon Component, Options) ticked, the first shot waits for the Ready animation. It's off by default, so the shot fires at once.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.infimagames.com/product/tactical-fps-animation-packs/guides-and-tutorials/editor/firing-running-dry-and-jams.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
