RecoilSense

RecoilSense is a lightweight, weapon-independent recoil system designed to make firearm feedback feel more responsive and impactful with minimal setup.

Add the RecoilSense component to a weapon, assign optional camera and weapon transforms, select a settings asset, and call Kick() whenever a shot succeeds. RecoilSense remains separate from firing, ammunition, projectile, input, and weapon-selection systems, making it easy to integrate into existing FPS, third-person shooter, action, survival, sci-fi, and virtual-reality projects.

Camera and weapon recoil can be configured independently using position, pitch, yaw, and roll. Each channel includes its own kick speed, recovery delay, recovery speed, recovery behavior, randomness, and accumulation limits.

Repeated shots can build recoil during automatic fire. If another shot interrupts camera recovery, the current pitch and yaw can become the new resting aim, producing persistent weapon climb that players can counter through normal aim input. Camera roll always remains temporary and fully recovers.

Settings are stored as reusable ScriptableObject assets, allowing every weapon to have a distinct recoil profile. Seven example profiles are included: Pistol, SMG, Rifle, Shotgun, Hand Cannon, Sci-Fi, and Sniper.

An optional URP demonstration includes simple weapon prefabs, multiple firing behaviors, projectiles, impact markers, a reticle, weapon switching, and preset-selection UI. The core runtime remains independent of URP, Input System, and uGUI.