Black Mesa

Black Mesa

344 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.
As I've learned the hard way, certain modifications to Black Mesa don't work when they're downloaded from the Workshop. For instance, I've made add-ons that modify the character manifest for the game's Face Creation system and the particle effects for the frag grenade, and neither of them work with the add-on system. 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 be used to install add-ons that are non-VPK and made for the mod version of Black Mesa.

Note that in that case, incompatibility issues may arise due to certain disparities between the mod and retail versions of Black Mesa. Be careful about what you try to install.
Setting things up
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 an additional folder inside the Custom folder

To handle the latter, create another folder within Custom, the name doesn't matter (like the "mods" folder shown above). From there, this folder that you just created inside the Custom folder shall be treated as an alternate main directory. This means that the file directories (models, materials, sound, maps, particles, etc.) for the add-on start from that folder. That is to say, 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.

YOU MAY HAVE TO REDO THE FOLLOWING STEP AFTER CERTAIN GAME UPDATES, OR AFTER VALIDATING YOUR GAME FILES! In these situations, gameinfo.txt is replaced, overriding any previous modifications.
Once the necessary directories are in place, 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.

< >
Chao_master777 Nov 12 @ 5:48pm 
i deleted a file called system 32 is that bad? i was trying to get the super rare rose gold hev suit
Citizen⁵  [author] Oct 9 @ 10:42am 
Try snd_restart or start up the game without the sound mods, otherwise try changing "game+mod" to just "game" or "mod"
Otherwise I have no idea what to do
Oh and yeah I'm using both custom and workshop. But the usage of files are separate. Like for example the sound mods I use workshop, but the guns and classic gluon gun are used in custom. Also the Won menu has sounds too, so yeah I have those two files on custom.
@Citizen only for the guns, and the Won menu. Nothing else.
Citizen⁵  [author] Oct 8 @ 10:13pm 
Are you using any sort of sound mods either with the Custom folder or in the Workshop?
There's a problem when I type the custom folder path in the gameinfo file. Every time I put it in, the music for Black Mesa will not play or won't work at all. I tried removing it, and it works. But when I type it back in it won't work once again. Please help!
_TheBug_ Oct 1 @ 3:41pm 
not unless you don't want work shop items
rasasdf Aug 23 @ 9:28am 
i deleted a file called workshop was that important?
Egon Aug 3 @ 11:23am 
@Valdor Did you move the install folder for it to another hard drive on your computer? If you have, just find the folder called 'Steam Library' on that hard drive and in that should be steamapps/common with your Black Mesa folder.
Valdor Aug 3 @ 11:10am 
I don't have a Black Mesa Folder in Common. I am opted in to the public beta and I am playing in the most recent version of it.