Install SourceMod

From SteamFriends Wiki

What is SourceMod?
You can look at SourceMod as the all in one admin solution for Source based gaming servers (HL2 mods etc).
Its like AMXModX was for HL1 but then better. Basically the only thing you need in order to run SourceMod is a valid Source based gaming server and MetaMod: Source installed.

How to install MetaMod?
MetaMod is an API handler for the Source engine that takes care of important tasks, in order for SourceMod (that runs under MetaMod: Source) to work you need to install MetaMod: Source first. To do this follow the steps below:

Download the appropriate package for your server: there is a Linux tarball and Windows zip file. You can get this from the MetaMod: Source Website.
Open the package, you will either have "server_i486.so" or "server.dll".
Find your "mod folder" on your server. This will be something like "cstrike" or "hl2mp".
Make a folder in your mod folder called "addons", if it doesn't already exist. Make a folder inside addons called "metamod", and a folder inside "metamod" called "bin".
Create a new, blank, text file called "metaplugins.ini".
Upload the files to your server:
- Upload the server.dll or server_i486.so file to your addons/metamod/bin Folder.
- Upload the metaplugins.ini file to your addons/metamod folder.
- WARNING! - Do not replace the mod's server.dll/server_i486.so (usually in "<mod>\bin"). This will cause your mod to stop working.
Open the file in the mod folder called "gameinfo.txt". You will see a few lines at the bottom like this:
```
SearchPaths
{
	Game				|gameinfo_path|. 
	Game				cstrike
	Game				hl2
}
```
Add a line after the "{" sign but before all of the "Game" entries that looks like this:
```
GameBin				|gameinfo_path|addons/metamod/bin
```
You're done! To test whether it worked, restart your game server and type "meta" in the server console. You should get a menu.
Optional Cvars: mm_pluginsfile - Sets the path and name of the plugins file, defaulting to "addons/metamod/metaplugins.ini". It is relative to the mod directory.

Installing SourceMod
SourceMod will run on any mod built using the Source SDK. It also supports "The Ship," which uses the Source engine.

1 Uploading/Installing
- 1.1 Local Server
- 1.2 Remote Server
2 Checking the Install
3 Troubleshooting
4 Support

[edit] Uploading/Installing

[edit] Local Server

To install SourceMod locally, simply extract the .zip (Windows) or .tar.gz (Linux) package to your mod folder (i.e. cstrike for Counter-Strike, dod for Day of Defeat, et cetera).

Next, open the addons/metamod/metaplugins.ini file with your favorite text editor (for example, notepad). Add this line:

addons/sourcemod/bin/sourcemod_mm

Save and exit.

[edit] Remote Server

To install SourceMod remotely, first extract the .zip (Windows) or .tar.gz (Linux) package to your local computer (for example, your Desktop). You will see an addons folder.

Using a tool such as FTP, locate your mod folder (i.e. cstrike for Counter-Strike, dod for Day of Defeat, et cetera). Underneath this folder, you should have an addons folder (if not, Metamod:Source is probably not installed). From your local addons folder, upload the entire contents to your remote addons folder. When done, your remote addons folder should have a sourcemod folder.

Next, copy the addons/metamod/metaplugins.ini file from FTP onto your computer. Open it up with your favorite text editor (for example, notepad, or wordpad if you run into problems), and add the following line:

addons/sourcemod/bin/sourcemod_mm

When done, save and exit. Then, copy the file back to your server, overwriting the original addons/metamod/metaplugins.ini file.

If you have trouble with these steps, you need to get acquainted with FTP and server management. However, you can also ask your server provider for help. Some providers also have web interfaces for managing your server.

[edit] Checking the Install

Your folder layout should look like:

[mod] - Your mod's folder
- addons
  - metamod - Metamod:Source
  - sourcemod - SourceMod

Once SourceMod is uploaded/copied and configured with Metamod:Source, restart your server completely. If it is local, shut it down and restart it. If it is remote, you may need to ask your server provider for help. However, it is often safe to issue a "quit" command via rcon, and most providers will automatically restart your server.

First, in your server console (not client console), type:

meta list

If the install worked, you will see something like:

] meta list
-Id- Name                  Version     Author           Status  
[01] SourceMod             1.0.0.571   AlliedModders,   RUN

You should then be able to use the SourceMod root console command, which can be invoked with simply:

sm

For example:

] sm version
 SourceMod Version Information:
    SourceMod Version: 1.0.0.571
    JIT Version: JIT (x86), 1.0.0.431
    JIT Settings: Generic 80486
    http://www.sourcemod.net/

[edit] Troubleshooting

If the install failed, you will generally see one of four symptoms.

[edit] Metamod reports NOFILE or FAILED

If "meta list" replies with something like this:

] meta list
-Id- Name                  Version     Author           Status  
[01] -                     -           -                NOFILE

Most likely, either the files are not located in the correct place, or the file could not be loaded. For more information, use the following command (except use the correct list number):

meta list 1

[edit] Metamod lists no plugins

If "meta list" replies with something like this:

] meta list
-Id- Name                  Version     Author           Status

You forgot to add SourceMod to the addons/metamod/metaplugins.ini file. Or if that doesn't fix your problem, make sure you are using the correct build of Sourcemod (zip = windows, tar = linux).