Documentation

English

Deutsch

English

Deutsch

Appearance

How to Add Mods to Your Counter-Strike Global Offensive Server ​

Plugins on a Counter-Strike Global Offensive server run through Metamod:Source and SourceMod. You need both: Metamod:Source hooks into the Source Engine, and SourceMod builds on top of it to provide the plugin environment and the admin features.

Important

Your server runs on Linux. Always download the Linux package (.tar.gz) of Metamod:Source and SourceMod — the .zip package is the Windows build and will not work.

Important

Use the 1.12 branch for both. Metamod:Source version 2.0 is built for Source 2 and therefore only for Counter-Strike 2 — it does not work on a Counter-Strike Global Offensive server.

Note

Your players do not have to install anything. Plugins are executed server-side only, no downloads are required on the player's side.

Install Metamod:Source ​

  1. Download Metamod:Source
    Download the current stable version of Metamod:Source (1.12 branch) as a Linux package (.tar.gz).

  2. Stop the server
    Stop your server via the dashboard.

  3. Connect via SFTP
    Connect to your server via SFTP.

  4. Upload the files
    Extract the archive and upload the addons folder it contains to the following directory:

    /csgo/

    Afterwards the folder /csgo/addons/metamod/ exists.

  5. Start the server
    Start your server and check in the server console with meta version whether Metamod:Source was loaded.

Note

You do not have to create your own metamod.vdf — since Metamod:Source 1.10.0 the matching file is already part of the package. An entry in a gameinfo.gi is not needed either, that only applies to Counter-Strike 2.

Install SourceMod ​

  1. Download SourceMod
    Download the current stable version of SourceMod (1.12 branch) as a Linux package (.tar.gz).

  2. Stop the server
    Stop your server via the dashboard.

  3. Upload the files
    Extract the archive and upload the addons and cfg folders it contains via SFTP to the following directory:

    /csgo/

    Existing folders are merged, not replaced. Afterwards the folder /csgo/addons/sourcemod/ exists.

  4. Start the server
    Start your server and check in the server console with sm version whether SourceMod was loaded.

Install plugins ​

  1. Download the plugin
    Download the plugin you want. Ready-to-use plugins come as a .smx file.

  2. Stop the server
    Stop your server via the dashboard.

  3. Upload the plugin
    Upload the .smx file via SFTP to the following directory:

    /csgo/addons/sourcemod/plugins/

  4. Start the server
    Start your server and check with sm plugins list whether the plugin was loaded.

Warning

Not every SourceMod plugin supports Counter-Strike Global Offensive. Before uploading, check whether the plugin is explicitly offered for CS:GO.

Add custom maps ​

  1. Download the map
    Download the map you want. Maps come as a .bsp file, sometimes together with additional files such as sounds or models.

  2. Stop the server
    Stop your server via the dashboard.

  3. Upload the map
    Upload the .bsp file via SFTP to the following directory:

    /csgo/maps/

  4. Start the server
    Start your server. Use changelevel <map name> in the server console to switch to the new map.

Warning

Custom maps only exist on the server. Your players need the map as well, otherwise they cannot join. Set up FastDL so it is downloaded automatically.

Set up FastDL ​

With FastDL your players automatically download custom maps and additional files from a web space when connecting, instead of having to install them manually.

  1. Put the files on your web space
    Create a folder on your web space and mirror the folder structure of the server inside it, for example maps/, sound/ and models/. Copy the required files into the matching folders.

  2. Compress the files
    Compress the files on the web space in the .bz2 format. de_example.bsp becomes de_example.bsp.bz2.

  3. Add the download address
    Open the following file via SFTP and add the address of your FastDL folder:

    /csgo/cfg/server.cfg
    sv_downloadurl "https://your-domain.com/fastdl/"

  4. Start the server
    Save the file and restart your server.

Note

The files have to exist on the server and on the web space. The server loads the map itself from /csgo/maps/, your players fetch it through the FastDL address.

Folder structure at a glance ​

/csgo/addons/metamod/
/csgo/addons/sourcemod/
/csgo/addons/sourcemod/plugins/     <- .smx plugin files
/csgo/addons/sourcemod/configs/     <- configurations, e.g. admin lists
/csgo/maps/                         <- maps
/csgo/cfg/                          <- server.cfg and other configurations

Verify the installation ​

Enter the following commands in the server console:

CommandDescription
meta versionShow the Metamod:Source version
meta listShow the extensions loaded by Metamod
sm versionShow the SourceMod version
sm plugins listShow the loaded SourceMod plugins

Warning

If the server answers one of these commands with Unknown command, that component was not loaded. In that case check whether you used the Linux package of the 1.12 branch and whether the folders really are located under /csgo/addons/.

Warning

Always stop your server before uploading files.

Tip

To learn how to give yourself admin rights with SourceMod afterwards, see Add Admin.

© 2016 - 2026 EmeraldHost