Counter-Strike 2December 2, 2024

Installing CounterStrikeSharp & Metamod for CS2 Plugins

SourceMod is dead for CS2. Learn how to install Metamod:Source and CounterStrikeSharp to run C# plugins on your CS2 server.

If you are coming from CS:GO, you might be looking for SourceMod. SourceMod does not work on CS2. The modern standard for CS2 modding is a C# framework called CounterStrikeSharp (CS#) running on top of Metamod:Source.

1. Installing Metamod:Source

Metamod intercepts the engine calls and allows plugins to run. Download the latest CS2-compatible build of Metamod:Source and extract the addons folder into your game/csgo/ directory.

The VDF / Gameinfo Fix (Critical Step)

Unlike CS:GO, CS2 requires you to explicitly tell the engine to load Metamod. Open the file game/csgo/gameinfo.gi. Scroll down to the SearchPaths block and add this line exactly above Game csgo:

Game    csgo/addons/metamod

Warning: Every time Valve pushes a major CS2 update, this file gets overwritten! You will need to re-add this line if your plugins stop working after a Tuesday update.

2. Installing CounterStrikeSharp

Download the latest release of CounterStrikeSharp. Extract the contents so that they merge with your existing addons folder (it should create addons/counterstrikesharp).

3. Adding Plugins

CS# plugins are typically distributed as .dll files inside folders. To install a plugin, drop its folder into addons/counterstrikesharp/plugins/. Restart the server and type css_plugins list in the console to verify it loaded.