We have introduced a code of conduct. This change only codifies our existing rules, for any newcomers to read. All users are expected to abide by them.

Black Mesa

From PCGamingWiki, the wiki about fixing PC games
This game is currently undergoing beta testing and development - information here may change frequently and could be outdated or irrelevant.
Black Mesa
Black Mesa cover
Crowbar Collective
Release dates
Windows Early access
Linux TBA
Half-Life 1998
Half-Life: Opposing Force 1999
Half-Life: Blue Shift 2001
Half-Life: Source 2004
Half-Life 2 2004
Half-Life 2: Deathmatch 2004
Half-Life 2: Lost Coast 2005
Half-Life Deathmatch: Source 2006
Half-Life 2: Episode One 2006
Half-Life 2: Episode Two 2007
Half-Life: Decay (unofficial mod) 2008
Black Mesa TBA

General information

Official website
Steam Community Discussions


Source DRM Notes Keys OS
All versions require Steam.
The legacy release, or original mod release, remains available for download at the Official Website.
An MP3 Album of the Official Soundtrack is also available for free with the option to donate at the Official Website, as well as at Joel Nielsen's Website. Lossless formats are available for purchase from Bandcamp.

Essential improvements[edit]

Enabling the console[edit]

Options menu
  1. Go to Options, select the Keyboard tab and click on Advanced.
  2. Check Enable the developer console and open the console by using ~.

Game data[edit]

Configuration file(s) location[edit]

System Location
Steam <path-to-game>/bms/cfg

Save game data location[edit]

System Location
Steam <path-to-game>/bms/save
Saved games cannot transfer between the mod release and Steam release. Use sv_unlockedchapters 15 in the console to unlock all chapters.[1]

Save game cloud syncing[edit]

System Native Notes
Steam Cloud

Video settings[edit]

Graphics option Option WSGF Notes
Widescreen resolution
Force a resolution with -w 1920 -h 1080 parameters.
HUD is not centered.
Field of view (FOV)
75-90° horizontal. Can be adjusted outside the slider's range using fov_desired XX (XX the desired value, max 120) in console.
Borderless fullscreen windowed
Use -window -noborder parameters.
Anisotropic filtering (AF)
Up to 16 samples.
Anti-aliasing (AA)
Up to 8x MSAA. Also up to 16xQ CSAA (older Nvidia GPUs only).[2]
Vertical sync (Vsync)
60 FPS
120+ FPS
Frame rate is capped at 300 FPS; use +fps_max XX parameter.

Input settings[edit]

Keyboard and mouse Native Notes
Mouse acceleration
Default is off. Can be toggled in mouse options.
Mouse sensitivity
Mouse input in menus
Mouse Y-axis inversion
Controller support
Full controller support
Menus cannot be navigated with a controller.
Controller remapping
Controller sensitivity
Controller Y-axis inversion
Additional information
Button prompts
Controller hotplugging
Haptic feedback

Toggle crouch[edit]

Add script to autoexec.cfg[3]
  1. Go to <path-to-game>/bms/cfg/.
  2. Open autoexec.cfg and add this:
    alias t_duck "duck1"
    alias duck1 "+duck; alias t_duck duck2"
    alias duck2 "-duck; alias t_duck duck1"
    bind "ctrl" "t_duck"
    • Replace ctrl with desired crouch key.
  3. Launch the game and bring up the console.
  4. Type in and enter exec autoexec.

Audio settings[edit]

Audio options Native Notes
Separate volume controls
Music volume slider.
Surround sound
4.0, 5.1 and 7.1 surround sound.
Closed captions
Mute on focus lost
Can be toggled in audio options.


Language UI Audio CC Notes


Multiplayer types

Type Native Notes
LAN play
Online play

VR support[edit]

Issues fixed[edit]

Fullscreen on Windows 10[edit]

Enable borderless fullscreen mode[4]

If your game gets a black screen on Windows 10 in fullscreen mode, use this quick fix:

  1. Go to Black Mesa's "Properties" and then "Set launch options."
  2. Enter "-window -noborder".
  3. If you use an adaptive sync monitor, set it to run in windowed mode if possible. This is an option for G-Sync at least.

System requirements[edit]

Minimum Recommended
Operating system (OS) XP, Vista, 7 32/64-bit or Greater 7 32/64-bit or Greater
Processor (CPU) 1.7 GHz Processor or better Pentium 4 processor (3.0GHz or better)
System memory (RAM) 2 GB 4 GB
Hard disk drive (HDD) 13 GB 20 GB
Video card (GPU) NVIDIA GTX 200 series
ATi Radeon HD 4000 series
DirectX 9.0c compatible
NVIDIA GTX 650 series
ATi Radeon 7000 series
DirectX 9.0c compatible


  1. Transfer savegame from the Free Black Mesa :: Black Mesa General Discussions
  2. 16x Q CSAA? :: Black Mesa General Discussions
  3. Toggle crouch? :: Black Mesa General Discussions
  4. Windows 10 cannot play Black Mesa in Fullscreen :: Black Mesa General Discussions