Hand Quickbelts

Adds configurable quickbelt slots around both hands without replacing the player's normal body quickbelt.

Compatibility: H3VR 1.0 stable (Update 120).

Thunderstore | Source code

Features

• Independent large, medium, and small slot counts for each hand
• Symmetric placement with a mirrored pose for the opposite hand
• Live adjustment handles for moving and rotating the slot grid
• Configurable slot diameter, spacing, columns, and stored-object size
• Optional miniaturization to make items smaller while stored in the slot
• Collider-aware insertion for long or unusually shaped objects

Quick setup guide

1. Install with r2modman or Thunderstore Mod Manager and launch H3VR.
2. Enter a scene that enables quickbelts.

In-Game Slots Customization

1. Open the wrist menu, then select Mod Panel > Hand Quickbelts.
2. Configure the slot counts, grid, and stored-object behavior.
3. Enable Placement > Show Adjustment Handles.
4. Grab either colored handle with the opposite hand, move and rotate it, then release it to save. The other hand updates with the mirrored pose.
5. Disable the adjustment handles when finished.

Most settings update immediately. Changing slot counts or resetting the configuration rebuilds the hand slots and releases their contents. Scenes that disable H3VR's native quickbelt also disable Hand Quickbelts.

Configuration

• Slots: per-hand size counts, grid columns, spacing, and visual/interaction diameter
• Placement: shared anchor pose (mirrored for both hands), adjustment handles, and reset
• Stored Objects: miniaturization and maximum stored size as a percentage of slot diameter

Installation

Installing through a mod manager is recommended and installs the dependencies automatically.

For a manual installation, install BepInExPack H3VR and Sodalite, then place quaternion.hqb.dll in BepInEx/plugins.

Implementation

The mod clones H3VR's active spherical quickbelt geometry into palm-attached slots, keeping native materials and behavior. Small, targeted patches add collider-aware insertion and safe object-scale restoration.

Building

Requires the .NET SDK and NuGet access.

dotnet build .\HQB.sln -c Release

The release DLL is written to plugin/bin/Release/net35/quaternion.hqb.dll.

Run .\tools\package.ps1 to create a validated Thunderstore ZIP. See the publishing guide for first-upload and update steps.

Support

Tips and donations are welcome on Ko-fi. You can find my other projects and links at quaternion7.github.io.

License

Hand Quickbelts is available under the permissive MIT-0 license.

Credits

Inspired by Ax's SpineHero.

Changelog

0.4.2 - Release candidate

• Added compatibility with H3VR 1.0 stable (Update 120).
• Made hand slots follow H3VR's scene-level quickbelt availability.
• Released stored contents safely when entering a scene without quickbelts.

0.4.1

• Added a live integer setting for stored-object size as a percentage of slot diameter.
• Kept miniaturization shrink-only so objects are never enlarged.

0.4.0

• Consolidated the configuration into Slots, Placement, and Stored Objects.
• Added independent per-hand slot counts, a shared mirrored anchor pose, and grabbable adjustment handles.
• Matched native quickbelt visuals, hover states, interaction size, and object-size rules.
• Added world-space grid layout, collider-aware insertion, and optional stored-object miniaturization.
• Restored object scale safely before removal from a hand slot.

0.1.0 - 0.3.8 - Development

• Established the configurable BepInEx plugin and iterated on native slot discovery, geometry, interaction, layout, and scaling.
• Fixed prefab ownership, scene transitions, overlapping transparent visuals, scaled-hand spacing, and cumulative object growth.