How to Install CS2 Mods and Plugins

The distinction that matters

Read that first row again, because it is the entire logic. A server plugin changes the rules of a server. A client mod changes your copy of the game. Anti-cheat cares about the second and is indifferent to the first.

Route 1: Workshop content (the client-side answer)

If what you want is custom maps, this is not a compromise — it is the actual, fully supported feature, and it requires no files, no folders and no third-party tools.

1. Find a map on the Counter-Strike 2 Steam Workshop and click Subscribe.
2. Steam downloads it in the background and keeps it updated when the creator ships a new version.
3. In CS2, go to Play → Workshop Maps, pick it, and press Go. It loads in a private offline session.

The full walkthrough is in how to play workshop maps in CS2, and our workshop maps directory lists the aim, prefire, movement and practice maps actually worth subscribing to. Between workshop maps and a proper practice config in a private match, most of what people historically wanted mods for is already covered.

If you want to make content rather than consume it, Valve ships the Counter-Strike 2 Workshop Tools, including the Source 2 Hammer editor — they appear in official CS2 patch notes regularly, and weapon finishes and stickers are submitted to Valve through the same tool. That is the sanctioned creation pipeline, and it is a very different activity from modifying a live client.

Route 2: Server plugins (the legitimate "mod" scene)

Everything you think of as a Counter-Strike mod — retakes, surf, KZ, bhop, jailbreak, deathrun, gun game variants, custom economies, ranking systems — is a server plugin. It runs on the server. Players connect with a stock, unmodified client and install nothing.

The CS2 stack has two pieces, and the important detail is that the CS:GO-era stack does not carry over:

• Metamod:Source— the plugin platform. Source 2 removed the server plugin interface Source 1 games exposed, so the CS2-capable builds live on the Metamod 2.x development branch, which adds a Source 2 backend covering CS2. It is loaded by pointing the game's search paths at it rather than through a plugin API.
• CounterStrikeSharp — the framework almost everyone actually writes plugins against. It is a C# / .NET 8 server-side modding framework that runs as a Metamod:Source plugin, and it is the de facto successor to SourceMod for CS2.

SourceMod does not support CS2. It targets Source 1 and has no CS2 build, so any guide telling you to drop SourceMod onto a CS2 server is CS:GO-era material that was never updated. That is the single most common wrong answer to this question.

How the install fits together

You do this on a CS2 dedicated server you control — installed through SteamCMD on your own machine or a rented host. Not on your game client, and not on someone else's server. In outline, per both projects' own documentation:

1. Install a CS2 dedicated server and confirm it starts clean before adding anything.
2. Extract Metamod:Source so its addons directory lands in the server's game/csgo/ folder, giving you game/csgo/addons/metamod/.
3. Edit game/csgo/gameinfo.gi and add a Game csgo/addons/metamod entry to the SearchPaths block. Metamod's docs are emphatic that it must be the first entry in that ordered list, or it will not load.
4. Restart the server and run meta version in the server console to confirm Metamod reports itself.
5. Extract CounterStrikeSharp the same way, so its addons directory merges into game/csgo/ alongside Metamod. Take the build bundled with the runtime if this is your first install.
6. Restart again, then drop individual plugins into CounterStrikeSharp's plugins folder.

One maintenance trap worth knowing before you commit: CS2 updates can overwrite gameinfo.gi, which silently un-installs Metamod. If your plugins vanish after a patch, that edit is the first thing to check. Server folder layout mirrors the client's, which is described in where the CS2 exe lives.

The route we will not write up

There is a third category people mean when they search for CS2 mods: software that runs alongside or inside your client to change what you see — skin changers, model and texture replacers, injected overlays. We are not giving install steps for any of it, and the reasoning is not squeamishness.

• VAC inspects exactly this. Valve Anti-Cheat checks the game files of users connected to Valve servers and matches known cheat signatures. It is automated pattern matching — it does not evaluate whether your injector was "only cosmetic". The mechanics are covered in what a VAC ban is.
• The penalty is absolute. Valve states VAC bans are permanent, non-negotiable and cannot be removed by Steam Support, and they are applied across accounts sharing a phone number at the time. There is no appeal and no second attempt.
• The payoff is nothing. Cosmetic client changes are visible only on your own screen. Nobody else in the server sees them, they have no market value, and they do not transfer to your account. You are risking a permanent ban for a private illusion.
• The distribution is hostile. This category is downloaded from anonymous forums and Discord servers, which is the standard delivery route for account-stealers and inventory-drainers. The tool being detected by VAC is often not even the worst outcome.

If you want to look at skins properly, do it the way that costs nothing: inspect them in a private match, or browse the real ones in our skin database.

What people usually actually want

Most "how do I mod CS2" questions turn out to have a supported answer once you unpack them:

• "I want different game modes." Join a community server running plugins, or stand up your own with the stack above.
• "I want custom maps." Steam Workshop. Subscribe and play.
• "I want better practice tools." A private match plus a practice config gives you infinite ammo, grenade trajectories and instant respawn without touching a file.
• "I want the game to look or feel different." That is settings and config, not mods — start with best CS2 settings.
• "I want skins I don't own." There is no legitimate version of this. Every tool that claims to do it is asking you to gamble a permanent ban on a private cosmetic.