0%
Loading...
NolimitHost

How to Install Steam Workshop Mods on Your Left 4 Dead 2 Server

Last updated: September 18, 2026

Left 4 Dead 2 addons - custom campaigns, weapons, and skins - live in the server's addons folder as .vpk files. This guide covers both manual deployment and mounting a Steam Workshop collection.

Where Addons Go

Content Location Format
Custom campaigns (not from Workshop)left4dead2/addons/.vpk
Workshop itemsleft4dead2/addons/workshop/.vpk

The Source engine automatically indexes .vpk files in these folders when the server starts.

Method 1: Manual Deployment (Recommended)

  1. In Steam, subscribe to the Workshop item (or campaign) on your own account so it downloads to your PC.
  2. Find the .vpk files in your local Workshop cache, under Steam/steamapps/workshop/content/550/.
  3. Log in to the NolimitHost Game Panel and stop your server from the Console page.
  4. Upload the .vpk files to left4dead2/addons/ (or left4dead2/addons/workshop/ for Workshop items). Use SFTP for large files.
  5. Restart the server, then load the campaign with changelevel <map>. See Change the Map.
Important: Custom campaigns often ship as a pair of files (for example campaign_dir.vpk and campaign_000.vpk). Upload all of the files, or the addon will not load.

Method 2: Mount a Workshop Collection

Instead of uploading files, you can tell the server to fetch a Workshop collection at startup using a launch parameter with a Steam Web API key:

+host_workshop_collection <COLLECTION_ID> -authkey <YOUR_STEAM_API_KEY>

Add this to the server's launch options on the Startup tab. The collection must be public, and you need a Steam Web API key from your Steam account.

Note: There is no single sv_workshop setting for this. The related convar is sv_consistency, which controls whether clients must have identical files.

Making Custom Content Joinable

  • Set sv_consistency 0 in server.cfg so clients without exactly matching files can still join.
  • Players still need the campaign subscribed locally (or you serve the map files through FastDL) to play custom maps.
  • Restart the server after uploading new addons so they are indexed.

Verifying Addons

Command Description
show_addon_metadataLists mounted addons the server has loaded.
maps *Lists all maps, including those from loaded campaigns.
Important: Always stop the server before uploading large .vpk files. Transferring addons while the server runs can corrupt the upload or crash the server.