CS2 CS2

How to Install CS2 Plugins (CounterStrikeSharp)

Install CounterStrikeSharp plugins on your CS2 server: where the files go, how to configure them, css_plugins commands and fixes when a plugin won't load.

6 min read Last checked 1h ago 3 views
Series · part 3 of 4Your first CS2 server
  1. 1How to Make a CS2 Dedicated Server (Windows & Linux)
  2. 2How to Install Metamod:Source and CounterStrikeSharp on CS2
  3. 3How to Install CS2 Plugins (CounterStrikeSharp)
  4. 4How to Add Admins on a CS2 Server (CounterStrikeSharp)
In this guide 12 sections
  1. 1Quick steps
  2. 2What you need
  3. 3Where to find CS2 plugins
  4. 4Install a plugin
  5. 5Configure a plugin
  6. 6Manage plugins from the console
  7. 7Update a plugin
  8. 8Make yourself admin
  9. 9Write or build your own plugin
  10. 10Troubleshooting
  11. 11FAQ
  12. 12Next steps

CS2 plugins for CounterStrikeSharp are folders with a .dll inside. Installing one means copying its folder into the server's plugins folder; CounterStrikeSharp loads it by itself, even while the server is running. This guide shows where to put each file, how to configure a plugin, the console commands to manage plugins, and what to do when one doesn't load.

Quick steps#

  1. Download the plugin for CounterStrikeSharp (CS#).
  2. Copy its folder into game/csgo/addons/counterstrikesharp/plugins/.
  3. If the archive has other folders (configs, gamedata, shared), copy them into addons/counterstrikesharp/ too.
  4. Type css_plugins list in the server console: the plugin must be there.
  5. Change its settings in addons/counterstrikesharp/configs/plugins/PluginName/PluginName.json.

The full instructions for each step are below.

What you need#

Metamod:Source and CounterStrikeSharp installed and running (meta list shows CounterStrikeSharp). If not, do that first:

How to Install Metamod:Source and CounterStrikeSharp on CS2Install Metamod:Source and CounterStrikeSharp on your CS2 server: edit gameinfo.gi, check with meta list, and fix plugins after CS2 updates.Read the guide

Where to find CS2 plugins#

  • The XCSTRIKE plugin library has CS2 plugins with their files ready to copy, checked before they're published, and with the CS2 games they work on:
Plugin libraryAMX Mod X, SourceMod and CS2 plugins, compiled for your version.Open
  • GitHub: most CS# plugins are open source. Download from the Releases page of the plugin, not the green Code button: Releases have the built .dll, the code button only has the source.
Check before you install

Plugins run with full access to your server. Install them only from sources you trust. And never install plugins that give players skins, knives, gloves or ranks they don't own (!ws, !knife, !gloves): Valve bans the server's GSLT for that, permanently.

Install a plugin#

  1. 1Look inside the archive

    Open the plugin's .zip. You'll usually find one of these layouts:

    • A single folder named after the plugin, with the .dll inside, for example MyPlugin/MyPlugin.dll.
    • An addons/counterstrikesharp/ structure, with the plugin folder under plugins/ and maybe configs/, gamedata/ or shared/ next to it.
  2. 2Copy it to the server

    For a single folder, copy it here:

    game/csgo/addons/counterstrikesharp/plugins/MyPlugin/MyPlugin.dll

    For a full addons structure, copy the addons folder into game/csgo and let it merge.

    The folder name must be exactly the same as the .dll name (MyPlugin/MyPlugin.dll). Keep every other file that came with it (.deps.json, other .dlls) in the same folder.

  3. 3Check it loaded

    CounterStrikeSharp loads new plugins by itself. Type in the server console:

    bash
    css_plugins list

    The plugin should be in the list with its version. If it isn't, load it by hand:

    bash
    css_plugins load MyPlugin

    Or restart the server.

Read the plugin's page first

Some plugins need another plugin or a shared library to be installed first (often listed as Requirements or Dependencies), or a database. Install those first, or the plugin will fail to load.

Configure a plugin#

Most plugins create their settings file the first time they load, here:

game/csgo/addons/counterstrikesharp/configs/plugins/MyPlugin/MyPlugin.json
  1. 1Let it create the file

    Install the plugin and let it load once. Then the .json file appears.

  2. 2Edit it

    Open it in a text editor and change the values. It's JSON, so keep the quotes, commas and brackets exactly as they are. A missing comma breaks the whole file.

    configs/plugins/MyPlugin/MyPlugin.jsonjson
    {
      "Enabled": true,
      "Prefix": "[MyServer]",
      "MinPlayers": 2,
      "ConfigVersion": 1
    }
  3. 3Apply the changes

    Reload the plugin:

    bash
    css_plugins reload MyPlugin

    Some plugins also have their own reload command, listed on their page.

Check the JSON before you save

If a plugin stops loading after you edited its config, the JSON is probably broken. Paste it into any online JSON validator: it shows the line with the missing comma or quote.

Manage plugins from the console#

CommandWhat it does
css_plugins listLists plugins with their number, state and version. Failed plugins show why
css_plugins load MyPluginLoads a plugin that isn't running
css_plugins unload MyPluginStops a plugin (also works with its number: #3)
css_plugins reload MyPluginStops and loads it again, for example after a config change
meta listShows Metamod's plugins, to check CounterStrikeSharp itself is loaded

Run them in the server console, or send them with an RCON tool.

Turn a plugin off without deleting it#

Move its folder into plugins/disabled/. CounterStrikeSharp doesn't load anything from there. Move it back to turn it on.

game/csgo/addons/counterstrikesharp/plugins/disabled/MyPlugin/

Update a plugin#

Download the new version and replace the files in its folder. With hot reload on (the default), CounterStrikeSharp reloads it as soon as the new .dll is in place. Your .json config stays, but compare it with the plugin's notes: new versions sometimes add settings.

Make yourself admin#

Admin commands from plugins check your permissions in:

game/csgo/addons/counterstrikesharp/configs/admins.json

A minimal entry, with your SteamID and full rights:

configs/admins.jsonjson
{
  "YourName": {
    "identity": "76561198000000000",
    "flags": ["@css/root"]
  }
}

identity takes your SteamID64 (or the STEAM_0:1:… form). Find it from your profile link:

SteamID FinderEvery SteamID format from a profile link.Open

@css/root gives every permission. Restart the server after editing the file.

Write or build your own plugin#

CS# plugins are written in C#. If you have a plugin's source code but no .dll, you can build it online without installing anything:

CS2 compilerBuild CounterStrikeSharp plugins online.Open

Troubleshooting#

The plugin isn't in css_plugins list#

  • The folder and the .dll don't have the same name, or the .dll is one folder too deep (plugins/MyPlugin/MyPlugin/MyPlugin.dll). Move it up.
  • You downloaded the source code instead of a release. Look for a .dll; if there's none, get the file from the Releases page.
  • The plugin is in plugins/disabled/.

css_plugins list shows the plugin as failed#

The line shows why. The usual reasons:

  • A missing dependency: another plugin or shared library it needs isn't installed. Check the plugin's requirements.
  • A broken config: fix the .json (see the tip above), or delete it so the plugin creates a new one.
  • Made for another CounterStrikeSharp version: update CounterStrikeSharp, or the plugin.

All plugins stopped working after a CS2 update#

That's not the plugins: Metamod or CounterStrikeSharp need an update. See After CS2 updates.

A command says I have no access#

You're not in admins.json, or your entry doesn't have the right flag. Check your SteamID, add @css/root for full rights, and restart the server.

css_plugins is an unknown command#

CounterStrikeSharp itself isn't loaded. Type meta list; if it's not there, go back to installing CounterStrikeSharp.

FAQ#

Where do CS2 plugins go?#

In game/csgo/addons/counterstrikesharp/plugins/, each in its own folder with the same name as its .dll.

Do I have to restart the server after installing a plugin?#

Usually not. CounterStrikeSharp loads new plugins and reloads updated ones by itself. Restart if the plugin needs it (for example after you edit admins.json or install a dependency).

Can I use SourceMod or AMX Mod X plugins on CS2?#

No. CS2 plugins must be made for CounterStrikeSharp (C#). Many popular SourceMod plugins have CS# versions; search the plugin library.

Which plugins should I avoid?#

Skin, knife and glove changers, fake ranks and anything that changes what players own. Valve bans the server's GSLT for those.

Next steps#

  • Find CS2 plugins in the plugin library
  • Put your server on XCSTRIKE so players can find it:
Add your serverList your server on XCSTRIKE and get players.Open
Was this guide helpful?
Thanks for the feedback!
Stuck on a step?Ask other server admins on the forum. Say which guide and which step.
Ask on the forum

More CS2 guides

CS2 Practice Server: Config and Commands (2026)