You are viewing a potentially older version of this package. View all versions.
captience-H3VR_Plus-1.0.0 icon

H3VR Plus

Physics-based recoil, guided reloads and weapon heft. Mags and shells line up and slide in, guns kick by cartridge and hold. All settings in the wrist menu.

Date uploaded a day ago
Version 1.0.0
Download link captience-H3VR_Plus-1.0.0.zip
Downloads 511
Dependency string captience-H3VR_Plus-1.0.0

This mod requires the following mods to function

BepInEx-BepInExPack_H3VR-5.4.1700 icon
BepInEx-BepInExPack_H3VR

BepInEx pack for H3VR. Preconfigured and ready to use.

Preferred version: 5.4.1700
nrgill28-Sodalite-1.5.1 icon
nrgill28-Sodalite

Modding API and tools for H3VR code plugins

Preferred version: 1.5.1

README

H3VR+

Quality-of-life overhaul for how guns feel in H3VR: physics-based recoil, reloads that guide themselves home, and guns that have weight when you swing them. Everything is switched and tuned from the wrist menu. No config files.

Three parts, each with its own on/off switch:

  • Kickback: recoil simulated from the cartridge, the gun and how you hold it
  • Guided Reload: mags, shells, clips and speedloaders line up with where they go and slide in
  • Heft: heavy guns lag and overshoot when you whip them around; pistols stay snappy

Kickback (recoil)

Vanilla recoil is a canned snap and a fade. Kickback replaces it with a small physics simulation that runs for every shot:

  • The cartridge drives it. Bullet weight, velocity, powder charge and barrel length give each shot its push. A .22 and a .44 Magnum are not the same animation at different sizes. +P and hot loads kick harder than standard ones.
  • The gun matters. Mass and balance are measured from the gun's own model, so modded guns work without profiles. A bore that sits high above your hand flips more.
  • Your hold matters. One hand, two hands, a foregrip, a shouldered stock and a bipod are all different contacts. A shouldered rifle pushes back; a one-handed magnum flips hard.
  • Posture. A straight arm, a level gun and looking down the sights are a good hold. A bent, canted hip-fire hold kicks, drifts and shakes more. The wrist menu shows the score of your last shot.
  • Slide and bolt. The slide or bolt carrier hitting the rear and slamming home are their own impacts, so automatics get their double tap.
  • Burst walk and shake. Sustained fire pushes your hold off target and shakes it; single shots stay calm.
  • Haptics. Each impact has its own pulse instead of one flat buzz.
  • Head kick (off by default): a small screen punch on shouldered shots. Leave it off if you get motion sick.

Covers handguns, revolvers, derringers, closed and open bolt guns, bolt actions, lever actions, tube-fed and break-action shotguns, revolving shotguns and rolling blocks. Anything else keeps vanilla recoil.

Guided Reload

Bring a mag near its well and it lines up and goes in. No more bonking the mag against the receiver.

  • Magazines: every mag well (main, secondary, underbarrel, belt boxes). Pistols and guns you hold by the magwell slide the mag home by themselves. On long guns you push it in by hand.
  • AK rock-and-lock: AK-style mags hook in at the front and rock back until the latch catches.
  • AK paddle flick: swipe a fresh mag forward across the paddle release to knock the old mag out.
  • Shells: tube-fed shotguns and lever actions. The shell lines up behind the loading port and you push it in.
  • Single rounds: straight into an open chamber.
  • Speedloaders, moon clips and stripper clips: they turn to the nearest chamber and line up.
  • Guide strength: Light, Normal or Strong.

Heft

H3VR guns follow your hand exactly, whatever they weigh. With Heft, the gun's mass and balance resist fast hand moves: a machine gun lags and overshoots, a support hand or stock steadies it, a pistol barely notices.

Settings

Open the wrist menu. There are two sections:

H3VR+ Recoil: Kickback on/off (off = vanilla recoil), Bolt/slide, Posture, Kick, Wrist, Grip, Wobble, Bounce, Shake, Heft, Haptics, Head kick, Readout (a floating last-shot panel), Walk, and Reset tuning to 100%.

H3VR+ Reload: Guided mags, Guided speedloaders & clips, Guided shells, Guided chambering, AK rock-in, AK paddle flick, Guide strength, Reload haptics.

Everything saves by itself. 100% is the realistic setting; turn Kick down if a gun is too much for you.

Compatibility

  • Turn off other recoil mods. OomphFactor, UniversalRecoilControl (and XRotateOomph / ZLinearOomph), ThirdLaw and HandStabilizer change the same thing and will fight with Kickback. H3VR+ writes a warning to the log if it sees one.
  • Other reload mods (6FingerReload, ReloadAnimations, MagBoop and similar) are not tested with Guided Reload. If they fight, switch off the matching Guided option in the wrist menu.
  • Modded guns work: OtherLoader weapon packs, ModularWorkshop and OpenScripts2 guns were used throughout testing.
  • H3MP (multiplayer) is not tested.
  • Tuned on Valve Index controllers. Other controllers should work, but the haptics may feel different.

Requirements

  • BepInEx pack for H3VR
  • Sodalite (for the wrist menu)

Install with r2modman or Gale and both come along.

Bugs

If something is wrong with one gun, say which gun, which ammo, and how you were holding it. The file BepInEx/LogOutput.log from that session helps a lot.

Credits

Designed, directed and playtested by captience, from about 260 hours of H3VR. The code was written with Claude (Anthropic's AI), which is why this is tagged AI Generated.

H3VR is by RUST LTD. This mod is not affiliated with them.

CHANGELOG

Changelog

1.0.0

First public release.

  • Kickback: physics-based recoil for handguns, revolvers, derringers, closed and open bolt guns, bolt actions, lever actions, shotguns and rolling blocks. Cartridge, gun mass, hold (one hand, two hands, foregrip, shoulder, bipod) and posture all change the kick. Slide and bolt impacts, burst walk, posture shake, per-impact haptics, optional head kick.
  • Guided Reload: magazines (all wells), AK rock-and-lock and paddle flick, tube shells, single rounds into chambers, speedloaders, moon clips and stripper clips.
  • Heft: guns have weight when you swing them.
  • All settings are in the wrist menu.