Body Holsters

Body Holsters is a global addon allowing you to store your weapons directly on your body instead of using the standard weapon selection menu.

This addon is compatible with Scalable Init Support but does not require it.

Holstering:

With a weapon equipped in your primary hand, hold your grip button (squeeze the controller gently for Valve Index Knuckles) and move your hand to one of the seven holster slots on your body until you feel a vibration in your controller, then release the grip to holster.

Unholstering:

With an empty primary hand, move your hand to a body slot which has previously had a weapon holstered in it, then press your grip button to unholster and equip.

Slots:

• Left Hip
• Right Hip
• Left Underarm
• Right Underarm
• Left Shoulder
• Right Shoulder
• Chest

---

Your weapon switch menu remains fully functional so you can mix your play-style between holsters and menus. Picking a weapon from the menu accidentally will not remove it from its body slot, but placing it into a different slot will remove it from its previous slot.

If you don’t know how to use the console, follow this guide: https://steamcommunity.com/sharedfiles/filedetails/?id=2040205272

---

• body_holsters_visible_weapons
  Default = 0
  Weapons will be visibly attached to the player body when holstered. If enabled when weapons are already holstered, they will have to be reholstered to appear.
  This convar is persistent with your save file.
• body_holsters_increase_offhand_side_radius
  Default = 1
  Body slots on the non-dominant side of your body will have a slightly larger radius to accommodate for increased reach distance.
  This convar is persistent with your save file.
• body_holsters_allow_multitool
  Default = 0
  Multitool is allowed to be holstered.
  This convar is persistent with your save file.
  See Known Issues below for important information about this!
• body_holsters_require_trigger_to_unholster
  Default = 0
  The use button will be required to unholster weapons instead of the grip.
  This convar is persistent with your save file.
• body_holsters_require_use_to_holster
  Default = 0
  The use button will be required to holster weapons instead of the grip.
  If you are a Quest user this might be required without changing any bindings.
  This convar is persistent with your save file.
• body_holsters_slot
  Syntax = holsters_slot <name> <x> <y> <z> <radius>
  Allows temporary modification of holster slot properties for debugging purposes, best used in conjunction with holsters_debug to see positions. Any changes will revert on map reload. Leave a comment if you think you’ve found better slot positions.

  If command is entered without any parameters all slots will be listed in the console.
  If only a name is provided that slot will be listed in the console.

  Parameters X/Y/Z are relative to the player body near the head. Setting 0/0/0 will put the slot at that position near the head. X is forward/backwards, Y is right/left, Z is up/down.

• body_holsters_debug
  Default = 0
  Draws debug spheres for the holster slots and their states.

---

Console commands can be set in the launch options for Half-Life: Alyx, just put a hyphen before each name and the value after, e.g. -body_holsters_visible 1

GitHub: https://github.com/FrostSource/body_holsters

Due to the way Half-Life: Alyx works, the multitool will fail to function correctly if equipped by some means other than the weapon selection menu. The multitool is not allowed to be holstered by default for this reason.

Maps without a backpack will function incorrectly.

Holstering can be buggy when the head is mismatched from the real life body (looking sideways while facing forwards). There is no easy way to track where the body is relative to the head.

If a map allows the player to have the same custom weapon in more than one weapon slot, holstering both might cause issues.

body_holsters_require_trigger_to_unholster will cause rapidfire weapons to shoot if the trigger is held too long after unholstering.