Half-Life: Alyx

Half-Life: Alyx

178 ratings
Body Holsters
5
   
Award
Favorite
Favorited
Unfavorite
File Size
Posted
Updated
965.856 KB
21 Jan, 2024 @ 12:26pm
16 Jul @ 10:31pm
10 Change Notes ( view )

Subscribe to download
Body Holsters

Description
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.



How To Use

Holstering:

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.

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.

Buttons can be changed using console commands. Please see the Custom Input Actions Guide for more info.

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.

Console Commands

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://gtm.steamproxy.vip/sharedfiles/filedetails/?id=2040205272

See the list of console commands here: https://gtm.steamproxy.vip/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 Alyx\game\hlvr\cfg\skill.cfg file, one per line without the hyphen, e.g. body_holsters_visible 1

Source Code

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

Known Issues

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.

Getting Help

Please feel free to reach out either by commenting below or on the Discord server!

[discord.gg]
Popular Discussions View All (2)
0
16 Feb @ 8:55pm
Console Commands
FrostEpex
0
16 Feb @ 8:49pm
Custom Input Actions Guide
FrostEpex
95 Comments
FrostEpex  [author] 23 Apr @ 11:02am 
First try entering the commands in the discussions "Console Commands" under "All Other Controllers" which should use grip for most controllers.

If that doesn't work please enter in the console "alyxlib_diagnose body_holsters" and share the results with me if there are no suggested fixes.

Unfortunately my computer is dead and will not be fixed for a while so I have limited capacity to debug problems.
BLACK SANTA 23 Apr @ 3:38am 
@FrostEpex Hello, have issues with Oculus Quest 3 (23.04.2025). Grip is not working (but I feeling vibration, check that initialized in console and turn debug spheres - it's ok). Tried to turn

"commands:body_holsters_unholster_is_analog 0"
"body_holsters_unholster_action 7" - not effect

and tried to "body_holsters_require_trigger_to_unholster" and "body_holsters_require_use_to_holster" to 1 - this commands not exist in console commands (maybe was deleted by update?)

Same issues, nothing changed:3 Can you help, please?)
Ang3l 6 Mar @ 9:38am 
Thank you very much, that really helped me. I can for some reason only unholster the weapons with trigger button but that is absolutly fine by me :DThank you!
FrostEpex  [author] 5 Mar @ 7:14pm 
I'm away for a few days. I'll point you to the Custom Input Actions Guide in the discussions section of this workshop page for instructions on the new options.
For your case you should be able to replace your old cfg lines with this:
body_holsters_unholster_is_analog 0
body_holsters_unholster_action 7
Ang3l 5 Mar @ 4:28pm 
Hello!

I really like the mod it gives more realism into the handling of the weapons. A while ago I played the game with unholstering the weapons with the trigger button because the grab button did never work for some reason. I have put the needed command into Skill.cfg as mentioned.

I started playing now after a while and noticed that it does not even work with trigger anymore or normal grab button. I saw you updated this mod recently. Can you tell me how to get the trigger or grab button work again?

Im using an Oculus Rift.

Thank you very much 😊
FrostEpex  [author] 22 Feb @ 3:59pm 
Yes activate AlyxLib last. You can simply click it twice in the menu to disable and enable which gives it priority. You shouldn't need to disable scalable init support if for some reason it is helping, but AlyxLib has scalable init support built in to try and keep things compatible.
CHAPO 22 Feb @ 3:50pm 
Thank you for responding so quickly! I use several mods, and they all worked fine, but to use the body holsters and partial clip storage, I needed to use AlyxLib. I don't remember the exact activation order, but I know I activated these three last, and some of the mods I mentioned stopped working I'll try again. Activate AlyxLib last, right? I should disable the Scalable Init Support?
FrostEpex  [author] 22 Feb @ 3:09pm 
Thanks for the feedback. I've determined the load issue is with AlyxLib and will be uploading a fix today.

Bullet Penetration uses custom mod loading which can override AlyxLib so you'll need to make sure AlyxLib is the last mod you enable in the menu so it has priority.

I can talk to the creator about this and further issues that could arrise but the above step works for me in testing.

The utility menu looks fully compatible from reading over the code and testing.

The combat overhaul has no compatibility issues because it only modified cfg files.
CHAPO 22 Feb @ 2:28pm 
the mod is great, but after dying and respawning, it’s no longer possible to holster weapons, and it stops working. You have to restart the game to make it work again. It’s also not compatible with several mods, such as the bullet penetration mod, spawn utility menu, gunman combat overhaul, etc. Is it possible to adjust it to work with these mods as well?
FrostEpex  [author] 17 Feb @ 2:54pm 
Yes I updated it at the same time. I'm using index controllers and found no issues on my end during testing. Can you run the new command: 'alyxlib_diagnose holsters' and send me the result here, on discord or as a steam friend?