Shoot Modifier

Modifies the shoot config of a weapon

  Shoot_Modifier:
    Projectile_Amount: <IntModifier>
    Projectile_Speed: <DoubleModifier>
    Base_Spread: <DoubleModifier>
    Override_Spread: <Spread>
    Fully_Automatic_Shots_Per_Second: <IntModifier>
    Add_Mechanics: <Mechanics>  # or use Replace_Mechanics
    Recoil_Modifier:
      Mean_X: <DoubleModifier>
      Mean_Y: <DoubleModifier>
      Variance_X: <DoubleModifier>
      Variance_Y: <DoubleModifier>
      Speed: <DoubleModifier>
      Damping: <DoubleModifier>
      Damping_Recovery: <DoubleModifier>
      Smoothing_Factor: <DoubleModifier>
      

Projectile_Amount

Modifies the Projectiles_Per_Shot, the number of projectiles launched for each shot. This is typically used for shotguns, to increase the amount of pellets/shrapnel.

Projectile_Speed

Modifies the Projectile_Speed, the speed, in $\frac{m}{s}$, that the projectile should be launched at. You can use this on suppressor attachments to decrease the muzzle velocity of the launched projectile(s).

Base_Spread

Modifies the Base_Spread, the random variations in bullet path. Increasing the spread will make the gun harder to use because bullets will fly more randomly.

Override_Spread

In general, you should try to use the Base_Spread feature instead of Override_Spread. This is to make it easier to configure multiple attachments that modify spread at the same time.

Completely overrides the Spread of the weapon.

Fully_Automatic_Shots_Per_Second

Modifies the Fully_Automatic_Shots_Per_Second of the weapon. For non-automatic weapons (semi/burst weapons), the starting value will be 0.

Allow Selective Fire Example

In this example, selective fire still works with burst and semi-auto weapons. This is because we use the MULTIPLY option, and $0\times x=0$, where $x$ can be any number. In this example, the full auto rate will be 50% higher then before.

    Shoot_Modifier:
      Fully_Automatic_Shots_Per_Second: MULTIPLY 1.50

Convert to Full Auto Example

In this example, selective fire will no longer work. This example will convert all weapons to fully automatic weapons.

    Shoot_Modifier:
      Fully_Automatic_Shots_Per_Second: SET 6

Add_Mechanics

This will add additional Mechanics to the current mechanics. To replace all current mechanics, change the config key to Replace_Mechanics.

Modifies the current mechanics applied whenever an entity shoots the weapon. In practice, this can be used to create suppressors, VALORANT styled skins (skins that modify sounds shoot sounds), make sounds louder, etc.

Suppressor Example

In this example, we replace the original mechanics (and thus, the original sound) with a suppressed sound with less volume.

    Shoot_Modifier:
      Replace_Mechanics:
        - "CustomSound{sound=shoot.m4a1.silenced.loud, volume=2, noise=0.1}"

Recoil_Modifier

Lets you modify the recoil of the weapon. This can be used to make recoil more/less "snappy," which allows finer control over balancing your guns.

All config options match 1 to 1 with the config options in the base recoil section of your gun. In general, modifying just the speed value can be enough to increase/decrease recoil.

    Shoot_Modifier:
      Recoil_Modifier:
        # ~20% increase in initial recoil
        Speed: MULTIPLY 1.20