KisakCOD VR v0.10.0-beta.1 - Tracked Hands and Manual Reloading

Matching-runtime clean-install fix

The Windows ZIP now includes the exact 32-bit Steamworks, Bink, and Miles runtime files used by KisakCOD. This fixes clean-install steam_api.dll failures and the _AIL_sample_stage_property@28 entry-point error caused by an incompatible retail mss32.dll.

Clean-install packaging fix

The Windows ZIP now includes the required steam_api.dll. A clean extraction into an original COD4 installation no longer requires files from an older KisakCOD VR update.

Tracked hands and physical manual reloading

This beta adds a palm-aligned tracked left hand and physical detachable-magazine reloading for supported rifles, SMGs, and pistols.

Added

• Palm-aligned controller-tracked left hand
• Free-hand, rifle-support, and magazine-grip poses
• Physical magazine ejection, left-hip draw, insertion, rotation, and dropping
• Two-bone shoulder and elbow placement
• OpenXR palm-pose support with grip-pose fallback
• Settings for disabling tracked hands or physical reloading
• Removed the colored controller-axis diagnostic overlay

Complete Meta Quest Touch controls

This is the primary tested control map. Other OpenXR controller profiles remain experimental.

Action	Control
Look and physically turn	Move the headset or turn your body
Move	Left thumbstick; movement follows HMD direction
Snap turn	Right thumbstick left/right; 45-degree turns
Aim weapon	Point the right controller
Fire	Right index trigger
Two-hand rifle support	Hold the left grip near the weapon’s fore-end
Aim down sights / use scope	Hold the left grip and physically shoulder the weapon near the headset sight line
Jump	Left index trigger
Use / interact / pick up	Left X
Eject magazine or reload	Right A
Sprint	Click and hold the left thumbstick while moving
Crouch	Tap right B
Prone	Hold right B
Melee	Click the right thumbstick
Next weapon	Tap left Y
Frag grenade	Hold left Y for at least 0.3 seconds, then release to throw
Flashbang / tactical grenade	Right grip
Night vision	Right thumbstick down
Rifle grenade launcher / weapon slot 5	Right thumbstick up
Pause / open menu	Left controller menu button

Physical magazine reloading

For supported detachable-magazine rifles, SMGs, and pistols:

1. Press right A to eject the current magazine.
2. Move the left controller to your left hip.
3. Squeeze and hold the left grip to draw a fresh magazine.
4. Carry the magazine to the weapon while continuing to hold the grip.
5. Release inside the magazine well to insert it.
6. Releasing away from the magazine well drops the magazine.

Shotguns, launchers, bolt-action rifles, belt-fed weapons, and weapons without a usable detachable magazine use right A for COD4’s original reload behavior.

Physical reloading can be disabled by setting KISAK_VR_MANUAL_RELOAD=0 in VR-Settings.bat.

Mission-action shortcuts

Touch and hold the right controller’s thumbrest sensor while moving the left thumbstick. Normal movement is suspended while the modifier is active.

Modified input	Action
Right thumbrest + left stick up	Rifle grenade launcher / weapon slot 5
Right thumbrest + left stick down	Night vision
Right thumbrest + left stick left	Airstrike / mission action slot 6
Right thumbrest + left stick right	C4 / mission action slot 7

Menus

Action	Control
Move virtual cursor	Left thumbstick
Confirm / select	Right A
Back	Right B
Open or close pause menu	Left controller menu button

Right A therefore reloads during gameplay but remains the confirm button while a menu is open.

Special weapons and mission sequences

• Javelin and Stinger: Aim with the right controller, hold the left grip, bring the weapon into the eye-level aiming pose, wait for target lock, and fire with the right trigger.
• Mounted and vehicle weapons: Aim with the right controller and fire with the right trigger.
• Fixed scoped rifles/turrets: Aim with the headset, use the left thumbstick vertically to adjust zoom, and fire with the right trigger.

Known limitations

• Death From Above remains unsupported and must be skipped.
• Continuous touch-driven finger curling is not implemented; the hand uses authored free, rifle-grip, and magazine-grip poses.
• Meta Quest 3 with Virtual Desktop OpenXR is the primary tested configuration. Other OpenXR headsets, runtimes, and controller profiles are experimental.