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 require AlyxLib to work.
For most controllers: With a weapon equipped in your primary hand, hold your grip button 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.
For HTC Vive controllers: With a weapon equipped in your primary hand, move your hand to one of the seven holster slots on your body, then press the slide release button to holster.
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.
Buttons can be changed using console commands. Please see the Custom Input Actions Guide for more info.
- 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.
Console commands allow you to customize and tweak the addon while playing. They are not required to use the addon, and for most users the default values will provide a good experience.
If you don’t know how to use the console, follow this guide: https://steamcommunity.com/sharedfiles/filedetails/?id=2040205272
See the list of console commands here: https://steamcommunity.com/workshop/filedetails/discussion/3144612716/732500995379037046/
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
They can also be added to your Half-Life Alyxgamehlvrcfgskill.cfg file, one per line without the hyphen, e.g. body_holsters_visible 1
GitHub: https://github.com/FrostSource/body_holsters
Ammo displays on visible holstered weapons will show incorrect amount of ammo. Unfortunately I have not found a way to get the current ammo inside a weapon.
Trying to grab a weapon near the face while wearing a mask or respirator will cause the player to accidentally remove the worn item instead of the weapon. Unfortunately I have not found a way to get around this.
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.
Please feel free to reach out either by commenting below or on the Discord server!
