# Crosshair modding

## Preparation

Locate your game folder and find this folder if you are on Origin:

> Origin Games\Titanfall2\vpk\\

Or this folder if you are on Steam:

> Steam\steamapps\common\Titanfall2\vpk\\

Copy these files and paste them in a backup folder somewhere else:

* `englishclient_mp_common.bsp.pak000_dir.vpk`
* `client_mp_common.bsp.pak000_000.vpk`

You will need the Titanfall VPK Tool, the program which will allow you to open and repack Titanfall VPK files. [Here](https://noskill.gitbook.io/titanfall2/how-to-start-modding/modding-tools)

## Unpacking

Now that these files have been backed up and everything installed. Navigate to your game folder and open this file:

> Origin Games\Titanfall2\vpk\englishclient\_mp\_common.bsp.pak000\_dir.vpk

> Steam\steamapps\common\Titanfall2\vpk\englishclient\_mp\_common.bsp.pak000\_dir.vpk

[How to extract VPK's properly ?](https://noskill.gitbook.io/titanfall2/how-to-start-modding/how-to-backup-extract-and-repack)

## Editing

Go to this location in your extracted folder

```
englishclient_mp_common.bsp.pak000_dir.vpk\scripts\weapons
```

This folder contains the "config files" for the weapons. Edit those files at your own risk, if you get banned because you edit some important value don’t blame me.

Find that code block to get where is the crosshair code part.

```
active_crosshair_count                      “1”
rui_crosshair_index                         “0”

RUI_CrosshairData
```

From this part to the bottom of the *`RUI_CrosshairData`* bracket that's the part that we will edit together ! (finally getting into the interesting part !)

To change the crosshair, you have to change the *`ui`* with the one you want. You can find the value for the different crosshair in the game down bellow.

For example, change

*`ui/crosshair_tri`* to *`ui/crosshair_alternator`*

That will change the classic AR / SMG (used on R201, CAR, R97...) to the Alternator crosshair.

Is possible to combine multiple crosshair at the same time, for that you need to duplicate *`Crosshair_1`* bracket and is value inside like this example

```
Crosshair_1
{
    “ui”                                     “ui/crosshair_plus”
    “base_spread”                            “0.0”
    Args
    {
        //isFiring weapon_is_firing
    }
}
```

Don't copy paste the value from this example, use the one you have in the edited file!

### active\_crosshair\_count

```
active_crosshair_count "2"
```

This value set the amount of crosshair you would like to use at once. To use multiple crosshair at once, you need to change that value to the amount of `Crosshair_x` bracket you want to combine.

You can change the *`base_spread`* value to change the based size of the crosshair, this won't change the vector size but the distance between the center of the screen and the different parts of the crosshair. You can use positive or negative values

### ui/crosshair

These values are the crosshair itself. They can be swapped to any other ui/crosshair value you can find in other config files. You can send me a message if you find other ones.

Some crosshairs are dynamic, like the charge rifle, frag grenade and a couple of other crosshairs that have animations. In some cases changing to another dynamic crosshair will work fine, in other cases it won't. As a working example: my favorite crosshair combo is using the charge rifle crosshair for the Northstar railgun. For a non working example: the frag grenade crosshair on the CAR won't work well.

![](https://3680263823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPXG6BIVWwbrvVSOiBw-887967055%2Fuploads%2Fgit-blob-80c223f7668ca519a61dff2461f817ad03d89eca%2FCrosshair1.PNG?alt=media)

![](https://3680263823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPXG6BIVWwbrvVSOiBw-887967055%2Fuploads%2Fgit-blob-40f94e1d1c14726d36d623b34dce531ca693c9e6%2FCrosshair2.PNG?alt=media)

![](https://3680263823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPXG6BIVWwbrvVSOiBw-887967055%2Fuploads%2Fgit-blob-92e0bdf9927661dec927c0c49a73e4f3f6c24ccd%2FCrosshair3.PNG?alt=media)

Some crosshair are dynamics, like the charge rifle, frag grenade and some other crosshair which have animation. In some case changing to another dynamic crosshair will work fine, in other cases it won't. As an example my favorite one is using the charge rifle crosshair for the Northstar railgun. For an opposite example, the frag grenade crosshair to the CAR won't work well.

### base\_spread

This value set the based size of the crosshair, this won't change the vector size but the distance between the center of the screen and the different parts of the crosshair. You can use positive or negative values.

### RUI\_CrosshairData & Arguments

Args or arguments can change how the crosshair is acting

| Argument           | Value                                   | Note |
| ------------------ | --------------------------------------- | ---- |
| adjustedSpread     | weapon\_spread                          |      |
| adsFrac            | player\_zoomFrac                        |      |
| ammoFrac           | "progress\_weapon\_clip\_ammo\_frac"    |      |
| ammoFrac           | "progress\_grapple\_power"              |      |
| chargeFrac         | player\_chargeFrac                      |      |
| chargeLevel        | player\_chargeLevel                     |      |
| chargeMaxTime      | eWeaponVar.custom\_float\_0             |      |
| chargeStartTime    | weapon\_script\_time\_0                 |      |
| clipAmmo           | weapon\_ammo                            |      |
| clipSize           | weapon\_clipSize                        |      |
| crosshairMovementX | crosshair\_movement\_x                  |      |
| crosshairMovementY | crosshair\_movement\_y                  |      |
| dryfireTime        | "weapon\_latest\_dryfire\_time"         |      |
| isActive           | weapon\_is\_active                      |      |
| isAmped            | weapon\_is\_amped                       |      |
| isFiring           | weapon\_is\_firing                      |      |
| isGrappleInRange   | "grapple\_in\_range"                    |      |
| isLocked           | smartammo\_locked                       |      |
| isReloading        | weapon\_is\_reloading                   |      |
| isSprinting        | player\_is\_sprinting                   |      |
| readyFrac          | progress\_ready\_to\_fire\_frac         |      |
| regenRate          | "eWeaponVar.regen\_ammo\_refill\_rate"  |      |
| smartFov           | "eWeaponVar.smart\_ammo\_search\_angle" |      |
| teamColor          | crosshair\_team\_color                  |      |

More argument information on this page

{% content-ref url="" %}
[](https://noskill.gitbook.io/titanfall2/modding/weapon-config-info)
{% endcontent-ref %}

### Config file name

List of the different weapon config files. Sometimes names are not the same as in game name.

{% content-ref url="../../documentation/file-location/weapon/weapon-config-file-name" %}
[weapon-config-file-name](https://noskill.gitbook.io/titanfall2/documentation/file-location/weapon/weapon-config-file-name)
{% endcontent-ref %}

## Repacking

[How to repack VPK files properly?](https://noskill.gitbook.io/titanfall2/how-to-start-modding/how-to-backup-extract-and-repack#how-to-repack-vpk-files-properly)

After following step by step the previous link

Rename `pak000_000.vpk` *to* `client_mp_common.bsp.pak000_000.vpk`

Rename `ak000_dir.vpk` *to* `englishclient_mp_common.bsp.pak000_dir.vpk`

Place both of the renamed files back into your game directory and then launch Titanfall 2. You should be able to see your new crosshair!