Adding plugins to your Left 4 Dead 2 server allows you to drastically customize the game. You can add admin menus, custom infected spawn rates, chat commands, and completely new game modes. Because Left 4 Dead 2 runs on the Source engine, it requires two core framework tools installed first before any plugins will work: MetaMod:Source and SourceMod.
Always make sure your server is completely stopped in your MintServers panel before uploading or extracting new framework files!
Step 1: Install MetaMod and SourceMod
Before you can install individual plugins, you must build the foundation. Both of these tools are completely free and widely used across all Source engine games.
- Log into your MintServers panel and click Stop to shut down the server.
- In a new web browser tab, go to the official MetaMod:Source website and download the Linux build (since your MintServers panel runs on Linux).
- Next, go to the official SourceMod website and download their Linux build as well. You should now have two downloaded archives on your computer.
- Return to your MintServers panel and navigate to the Files tab on the left-hand sidebar.
- Click into the
left4dead2folder. This is your main game directory. - Drag and drop both the MetaMod and SourceMod archives from your computer directly into this
left4dead2folder. - Once uploaded, click the three dots next to each archive file and select Unarchive. This will extract the necessary
addonsandcfgfolders directly into your server files. You can safely delete the original archive files after extraction to save space.
Step 2: Uploading Your Custom Plugins
With the framework installed, your server is now ready to accept custom plugins. SourceMod plugins typically come in the form of an .smx file, which you can usually download from the AlliedModders forum.
- Download the desired
.smxplugin file to your computer. - In your MintServers Files tab, navigate to the specific plugins folder to upload it. Follow this path:
- Drag and drop your
.smxfile into this plugins folder.
📁 left4dead2
📁 addons
📁 sourcemod
📁 plugins
Step 3: Restart and Verify
The hard part is done! Now we just need to let the server process the new files.
- Navigate to the Console tab on your panel and click Start to boot up the server.
- As the server starts, it will automatically load SourceMod and any plugins sitting in that folder.
- To verify that everything is working, type the following command into your console text box and press Enter:
🛠️ Troubleshooting Installation
The console will output a numbered list of all currently active plugins. If you see your new plugin listed there, you are good to go!
If the command returns an error saying "sm" is unknown, that means SourceMod or MetaMod did not extract correctly in Step 1. Ensure those files were extracted directly into the main left4dead2 directory. If you are still stuck, no worries! Just open a support ticket and our team will gladly assist you with the setup!