Black Mesa

Black Mesa

1,193 ratings
Setting up a "Custom" Folder
By Citizen⁵
Using a Custom folder, which Black Mesa doesn't provide by default, is a useful way to install add-ons that don't work when downloaded via the Workshop, use legacy modifications from the non-Steam version of the game, or just install mods that aren't packed into a VPK. Here's how to set up such a folder.
6
28
2
2
2
2
   
Award
Favorite
Favorited
Unfavorite
Introduction
As I've learned the hard way, certain modifications to Black Mesa don't work when they're downloaded from the Workshop. This is because the game enforces consistency for certain files, which means that they can't be modified via Workshop items. Setting up this folder can override this enforcement, and can also be used to install add-ons that are non-VPK and made for the mod version of Black Mesa.

Note that in the case of mod version add-ons, incompatibility issues may arise due to differences between the mod and retail versions of Black Mesa. Be careful about what you try to install.

As of the 1.5 (Definitive) update you will no longer need to create the custom folder yourself - it comes with a fresh install - and the game will now properly read most custom assets from the Workshop!
Setting up the folder
The folder itself should go in your main BMS directory - that is, "SteamApps/Common/Black Mesa/bms". Simply create a folder in that directory and name it "custom".
Within this folder, the format for installing add-ons is as follows:
  • VPK based add-ons go directly in the Custom folder
  • Non-VPK add-ons go into a subfolder inside the Custom folder

To handle non-VPK add-ons, create another folder inside the Custom folder and name it whatever you want (like the "mods" folder shown above). This folder that you just created inside the Custom folder will be treated as an alternate main directory. This means that the root asset directories (models, materials, sound, maps, particles, etc.) for the add-on start from that folder. Your directory paths should be like this:
  • bms/custom/mods/models/your_model.mdl
  • bms/custom/mods/materials/your_material.vmt
  • bms/custom/mods/particles/your_particles.pcf
  • bms/custom/mods/maps/your_map.bsp

This is NOT correct:
  • bms/custom/materials/your_material.vmt

Never name one of your Custom subfolders after a loose directory, it will prevent you from starting up your game altogether!

Note that it is possible to set up multiple subfolders in Custom if you want, each with their own assortment of files. You can utilize this to sort your addons by type.
Setting up gameinfo.txt
DISCLAIMER:
YOU MAY HAVE TO REDO THE FOLLOWING STEP AFTER GAME UPDATES, OR AFTER VALIDATING YOUR GAME FILES! In these situations, gameinfo.txt is replaced, overriding any previous modifications.

Open the file "gameinfo.txt", also found in the "bms" folder.

Scroll down until you see a section named "SearchPaths".

At the top of this section (above all the other game+mod entries), add the line
game+mod bms/custom/*
like so:

Save the text file, close it, and you're done! The next time you start it up, Black Mesa will read the files you placed in the Custom folder.
Moving Workshop addons to the Custom folder
Once the Custom folder is set up, you can go ahead and move some custom content into it, including your problematic Workshop addons.

You can either use Crowbar to obtain the files, or move it from your Workshop directory to the Custom folder.

To obtain the files from the Workshop:

  • Subscribe to the addon.
  • Find the addon's Workshop ID in the URL. If browsing the Workshop on Steam, make sure you have web addresses enabled (Steam > Settings > Interface > Display web address bars when available) so you can see the URL.




  • In file explorer, navigate to Steam\steamapps\workshop\content\362890 and search for the folder named after this Workshop ID.



  • Open this folder and copy the contents to your Custom folder.
  • Unsubscribe from the Workshop addon.
  • Enjoy your newly functioning custom content!



414 Comments
Bagugetek 6 Jun @ 12:36pm 
I didn't get the custom folder with a fresh install tho.
Lindelheimen 19 May @ 11:08pm 
reinstalled BM because of the 10 year anniversary and my stuff is NOT working at all :wilted_flower:
michalerealdoom 1 May @ 4:09am 
how do i remove this
SodaSucker9000 12 Apr @ 5:48pm 
bk_the_goofster-#savehalflife i had that too
MaxVan12 26 Mar @ 4:47pm 
This shit dose not even work
blake_happypride 26 Mar @ 1:02am 
odd? i already had " game+mod bms/custom/* " written in but it was set as game+mod
bms/custom/*
MegaStromboli 4 Feb @ 2:47pm 
Figured out that's only for campaigns apparently. I'll assume that this is suppose to work then and try my game out. Thanks
MegaStromboli 4 Feb @ 2:40pm 
Is it normal to not see the add-on be available in the workshop menu when I launch the game? It's not there, despite having followed your instructions.
Warm Bowl Of Peas 23 Dec, 2024 @ 5:00pm 
I'm putting the M4A1 insurgency mod in to Black Mesa Military. Do I put the custom file in to bmmilitary or bms
anormalgamer54432 22 Dec, 2024 @ 3:19pm 
is there supposed to be only 2 files in the mod being BMBSGlock and bmbsglock.vpk.sound.cache?