Documentation Menu

Plugins (Metamod + CounterStrikeSharp)

Server-side plugins via the modern frameworks.

CS2 doesn't run the old SourceMod ecosystem natively. The modern path is Metamod:Source + CounterStrikeSharp.

Install Metamod:Source

  1. Get the latest Metamod release for CS2 from metamodsource.net.
  2. Stop the server.
  3. Extract the contents to /cs2/game/csgo/addons/metamod/.
  4. Edit /cs2/game/csgo/gameinfo.gi to add the metamod entry (the release notes include the exact line + position).
  5. Start the server. Console should log Metamod loading.

Install CounterStrikeSharp (CSS)

CSS is the plugin framework that runs on top of Metamod.

  1. Get the latest CSS release from its GitHub.
  2. Stop the server.
  3. Extract to /cs2/game/csgo/addons/counterstrikesharp/.
  4. Start. Console logs CSS init.

Installing a plugin

Plugins for CSS are usually .dll files in /cs2/game/csgo/addons/counterstrikesharp/plugins/<PluginName>/.

  1. Get the plugin from its GitHub releases.
  2. Drop the folder into plugins/.
  3. Restart (or css_plugins reload <name> from RCON).

Common useful plugins

  • AdminSystem — admin command framework
  • DiscordRelay — Discord chat bridge
  • MatchZy — competitive matchmaking
  • RetakesPlugin — retake gameplay mode
  • DeathmatchPlugin — DM mode controls

Configuring

Each plugin reads from /cs2/game/csgo/addons/counterstrikesharp/configs/plugins/<name>/ or a similar path. Read the plugin's README — defaults vary.

When something breaks

CSS / Metamod can fail to load if Valve patches CS2 in a way that breaks plugin ABI. Symptom: server boots vanilla, plugins don't run. Wait for plugin / framework updates (usually within a few days) and re-install.