> 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/grips-and-canted-aim.md).

# How to Set Up Grips and Canted Aim

Add a grip of your own to one of our weapons, with its own left hand pose, and change how far the weapon tilts in canted aim, then see both 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)
* [Add Your Own Grip](#add-your-own-grip)
* [Change the Canted Aim](#change-the-canted-aim)
* [Actions That Bring the Weapon Upright](#actions-that-bring-the-weapon-upright)

***

### Introduction

***

In this guide, I'll show you how to add a grip of your own, with its own left hand pose, and how to change the canted aim. I'll use the Assault Rifle.

A grip is a foregrip mesh or a way of holding the weapon without one. The weapon's own poses are the default hold.

| Weapon        | Grips                                                           |
| ------------- | --------------------------------------------------------------- |
| Assault Rifle | The default hold, **Vertical** and **Angled** (foregrip meshes) |
| Pistol        | The default hold and **Firm** (a two-handed stance, no mesh)    |

In the showcase, **B** steps through the default hold and each grip, and **N** can pick a random one.

***

### Before You Start

***

1. Duplicate `DA_TFA_AssaultRifle` into a folder of your own. It's in `Weapons/AssaultRifle/Demo/Data`.
2. In `L_TFA_AR_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)

***

### Add Your Own Grip

***

{% stepper %}
{% step %}

#### Add a Grip Entry

1. Open your copy of the data asset.
2. Under **Grips**, add an entry to the **Grips** list.
3. Give it a **Name**.
4. Set **Mesh** to your grip's mesh. No mesh yet? Try `SM_TFA_AR_ATT_Grip_Vertical`.

<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%2FrNmFnNmEph0qCU422SCO%2FSL-GRP-01.png?alt=media&amp;token=f4d82724-7b27-4a57-bc0a-e6ef27001b8d" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Check It in Play

1. Hit **Play** in `L_TFA_AR_Showcase`.
2. Press **B** until your grip comes up.

The grip shows on the weapon with the default left hand, because the entry has no poses yet.
{% endstep %}

{% step %}

#### Make the Grip's Left Hand Pose

1. Open the closest pose in `Weapons/AssaultRifle/Animations/Character/FP/Poses`, such as `A_TFA_FP_AR_Idle_Pose_Grip_Vertical`.
2. Select `ik_hand_l` and move it onto your grip.
3. Save it with **Create Asset > Create Animation > Current Pose**. Pick a folder of your own (the dialog opens in the pack's skeleton folder).
4. Do the same for the aim pose, `A_TFA_FP_AR_Aim_Pose_Grip_Vertical`.

{% hint style="info" %}
The preview doesn't show the hand move. Hand IK only runs on the character in Play, so check it in the next step.
{% endhint %}

Step by step: [How to Fix Left-Hand Clipping](https://docs.infimagames.com/product/tactical-fps-animation-packs/guides-and-tutorials/editor/how-to-fix-left-hand-clipping-in-unreal-engine-5.md#create-a-custom-idle-pose-fix-left-hand-ik-clipping)

<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%2FzLbWnd1kDukReb3ysLSq%2FSL-GRP-02.png?alt=media&amp;token=c5e08c59-f93c-4e31-9675-41b0575262a9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Set the Poses

In your grip entry, set **FP\_IdlePose** and **FP\_AimPose** to your two new poses.

<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%2FP34HUCNIRV5A1erR0qTQ%2FSL-GRP-03.png?alt=media&amp;token=138e70b7-d6ee-4958-992e-945839bb92a2" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Test It in Play

1. Hit **Play**.
2. Press **B** until your grip comes up.
3. Aim with the right mouse button.

In first person, the left hand now holds your grip, at the hip and aimed. Third person keeps the default hold until you set **TP\_IdlePose** and **TP\_AimPose**.
{% endstep %}
{% endstepper %}

That's it! Hand IK keeps the hands on the weapon, so a pose only has to be close. An empty pose slot uses the weapon's own pose.

<details>

<summary>The fields of a grip entry</summary>

| Field                                        | What it does                                                                                                                                                            |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                                     | The grip's name.                                                                                                                                                        |
| **Mesh**                                     | The attachment mesh. Leave it empty for a grip stance.                                                                                                                  |
| **FP\_IdlePose**, **FP\_AimPose**            | The first person poses with this grip, at the hip and aimed.                                                                                                            |
| **TP\_IdlePose**, **TP\_AimPose**            | The same in third person.                                                                                                                                               |
| **FP\_AimPoseCanted**, **TP\_AimPoseCanted** | Optional. The grip's own canted pose. Empty: a grip without a mesh plays the weapon's canted pose, with this grip's fingers, and a grip with a mesh keeps its aim pose. |
| **OffsetAimDownSights**                      | Added to the weapon's own offset while aiming with this grip.                                                                                                           |
| **OverrideCantedAim**, **OffsetCantedAim**   | Ticked, the grip uses its own canted offset instead of the weapon's Offset Canted Aim.                                                                                  |
| **OverrideIdlePose**, **OffsetIdlePose**     | Ticked, the grip uses its own idle offset instead of the weapon's Offset Idle Pose.                                                                                     |

**Starting Grip**, next to the Grips list, is the grip the weapon spawns with, as an index into Grips. The default, -1, starts on the default hold. The Pistol starts on Firm.

When the grip changes, the left hand blends into the new pose and the grip change animation plays, in first and third person. Each weapon keeps its grip while it's holstered.

</details>

***

### Change the Canted Aim

***

Canted aim tilts the weapon while aiming, for a sight mounted at an angle.

{% stepper %}
{% step %}

#### Open Offset Canted Aim

In your copy, open **Procedural Offsets > Offset Canted Aim**. It sets where the weapon goes and how far it tilts in first person. The Assault Rifle tilts 40 degrees, **Rotation Y** -40.

<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%2FXWcQNldUwyyhi0cXU2mk%2FSL-GRP-05.png?alt=media&amp;token=efba9161-fbbe-435a-8be7-3588af5c483f" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Change the Tilt

Set **Rotation Y** to another angle, such as -30 for a smaller tilt.

{% hint style="warning" %}
Keep it negative. A positive value tilts the weapon the other way, into the camera.
{% endhint %}
{% endstep %}

{% step %}

#### Test It in Play

1. Hit **Play**.
2. Hold the right mouse button.
3. Press the middle mouse button to cant.

The weapon tilts to your new angle.

<div align="left"><figure><img src="https://3271331258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuuZjeeFspZ4mvcxHpS6M%2Fuploads%2FW9o4bkpEL0118gK9WQkm%2FSL-GRP-06.png?alt=media&amp;token=cfff38e8-ba7a-4609-920f-1887f606c2a1" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

The arm and fingers follow the canted pose, **FP Aim Pose Canted**, made for the default tilt. Changing the tilt a lot? Make a new canted pose the same way as the grip poses above.

<details>

<summary>The canted aim fields</summary>

| Field                                      | What it does                                                                                            |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| Procedural Offsets > **Offset Canted Aim** | Where the weapon goes and how far it tilts in first person.                                             |
| **TP Aim Pose Canted**                     | The third person body's canted pose.                                                                    |
| **FP Aim Pose Canted**                     | Optional. The first person left arm's canted pose. Left empty, the arm keeps the aim pose while canted. |

A grip with its own canted pose plays that pose while canted, and blends with the weapon's cant, so the arm and the weapon move together. The Pistol's Firm grip has its own canted pose in both views, and its own canted offset, so it cants to the same place as the default hold.

</details>

<details>

<summary>The cant transitions in first person</summary>

Toggling canted aim while aiming plays a short transition on top of the cant, the same way the aim in and aim out transitions play. Quick toggles crossfade into each other. A reload or another uncanted action that changes the cant plays no transition. The fields are under Animation > Sequences > Character > First Person > Transitions.

| Field                              | What it does                                                                                                                                                                                                    |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **FP Transition Cant In**          | Optional. Plays when canted aim turns on while aiming. Left empty, FP Transition Aim Start plays instead.                                                                                                       |
| **FP Transition Cant Out**         | Optional. Plays when canted aim turns off while aiming. Left empty, FP Transition Aim End plays instead.                                                                                                        |
| **FP Transition Cant Alpha**       | How strongly the cant transitions play. 0 is off, 1 plays them as authored.                                                                                                                                     |
| **FP Transition Canted Aim Alpha** | How strongly the aim in and aim out transitions play when aiming goes into canted aim or comes out of it. 0 is off, 1 plays them as authored. Aiming in and out without the cant always plays them as authored. |

Both our weapons reuse their aim in and aim out transitions for the cant. The Assault Rifle plays them as authored, and the Pistol plays them much softer, with both alphas at 0.15. Third person has no cant transitions.

</details>

<details>

<summary>How fast the aim and the cant move</summary>

Aiming and canting ease in and out, so the weapon speeds up into the move and settles at the end. The fields are under Procedural Offsets > ADS Spring.

| Field               | What it does                                                                                                                                                                                                         |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aim Blend Time**  | About how long the weapon takes to come up to the sights, and back down when you let go. 0.05 s by default. 0 switches at once, and the ADS spring alone moves the weapon.                                           |
| **Cant Blend Time** | About how long the weapon takes to tilt into canted aim and back. That includes aiming in from the hip with the cant already on. 0.1 s by default, and both our weapons use 0.15. 0 switches at once.                |
| **Aim Overshoot**   | How far the weapon's rotation swings past the aim before it settles, as a part of the move. 0.1 means 10%. It gives the aim a little wiggle, and 0 settles cleanly. The Pistol uses 0.25 and the Assault Rifle 0.15. |
| **Cant Overshoot**  | The same for the cant, as a part of the cant angle. 0.05 by default.                                                                                                                                                 |

Only the rotation overshoots. The position never does. The ADS spring settings (stiffness, damping and the rest) still shape the move on top of these.

</details>

***

### Actions That Bring the Weapon Upright

***

A canted weapon eases upright during actions like a magazine check, and tilts back after, in both views. To see it, aim canted and reload.

<details>

<summary>Change which actions do this</summary>

**Procedural Offsets > Uncanted Actions** lists them. It starts with MagCheck, Reload, ReloadQuick, ReloadEmpty and ReloadEmptyRetain. A scoped version of an action reports its own name, such as `Reload_Scope`, so add it to the list too.

</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/grips-and-canted-aim.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.
