IMPORTANT

Status: Supported
Minimum version: IX-Ray Platform 1.4

Overview

Original

Pattern

When a weapon has a recoil pattern defined, the system enables a spring-pendulum style recoil mechanic. Each shot shifts the camera target, and the camera follows it with inertia — producing a realistic kick and recovery.

NOTE

The pattern system is activated by adding the suffix _hipfire_pattern to the weapon section name. Example: if the weapon section is wpn_ak74, use wpn_ak74_hipfire_pattern to enable the new pattern recoil for the AK-74.

Defining a weapon pattern

Pattern entries use bullet_XXX keys, where XXX is the shot index. Each value is two numbers in the format X, Y representing cumulative angles in degrees.

Pattern logic: a positive X shifts left, negative X shifts right; a positive Y shifts up, negative Y shifts down.

[wpn_ak74_hipfire_pattern]
bullet_1 = 0.009, 0.157
bullet_2 = -0.070, 0.136
bullet_3 = -0.080, 0.169
bullet_4 = -0.088, 0.124
bullet_5 = -0.084, 0.180
bullet_6 = 0.121, 0.180
bullet_7 = -0.035, 0.270
bullet_8 = -0.134, 0.267
bullet_9 = -0.192, 0.293
bullet_10 = -0.146, 0.319
; ...

WARNING

Pattern values are cumulative: each shot starts from the last bullet position.

Weapon config parameters

Set pattern parameters in the weapon config wpn_XXX (where XXX is the weapon name).

Parameters:

pattern_factor = 0.048
pattern_factor_agility = 1
pattern_factor_agility_vel = 2
pattern_factor_agility_accel = 1
pattern_factor_agility_crouch = 0.950
pattern_factor_agility_crouch_no_acc = 0.910
pattern_stiffness = 1000
pattern_damping = 45
pattern_impulse = 90
pattern_loop = 1
pattern_return_speed = 3.500
pattern_return_enable = 1
pattern_random_enable = 1
pattern_random_x = -0.2, 0.2
pattern_random_y = -0.05, 0.2

WARNING

Zoom (aiming) parameters use the zoom_ prefix.

zoom_pattern_factor = 0.044
zoom_pattern_factor_agility = 1
zoom_pattern_factor_agility_vel = 3.700
zoom_pattern_factor_agility_accel = 1
zoom_pattern_factor_agility_crouch = 0.870
zoom_pattern_factor_agility_crouch_no_acc = 0.770
zoom_pattern_stiffness = 950
zoom_pattern_damping = 45
zoom_pattern_impulse = 85
zoom_pattern_loop = 1
zoom_pattern_return_speed = 3
zoom_pattern_return_enable = 1
zoom_pattern_random_enable = 1
zoom_pattern_random_x = -0.2, 0.2
zoom_pattern_random_y = -0.05, 0.2

Parameter descriptions

Pattern recoil strengthNormal 0.035Aiming 0.025

Base multiplier for pattern strength. Higher values increase the effect of bullet_ offsets.

pattern_factorzoom_pattern_factor

Overall movement multiplierNormal 1.0Aiming 1.0

Overall agility multiplier applied to weapon recoil.

pattern_factor_agilityzoom_pattern_factor_agility

Movement speedNormal 3.0Aiming 3.5

Multiplier that scales pattern effect with player movement speed.

pattern_factor_agility_velzoom_pattern_factor_agility_vel

RunningNormal 1.0Aiming 1.0

Additional multiplier applied while sprinting.

pattern_factor_agility_accelzoom_pattern_factor_agility_accel

CrouchingNormal 0.95Aiming 0.9

Multiplier for crouching movement.

pattern_factor_agility_crouchzoom_pattern_factor_agility_crouch

Full crouchNormal 0.95Aiming 0.85

Multiplier for full crouch (no sprint) movement.

pattern_factor_agility_crouch_no_acczoom_pattern_factor_agility_crouch_no_acc

Spring stiffnessNormal 800.0Aiming 800.0

Spring stiffness. Higher values make the camera move toward the recoil target faster. Low values produce smooth, sluggish recoil; high values produce a sharp kick.

pattern_stiffnesszoom_pattern_stiffness

Oscillation dampingNormal 40.0Aiming 40.0

Damping of spring oscillations. Higher values make camera oscillation settle faster. Low values create a shaking effect after recoil.

pattern_dampingzoom_pattern_damping

Shot impulseNormal 35.0Aiming 35.0

Strength of the instantaneous impulse applied when firing. High values produce a sharp camera kick; low values produce a gradual increase in recoil.

pattern_impulsezoom_pattern_impulse

Pattern loopingNormal 1Aiming 1

Whether to loop the recoil pattern. With 1, recoil continues from the first step after the last shot in the pattern. With 0, subsequent shots produce no pattern offsets once all points have been used.

pattern_loopzoom_pattern_loop

Camera return speedNormal 5.0Aiming 5.0

Speed of return toward the previous camera position after recoil.

pattern_return_speedzoom_pattern_return_speed

Camera returnNormal 1Aiming 1

Whether the camera returns to the previous shot position after recoil ends. With 0, the camera stays at the last shot position.

pattern_return_enablezoom_pattern_return_enable

Random offsetsNormal 0Aiming 0

Enables randomization on top of pattern points.

pattern_random_enablezoom_pattern_random_enable

Random horizontal offsetFormat X, X(two numbers)

Horizontal random offset range. The first number is the minimum and the second is the maximum.

pattern_random_xzoom_pattern_random_x

Random vertical offsetFormat Y, Y(two numbers)

Vertical random offset range. The first number is the minimum and the second is the maximum.

pattern_random_yzoom_pattern_random_y

Recoil settings for attachments

Attachment parameters are set in the scope, silencer and underbarrel grenade sections.

Scope section:

scope_attached_recoil_factor = 0.93
scope_attached_recoil_reduction = 0.81

Recoil with a scopeDefault 1.0

Multiplies recoil when a scope is attached.

scope_attached_recoil_factor

Recoil reduction while aimingDefault 1.0

Additional divisor applied in aiming mode.

scope_attached_recoil_reduction

Silencer:

attached_recoil_f = 0.85

Recoil with a silencerDefault 1.0

Recoil multiplier when a silencer is attached.

attached_recoil_f

Underbarrel grenade launcher:

grenade_attached_recoil = 0.95

Recoil with a grenade launcherDefault 1.0

Recoil multiplier when an underbarrel grenade launcher is attached.

grenade_attached_recoil

Global recoil parameters

These go into the [actor] section and act as global multipliers influenced by player movement (agility). Useful for mod-wide tuning.

agility_vel_factor = 2
agility_accel_factor = 1.05
agility_crouch_factor = 0.98
agility_crouch_no_acc_factor = 0.96

Global movement multiplierDefault 2.0

Main player movement multiplier. Higher values increase the effect of pattern_factor_agility / zoom_pattern_factor_agility in the weapon section.

agility_vel_factor

Global running multiplierDefault 1.05

Multiplier that increases recoil while the player is running. Higher values increase the effect of pattern_factor_agility_accel / zoom_pattern_factor_agility_accel in the weapon section.

agility_accel_factor

Global crouch multiplierDefault 0.98

Player movement multiplier while crouching. Lower values reduce the effect of pattern_factor_agility_crouch / zoom_pattern_factor_agility_crouch in the weapon section.

agility_crouch_factor

Global full crouch multiplierDefault 0.96

Player movement multiplier in full crouch. Lower values reduce the effect of pattern_factor_agility_crouch_no_acc / zoom_pattern_factor_agility_crouch_no_acc in the weapon section.

agility_crouch_no_acc_factor

Examples

Example 1: basic pattern setup

Recoil Pattern Editor demo:

[wpn_mp5_hipfire_pattern]
bullet_1 = 0.088, 0.263
bullet_2 = -0.044, 0.263
bullet_3 = 0.044, 0.175
bullet_4 = 0.035, 0.175
bullet_5 = -0.044, 0.175
bullet_6 = 0.000, 0.132
bullet_7 = 0.088, 0.132
bullet_8 = -0.175, 0.175
bullet_9 = 0.225, 0.234
bullet_10 = 0.175, -0.175
bullet_11 = 0.009, 0.175
bullet_12 = 0.000, 0.175
bullet_13 = 0.053, 0.132
bullet_14 = 0.219, -0.088
bullet_15 = 0.096, 0.289
bullet_16 = -0.175, 0.263
bullet_17 = -0.013, 0.290
bullet_18 = 0.158, 0.259
bullet_19 = 0.086, 0.259
bullet_20 = 0.175, -0.132
bullet_21 = -0.026, 0.263
bullet_22 = 0.088, 0.219
bullet_23 = 0.161, 0.297
bullet_24 = -0.384, 0.130
bullet_25 = 0.162, 0.256
bullet_26 = 0.270, 0.135
bullet_27 = 0.243, -0.068
bullet_28 = -0.040, 0.216
bullet_29 = -0.068, 0.296
bullet_30 = -0.168, 0.175

Weapon parameters for wpn_mp5:

pattern_factor = 0.049
pattern_factor_agility = 1
pattern_factor_agility_vel = 1.500
pattern_factor_agility_accel = 1
pattern_factor_agility_crouch = 0.890
pattern_factor_agility_crouch_no_acc = 0.810
pattern_stiffness = 1500
pattern_damping = 30
pattern_impulse = 60
pattern_loop = 1
pattern_return_speed = 5
pattern_return_enable = 1
pattern_random_enable = 0
zoom_pattern_factor = 0.042
zoom_pattern_factor_agility = 1
zoom_pattern_factor_agility_vel = 3.300
zoom_pattern_factor_agility_accel = 1
zoom_pattern_factor_agility_crouch = 0.850
zoom_pattern_factor_agility_crouch_no_acc = 0.770
zoom_pattern_stiffness = 1500
zoom_pattern_damping = 35
zoom_pattern_impulse = 55
zoom_pattern_loop = 1
zoom_pattern_return_speed = 5
zoom_pattern_return_enable = 1
zoom_pattern_random_enable = 0

![MP5 без глушителя](https://github.com/user-attachments/assets/63b68c84-654a-4295-b414-5d4c8ceca46a)

Example 2: silencer reduces recoil

Add attached_recoil_f in the silencer addon section:

[wpn_addon_silencer]
attached_recoil_f = 0.5

• This reduces overall weapon recoil by 50% (applies both when hipfiring and aiming).

Example 3: disable movement influence for wpn_lr300

In [actor] set agility_vel_factor to 1.0 to remove movement influence:

[actor]
agility_vel_factor = 1.0

Also set both pattern_factor_agility_vel and zoom_pattern_factor_agility_vel to 1.0 in wpn_lr300.

Result: movement no longer affects LR-300 recoil.

Recommendations and limitations

• Recoil multipliers can be set below 1.0 to reduce recoil or above 1.0 to increase it.
• Use pattern_stiffness / zoom_pattern_stiffness, pattern_damping / zoom_pattern_damping, and pattern_impulse / zoom_pattern_impulse to tune the physical feel.
• You can inherit patterns for variant weapons instead of duplicating them:

[wpn_mp5_nimble_hipfire_pattern]:wpn_mp5_hipfire_pattern

• Limitations:
• In single-shot mode with very high RPM values the pattern may be applied but immediately cleared due to the shot queue ending, producing no visible effect. To mitigate, ensure at least one bullet_1 entry and consider enabling pattern_random_enable / zoom_pattern_random_enable and adjust offsets.
• Final recoil is the product of all multipliers (weapon params, bullet_ points, attachments, actor values). Avoid setting all multipliers to 0.0 as it may break gameplay balance.

See also

• DLTX