Configuring Metamod:Source

This article briefly overviews the basics of configuring a Metamod:Source installation.

Plugins

Adding Plugins

1. Open (or create) the "addons/metamod/metaplugins.ini" file in your mod folder (such as "cstrike" or "hl2mp").
2. Follow the installation instructions the plugin gives you - usually this means uploading its files.
3. Add a line to the file which points to the plugin's path. If the plugin is in cstrike\addons\sourcemod\bin\sourcemod_mm.dll, you would add:

   addons\sourcemod\bin\sourcemod_mm

   Note that you do not need to worry about the file extension - all you need is the mod folder relative path to the file. If you add an extension, it won't hurt, but it's autodetected anyway. Also, unlike the original Metamod, you do not need to specify whether the plugin is Linux or Windows. You can also specify a full path name, where autodetection will no longer work.
4. Save the file and either restart the server, change the map, or type "meta refresh" in the console. Note that some plugins need special hooks that may require a map change.

Removing Plugins

1. Open the "metaplugins.ini" file in addons\metamod\bin.
2. Comment the line with the plugin by adding a semi-colon:

   ;addons\sourcemod\bin\sourcemod_mm

3. Save, restart the server, or use meta console commands to unload the plugin.

Aliases

As of SourceMM 1.2.2, you can "alias" plugins to file names. This lets you specify an alias wherever you would specify a plugin file. In metaplugins.ini it would look like this:

sourcemod addons\sourcemod\bin\sourcemod_mm

Here, "sourcemod" is now defined as an alias for "addons\sourcemod\bin\sourcemod_mm" which is useful if you wish to unload a plugin and then load it again without needing to type a long file path.

If the plugin path contains a space and you wish to create an alias, you do not need quotes. However, a non-alias path will be misread as an alias. In this case, you must use quotes:

"addons\My Plugin\bin\My Plugin.dll"

Managing Plugins

For information on unloading, loading, and refreshing plugins, see meta console commands.