Synergy

Synergy

60 ratings
Black Mesa In Synergy setup step-by-step
By Balim
This guide will hopefully help people who don't know how to install Black Mesa & Improved HL1 Xen Mod Support
   
Award
Favorite
Favorited
Unfavorite
Getting the InstallSourceMods script
Download InstallSourceMods.bat from here:
https://github.com/Balimbanana/SourceScripts/blob/master/Batch/InstallSourceMods.bat
Right click on "Raw" on the right side and click "Save Linked Content":
Make sure it is saved as InstallSourceMods.bat
Installing Black Mesa & Improved HL1 Xen
Double click the script where ever you installed it to.
You should get a screen like this:
What you need to type in is:
bms
and press enter.
You will get a screen like this:
Use the option auto to fully automatically download/install Black Mesa and Improved Xen.
If everything went well, it should start installing Black Mesa.

If you get the message:
"Something went wrong with the download, possibly an interrupted connection while downloading.
Or the file was downloaded with a different name or in a different directory.
Press any key to restart script..."
and you know that it is downloaded, try moving the download to your downloads directory, or to where the script is being run.
You can also try one of the other download options.

Manually
Download Black Mesa and Improved Xen from one of the other options.
If you are able to open the archive, you can enter:
sourcemods
at the first prompt of the script and it will open your sourcemods directory where you can extract Black Mesa manually if you need to.
Just make sure that when it is extracted that the name of the directory is "BMS" or it might not be detected by Synergy.
For extracting Xen, you only need to extract the directory "xen" from the archive and leave the rest.

You will also need the scripts fix to run it in Synergy It is automatically installed through the InstallSourceMods.bat script, if you already have Black Mesa installed, you can run the prompt again and it will ask if you want to apply the scripts fix.
If you want to do it manually, you can get it from here:
https://github.com/Balimbanana/SourceScripts/raw/master/synotherfilefixes/bmscripts.zip
Download that, then rename the scripts directory sourcemods\BMS\scripts to something else like scriptsbak, then extract bmscripts.zip to sourcemods\BMS\scripts in its place.
Getting the support files
If you are using InstallSourcemods.bat script, the support files will automatically install. So you can skip this section.

If you want to do it manually:
Subscribe to the Workshop Addon:
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1817140991
Once it has finished downloading, make sure you follow the instructions to get it to be used in Synergy.
Just subscribing will not work!
To find where your workshop directory is. Right click on Synergy on Steam and select Properties:
and Browse Local Files:
Then go to your steamapps directory:
Then go in to workshop\content\17520
and you should see a bunch of directories with numbers for names. These are Workshop ID's.
You need to right click 1817140991 and click "Copy"
Now go back to your Synergy directory from steamapps\common\Synergy and go in to synergy\custom
Then right click in the blank space of the folder and click Paste
You now have Black Mesa & Improved Xen Mod Support and you should see it in Create Server in the main menu. However, you will not be able to use any of the custom NPC's unless you join a server with the required plugins.
Installing the server
You will need to forward the port 27015 TCP/UDP in order to host a server.
Get the Syndsinstall27015.bat script from here:
https://github.com/Balimbanana/SourceScripts/blob/master/Batch/Syndsinstall27015.renametodotbat
Download it the same as the InstallSourceMods.bat script, by right clicking "Raw"

Save as ending in .bat so Syndsinstall27015.bat then move the script to where you want the server to be installed and run it by double clicking it. You should get a screen like this:
If you already have SteamCMD installed somewhere, you can enter the full directory path to it and press Enter.
If you don't have SteamCMD, enter:
s
and it will download/install to where you are running the script.
Now enter:
i
To perform the first install. Then press enter again to select the regular branch.
Now enter your username which will be passed to SteamCMD.

If you already have Synergy installed on your system, it will now take a few moments to copy over some static larger files so you don't have to download as much again for the server. It will then download the SteamCMD updates to current version. It may take a few minutes.
Once it has finished updating, you will get this screen:
Your password is entered as a secure string inside SteamCMD. This means that you will not be able to see characters coming up in the box as you type it. Just type your password as usual, and press Enter.
It should give a "Logged in OK" message and it will start downloading the Synergy dedicated server.
If any errors occur, you will need to restart the script and make sure you have the right username/password entered.
If it is installed you will get the prompt to edit your server config prompt:
and you will need SourceMod installed, so enter y at this prompt.
At this time, your plugins directory will open, but if you want to install these plugins, just press any key in the script. It will now bring you back to the start screen with a couple more options.You need to enter ism to install additional SourceMod plugins.
Then press enter again to select regular and you should see this:
What you need is:
ssr SynSaveRestore
hd HealthDisplay
synsweps Synergy Scripted Weapons
syndev SynFixes Dev
Once all those are installed, you can then go back to start with B
At this point, you need to install the workshop addon, you can do this in the imsp prompt:
If it says that you do not have Black Mesa or Improved Xen installed, you will need to install them same as the client in the second step.

Now you should have all the support files/plugins you need to run a Black Mesa in Synergy server.
Just enter R at the start prompt and enter to select regular branch, and you should be able to use:
changelevel bms bm_c0a0a
in the server console to change to Black Mesa.
76 Comments
pizzabyte 17 Dec, 2024 @ 4:24am 
i tried with my friend but some maps are broken and none of the npcs seem to be spawning in, something to note is that i'm using hamachi so i don't need a dedicated server so that might be the problem.
Xada 10 Apr, 2023 @ 4:24pm 
I seem to be unable to successfully install this on my server. I have gone through both manual as well as batch-automated script method multiple times and both refuse to spawn NPCs on maps even with the provided SourceMod plugins. Unsure what's going on but the NPC entities themselves aren't being recognized. Everything else seems to go well as far as I can tell. Any idea what's wrong :riddle:
BorisTales 4 Oct, 2022 @ 7:36am 
Hi! I am istalled client and server successfully, all works good! But my friend cant play with me, he have prblems with his client installation! We cant solve this problem... This is his error, when he commandet "BMS"/

Found Black Mesa archive.

7-Zip [64] 16.02 : Copyright (c) 1999-2016 Igor Pavlov : 2016-05-21

Scanning the drive for archives:
1 file, 1577741584 bytes (1505 MiB)

Extracting archive: .\BMS.7z
ERROR: .\BMS.7z
.\BMS.7z
Open ERROR: Can not open the file as [7z] archive


ERRORS:
Unexpected end of archive

Can't open as archive: 1
Files: 0
Size: 0
Compressed: 0
Something went wrong with the Xen download, possibly an interrupted connection while downloading.
Or your archive became corrupted somehow.
Something went wrong with the BMS download, possibly an interrupted connection while downloading.
Or your archive became corrupted somehow.
Press any key to restart script...



Help us please... :melon:
Balim  [author] 9 Jan, 2022 @ 2:35pm 
Yeah unfortunately. The manual method still works or if you use the other links, they should work.
est 9 Jan, 2022 @ 12:41pm 
Hi, the bat file now returns

'Exception calling "DownloadFile" with "2" argument(s): "The remote server returned an error: (404) Not Found."
At line:1 char:131
+ ... .WebClient; $WebClient.DownloadFile("http://thebdf.org/bm/BMS.7z.001" ...'

I assume this means that this method doesn't work anymore since the website is now down
xSirLalo 7 Nov, 2021 @ 7:22pm 
Wow, thanks very much its woks
Balim  [author] 7 Nov, 2021 @ 12:58pm 
For Linux, you will most likely need to link some sourcemods directories and extract the VPK that comes with the support directly in to Synergy/synergy for it to work.
I have linked with 'ln'
~/steamcmd/steamapps/sourcemods
~/steamcmd/steamapps/SourceMods
~/steamcmd/steamapps/Sourcemods
You may also have to link it all the way back at ~/.steam/steam/steamapps/sourcemods but check after the servers directories are linked if it shows up, it will be some of the first messages in console when you start up the server which directories it is attempting to load mods from, and whether or not it found Black Mesa with a message something like:
ContentLoader[SV]: Found SourceMod 'Black Mesa' in '/path/to/BMS'
xSirLalo 7 Nov, 2021 @ 10:49am 
In server with Ubuntu.
ContentLoader[SV]: Failed to find map in SetCurrentMap, Map: 'bm_c0a0a' GameTag: 'bms'!
Map 'bm_c0a0a' not found
Orsell 14 Jul, 2021 @ 2:13pm 
If you regarding to the steam release of bm, then no, the version that is currently used is for when bm was originally a source mod referred to as black mesa source. The new steam version is designed differently and even if you spent time trying to play the new maps in Synergy, they will not work at all. If you do want to do coop for the new bm, there are options out there, but they are in beta or alpha and are very buggy. There are also some coop servers already up on the multiplayer list too for the steam release of bm.
SleggarLaw 12 Jul, 2021 @ 7:49am 
does this mod still work with the new black mesa updates?