TwinStickArmSprint

v1.1.5·Updated 2025-12-14

Twinstick movement, but swinging your arms adds speed. Alternate mode: Head-Based Armswinger

Screenshots 1 screenshots

About this mod Author’s original text

TwinStick Arm Sprint

This is based on Potatoes' Twin Stick Swinger ( The main difference is that swinging your arms _only increases speed_, without affecting direction. It's similar to movement in Blade & Sorcery.

There's also another mode called "Head-Based Armswinger" that's like regular Armswinger (no TwinStick), except that it uses head-based direction instead of controller-based direction. You will always go in the direction that you're facing.

NOTE: REPLACES ARMSWINGER MOVEMENT MODE

Due to issues caused by replacing Dash movement mode, this mod replaces Armswinger mode instead. It uses a combination of TwinStick options and Armswinger options.

For TwinStick Arm Sprint mode, the following settings are respected

  • TwinStick Options:
  • Movement Speed
  • Controller Forward/Side Root
  • TwinStick Left/Right Handedness
  • TwinStick Jump
  • ArmSwinger Options:
  • ArmSwinger Jump
  • _ArmSwinger Turning Mode_

You can also use the Global Movement Options, like setting the buttons to turn or jump.

For TwinStick Arm Sprint mode, the following settings are _ignored_

  • TwinStick Options:
  • _TwinStick Turning Mode_
  • TwinStick Sprint Mode
  • TwinStick Sprint Toggle Mode
  • ArmSwinger Options:
  • ArmSwinger Base Speed (Left Hand)
  • ArmSwinger Base Speed (Right Hand)

For Head-Based Armswinger mode, it only respects _ArmSwinger_ options

TwinStick Arm Sprint Usage

  • Go to Wrist menu > Set Move Mode > TS Arm Sprint.
  • Use the analog stick (or touchpad on some controllers) on the movement hand to move around as in TwinStick mode.
  • Swing your arms to sprint. It doesn't matter which way you swing them. The faster you move, the faster you go!

Head-Based Armswinger Usage

  • Change modes as shown below in the Config section.
  • Go to Wrist menu > Set Move Mode > Head Armswinger.
  • Look in the direction you want to go. Press the ArmSwinger button(s) to move and swing your arms to speed up.

Notes

  • Use _ArmSwinger Turning Mode_ to control the turning mode.
  • If you have ArmSwinger Jump enabled, raise both controllers above your head to jump.
  • (TwinStick Arm Sprint only) If you have TwinStick Jump enabled, press down on the analog stick on the offhand to jump.
  • (TwinStick Arm Sprint only) Your max speed with the analog stick is set by the _TwinStick Movement Speed_ option.

Config

  • Default is TwinStick Arm Sprint mode.
  • The game must be run at least once with the mod enabled in order for the config file to be created.
  • To change modes, edit the config file. You can use the mod panel in the game, or edit dll.h3vr.odekak.twinstickarmsprint.cfg in the Config folder. R2modman has a "Config editor" option.

Fixed Issues

  • Several bugs were fixed compared to Twin Stick Swinger. Jump now works fine, whether you use TwinStick jump or Armswinger jump. Also, there's no awkward momentum issue when going down stairs.
  • Also, stick-based turning (smooth and snap) now works on Oculus/Meta controllers.

Credits

  • potatoes1286 - For making a great mod and for sharing the code on GitHub
  • Alexine - For reporting issues and being a great tester

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack_H3VR

File & checksum

Filename
TwinStickArmSprint-1.1.5.zip
File size
90.7 KiB