Skip to content
AleForge Documentation

Installing Sourcemod/Metamod

Many Source Engine games, such as Team Fortress 2, Counter-Strike Source, etc., can be extended using Metamod and Sourcemod. This guide will show you to install Metamod and Sourcemod on your AleForge game server.

What is Metamod?

Metamod is a C++ plugin environment for Source engine games. It essentially acts as a mod that sits between the game and the engine, allowing plugins to intercept calls that flow between. It specifically provides a mechanism called, which is a compelling library for intercepting, overriding, and superseding virtual function calls. You can find more information on their website.

What is Sourcemod?

Sourcemod is a server modification that depends on Metamod and then extends various Source engine games with a highly optimized platform for scripting plugins and handling server administration. A base set of plugins is included, but thousands of plugins are available in the community from sites such as the AlliedModders forums. You can find more information on their website.

Installation

Download Metamod and Sourcemod from the following URLs:

Grab the Penguin!

Here at AleForge, the servers run on Linux , so make sure to get the Linux versions of both files, which are identified by the penguin mascot of Linux.

We recommend stable builds unless you have a specific requirement. Once downloaded, you should have a folder ready with the 2 tar.gz archives, like so (the filenames and sizes may be slightly different):

Upload both of these archives to your server’s main game directory. Depending on your game, this may be tf , cstrike , etc.. A reference can be found below:

GameDirectory
Counter Strike:Sourcecstrike
Counter Strike: Global Offensivecsgo
Left 4 Deadleft4dead
Left 4 Dead 2left4dead2
Team Fortress 2tf

Using the File Manager, extract both of these archives by selecting them and then hitting the unarchive button.

Generate your Metamod vdf

In order for your game to recognize Metamod (and therefore Sourcemod), you must provide a metamod.vdf file in your addons directory. We’d recommend using the generator as found on the Metamod website, but a reference can be found below, using TF2 as an example:

"Plugin"
{
    "file"  "../tf/addons/metamod/bin/server"
}

Make sure you first delete the pre-existing metamod.vdf file in the addons directory, and then upload your newly generated one.

Final Steps

It’s now time to test the installation by starting up your server. Once your server is online again, you’ll want to run 2 commands to test that the installation was successful:

  • meta version
  • sm version

Both of these commands should print output about the version of Metamod/Sourcemod you are running. If it looks like the following, the installation was successful, you can begin using Sourcemod! If not, look back at the previous steps, or contact our support team for further assistance.

  • meta version
  • sm version