SourceCoop is a cooperative mod for Source Engine games that enables single-player campaigns to be played together.
It currently supports 
Black Mesa and 
Half-Life 2: Deathmatch.
- Supports campaigns.
- Restores single-player functionality.
- Handles player and equipment persistence between maps.
- Easy to use optional addons.
- Easy for mappers to convert new and existing maps from single-player into cooperative.
| Table of Contents |
|---|
| 🖥️ Setup Guide - 🌎 Campaign Support - ⚙️ Configuration - 🌱 Contributing - 📸 Credits |
| 📡 Server Running Tips - 🔗 Public Servers |
| 📝 Developing - 🗃️ EDT Map Script Format - 📘 Authoring Maps |
If you are someone who is looking to play on a server, then you are already set up and ready to play! Cooperative servers can be found in the server browser just like any other server.
Upon joining a server, players will be able to automatically download most necessary files. For custom workshop maps in Black Mesa, players will have to manually subscribe to the Steam Workshop item before starting their game. An official Steam Workshop collection containing all supported SourceCoop maps can be found here.
If you are a server operator who is looking to host your own cooperative server, then follow a installation method below and forward the necessary ports:
The script installation will automatically go through the process of installing the server files and plugins that are required for running a cooperative server.
The Linux installation script has been tested with the following distributions:
- Ubuntu
- Debian
If the installation script does not support the Linux distribution that you are using, then feel free to modify the script and create a pull request!
-
Download the corresponding installation script for your system.
- Black Mesa
-
Run the following commands in a terminal to start the installation:
On script execution, the following directories will be created within the terminal's current directory:
- Black Mesa Dedicated Server
- SteamCMD
- Steam
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process ./srccoop-bms-windows-install.ps1
chmod +x "./srccoop-bms-linux-install.sh" ./srccoop-bms-linux-install.sh -
After the installation process is complete, the server can be started by running the following commands. Make sure that the necessary ports are forwarded so players to be able to join the server!
cd "Black Mesa Dedicated Server" ./srcds_coop.bat
cd "Black Mesa Dedicated Server" ./srcds_coop.sh
- Install a Source Engine Dedicated Server using
SteamCMD.
- Black Mesa Dedicated Server (AppID ➤ 346680)
- Half-Life 2: Deathmatch Dedicated Server (AppID ➤ 232370)
login "anonymous" app_update 346680 quit
login "anonymous" app_update 232370 quit
- Install Metamod:Source (latest tested build ➤ 1155) onto the server.
- Install SourceMod (latest tested build ➤ 7163) onto the server.
- Install the latest SourceCoop release onto the server.
- Forward the necessary ports.
A visual step-by-step guide for Black Mesa is also available on Steam.
In order for players to able to join the server, you will need to only forward the default game transmission TCP/UDP port 27015. All other ports are optional.
| Port | Forward Type | Description |
|---|---|---|
27015 |
TCP/UDP | Game transmission, pings and RCON - Can be changed using -port on startup |
27020 |
UDP | SourceTV transmission - Can be changed using +tv_port on startup |
27005 |
UDP | Client Port - Can be changed using -clientport on startup |
26900 |
UDP | Steam Port, outgoing - Can be changed using -sport on startup |
Black Mesa - Steam Workshop Collection
SourceCoop allows single-player map configurations without decompiling and redistributing; learn more about creating your own on the EDT Map Script Format.
If you have already created native cooperative support for your map by including a EDT file, please make a pull request onto the README.md with your Steam Workshop item link so we can showcase it off!
| Command | Description | Addon |
|---|---|---|
sm_coopmenu |
Displays the coop menu | Base |
sizeup |
Displays the coop menu | Base |
sm_thirdperson |
Type !thirdperson to go into thirdperson mode |
Thirdperson |
sm_firstperson |
Type !firstperson to exit thirdperson mode |
Thirdperson |
stuck |
Unstuck command | Unstuck |
unstuck |
Unstuck command | Unstuck |
sm_skipintro |
Starts a skip intro vote | Voting |
sm_restartmap |
Starts a restart map vote | Voting |
sm_changemap |
Shows a menu for changing maps | Voting |
sm_survival |
Starts a survival vote | Voting |
| Command | Description | Addon |
|---|---|---|
sc_save |
Exports last saved player equipment state to a file. | Base |
sc_load |
Imports saved data from file and attempts to equip each player. | Base |
sc_clear |
Clear persisted equipment and equip players with the map defaults. | Base |
sourcecoop_dump |
Command for dumping map entities to a file. | Base |
sc_dump |
Command for dumping map entities to a file. | Base |
sc_mkconfigs |
Creates default edt configs for all maps in the maps directory which are missing one. | Base |
sc_revive |
Force respawn player. | Revive |
sc_reload_maps |
Reloads all entries in the votemap menu from storage. | Voting |
| Name | Default | Description | Addon |
|---|---|---|---|
sourcecoop_version |
The version of the SourceCoop mod. | Base | |
sourcecoop_respawntime |
2.0 |
Sets player respawn time in seconds. | Base |
sourcecoop_start_wait_period |
15.0 |
The max number of seconds to wait since the first player spawned in to start the map. | Base |
sourcecoop_start_wait_mode |
2 |
0 = The timer is not skipped (exceptions are maps without an intro_type or delayed outputs set). 1 = The timer is skipped when all players enter the game. 2 = The timer is skipped when player count matches the previous map's player count. |
Base |
sourcecoop_end_wait_period |
60.0 |
The max number of seconds to wait since the first player triggered a changelevel. The timer speed increases each time a new player finishes the level. | Base |
sourcecoop_end_wait_factor |
1.0 |
Controls how much the number of finished players increases the changelevel timer speed. 1.0 means full, 0 means none (timer will run full length). |
Base |
sourcecoop_homemap |
The map to return to after finishing a campaign/map. | Base | |
sourcecoop_end_wait_display_mode |
1 |
Sets which method to show countdown. 0 is panel, 1 is hud text. |
Base |
sourcecoop_validate_steamids |
0 |
Validate players' Steam IDs? Increases security at the cost of some functionality breakage when Steam goes down. | Base |
sourcecoop_default_config |
Default edt file, relative to game folder. This file is copied when starting a map with missing config as <sourcecoop_default_config_dest>/<mapname>.edt. |
Base | |
sourcecoop_default_config_dest |
"maps" |
Destination folder for sourcecoop_default_config, relative to the game folder. Should be one of the edt scan paths! |
Base |
sc_killfeed |
2 |
Controls the display of the kill feed (0: disabled, 1: chat, 2: hud). If set to 2, then the plugin will spawn in fake clients to display on the kill feed. |
Base |
sc_killfeed_player_kills |
2 |
Controls display of player kills on the kill feed (0: hide, 1: players, 2: entities). |
Base |
sc_killfeed_entity_kills |
2 |
Controls display of entity kills on the kill feed (0: hide, 1: players, 2: entities). |
Base |
sc_killfeed_suicides |
2 |
Controls display of suicides on the kill feed (0: hide, 1: players, 2: entities). |
Base |
sourcecoop_survival_mode |
0 |
Sets survival mode. 0 = off. 1 will respawn players if all are dead, 2 will restart the map. |
Base |
sourcecoop_survival_respawn |
1 |
Whether to respawn dead players at checkpoints. | Base |
sourcecoop_survival_spawn_timeout |
-1 |
Number of seconds after the map starts (after initial timer) to allow spawning in, or -1 for no time limit. |
Base |
sourcecoop_difficulty |
0 |
Sets the difficulty - from 0 (base difficulty) and up. |
Difficulty |
sourcecoop_difficulty_auto |
2 |
Sets automatic difficulty mode. -1 disables. 0 balances difficulty between min and max convars. Values above 0 set the difficulty increment per player, ignoring the min and max cvars. |
Difficulty |
sourcecoop_difficulty_auto_min |
1 |
When automatic difficulty mode is set to 0, this is the difficulty at 1 player. |
Difficulty |
sourcecoop_difficulty_auto_max |
20 |
When automatic difficulty mode is set to 0, this is the difficulty at max players. |
Difficulty |
sourcecoop_difficulty_announce |
1 |
Toggles announcing changes in difficulty. | Difficulty |
sourcecoop_difficulty_ignoredmgto |
List of classnames where player->npc damage is exempt from difficulty scaling. Separated by semicolon. | Difficulty | |
sourcecoop_difficulty_ignoredmgfrom |
List of classnames where npc->player damage is exempt from difficulty scaling. Separated by semicolon. | Difficulty | |
sourcecoop_earbleed_default |
0 |
Sets the default setting of the earbleed player preference. | Earbleed |
sourcecoop_fpd_fade_ms |
1500 |
Duration in milliseconds to fade the first-person death screen to black. 0 to disable. |
First Person Death |
sourcecoop_fpd_player_toggle |
1 |
Enable players to choose death camera option regardless of server/map settings. | First Person Death |
sourcecoop_logo_material |
The material used for the landing screen. | Landing Screen | |
sourcecoop_revive_time |
4.0 |
Sets time that you have to hold E to revive. |
Revive |
sourcecoop_revive_score |
1 |
Sets score to give for reviving a player. | Revive |
sourcecoop_revive_messages |
0 |
Shows messages such as "You have started reviving x." |
Revive |
sourcecoop_revive_ragdoll_effects_timer |
4.0 |
Delay for applying ragdoll highlighting effects. -1 to disable all ragdoll effects. |
Revive |
sourcecoop_revive_ragdoll_particle |
1 |
Whether to spawn a particle inside player ragdolls to improve their visibility. | Revive |
sourcecoop_revive_ragdoll_blink |
1 |
Whether to blink player ragdolls to improve their visibility. | Revive |
sourcecoop_revive_in_classic_mode |
1 |
Whether to allow reviving in non-survival mode. | Revive |
sourcecoop_killfeed_default |
0 |
Sets the default setting of the killfeed player preference. | Scoring |
sourcecoop_thirdperson_enabled |
1 |
Is thirdperson enabled? | Thirdperson |
sourcecoop_next_stuck |
60.0 |
Prevents using stuck for this many seconds after using. | Unstuck |
sourcecoop_voting_autoreload |
1 |
Sets whether to reload all votemap menu entries on mapchange, which can prolong map loading times. | Voting |
sourcecoop_voting_skipintro |
1 |
Allow skip intro voting? | Voting |
sourcecoop_voting_restartmap |
1 |
Allow restart map voting? | Voting |
sourcecoop_voting_changemap |
1 |
Allow change map voting? | Voting |
sourcecoop_voting_survival |
2 |
Allow survival mode voting? Use one of the values from sourcecoop_survival_mode to select the mode to vote for. |
Voting |
sourcecoop_workshop_message |
"Missing map! Subscribe to SourceCoop workshop collection + restart game" |
The message to display to players missing workshop maps. Supported placeholders: {BSPNAME}. |
Workshop |
ConVar: sc_ft <FEATURE> <0 or 1>
It is recommended to leave these features at the default values as these are configured per map within EDT configurations. Modifying feature values could negatively impact the gameplay experience.
| Feature | Description |
|---|---|
FIRSTPERSON_DEATHCAM |
Enables the first-person death camera. |
HEV_SOUNDS |
Enables HEV sounds. |
INSTANCE_ITEMS |
Instances pickup items and weapons for each player. Instanced items disappear once picked up and 'respawn' along with the player. |
INSTANCE_ITEMS_NORESET |
If enabled, picked up items will not 'respawn' after death. |
KEEP_EQUIPMENT |
Makes players spawn with previously picked up equipment (suit, weapons). Global for all players. |
DISABLE_CANISTER_DROPS |
Disables item drops when players die in multiplayer. |
NOBLOCK |
Prevents player-on-player collisions. (This feature requires mp_teamplay 1 to fix smoothness issues.) |
SHOW_WELCOME_MESSAGE |
Shows players a greeting message with basic plugin info. |
AUTODETECT_MAP_END |
Detects commonly used commands for ending singleplayer maps from point_clientcommand and point_servercommand entities and changes the map. At first, this feature checks sourcecoop_homemap is set (see below), then checks if nextmap is set. If none are set, the map is not changed. Recommended to keep enabled. |
CHANGELEVEL_FX |
Show visual effects (spawn particles) at level change locations. |
TRANSFER_PLAYER_STATE |
Enables player persistence through level changes. Currently, players will carry over their health, armor and equipment for the first spawn point (checkpoint) in the map. Afterwards, the default map equipment is used. |
SP_WEAPONS |
Sets whether to use the singleplayer variants of weapons. |
If you are looking to help with the development of the project, we are always looking for more help! Heres some ways you can help:
- Reporting inconsistencies and bugs
- Debugging and tracking down issues
- Adding features
- Adding new configurations for campaigns and maps
If you are interested in helping us, contact us on Discord or create a pull request.
- ampreeT :: Steam | GitHub :: programming, reverse engineering, map editing
- kasull :: Steam | GitHub :: programming, reverse engineering
- Alienmario :: Steam | GitHub :: programming, reverse engineering, map editing
- Balimbanana :: Steam | GitHub :: programming, reverse engineering
- Rock :: Steam | GitHub :: programming, map editing
- Krozis Kane :: Steam | GitHub :: map editing
- ReservedRegister :: GitHub :: reverse engineering
- raicovx :: Github :: equipment persistence
- Jimmy-Baby :: Github :: damage effects addon
- Removiekeen :: Steam :: logo design
- yarik2720 :: Github :: russian translation, ci/cd
