Installing SourceMod
Language: | English • 한국어 • русский • 中文 |
---|
Installing SourceMod is very simple, and it can be added with almost no configuration changes.
The below is a detailed install guide and provides excellent issue and install feedback. However, if you're having troubles understanding the page and its instructions, a simplified install guide is available here.
Contents
Prerequisites
A GUI Web Browser to retrieve Metamod and SourceMod compressed archives. A tool to copy archive to your dedicated server host.
SourceMod requires Metamod:Source 1.8.0 or higher. Click here to visit the Metamod:Source homepage. Instructions to install SourceMM manually can be found here.
SourceMod will run on any mod built using the Source SDK. It also supports "The Ship," which uses the Source engine.
Uploading/Installing
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). Download Here
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:Source, dod for Day of Defeat:Source, 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.
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.
Alternatively, if you copied the tar.gz to your srcds directory, execute the following from the cstrike sub directory: tar -xzf ../sourcemod-1.1.0.tar.gz
Checking the Install
Your folder layout should look like:
- [mod] - Your mod's folder
- addons
- metamod - Metamod:Source
- sourcemod - SourceMod
- addons
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, since 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 Listing 1 plugin: [01] SourceMod (1.1.0.2489) by AlliedModders LLC
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.1.0.2489 SourcePawn Engine: SourcePawn 1.1, jit-x86 (build 1.1.0-svn) SourcePawn API: v1 = 4, v2 = 2 Compiled on: Sep 5 2008 02:02:12 http://www.sourcemod.net/
Lastly, assuming you have already setup your administration user, you can test the in game menu by joining the server, and in the client console type the following:
sm_admin
You should see a menu popup with all you options.
Troubleshooting
If the install failed, you will generally see one of four symptoms.
Metamod reports NOFILE or FAILED
If "meta list" replies with something like this:
] meta list Listing 1 plugin: [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
Metamod lists no plugins
If "meta list" replies with something like this:
] meta list Listing 0 plugins:
There are several causes of this error.
- The most common cause is that sourcemod.vdf can't be located in the addons/metamod folder. Verify that sourcemod.vdf is present in this folder.
- If sourcemod.vdf is present, make sure you are using the correct build of Sourcemod (zip = windows, tar.gz = linux).
- If the game was recently updated, it may be using a newer filesystem interface causing MetaMod to disable VDF loading. Try switching to a snapshot build or manually add sourcemod to MetaMod's addons/metamod/metaplugins.ini
Metamod says nothing
If "meta list" has no reply at all, Metamod:Source is not properly installed. This wiki page may provide you with clues on how to solve this problem.