Skip to content

CS2: Installing Plugins

Discover the evolving world of CS2 plugins and community projects to enhance your Counter-Strike experience → Learn more now

12 November 20262 min read16 Views0 helpful

Introduction

Counter-Strike 2 continues the long tradition of community-driven server customization. Plugins allow server owners to expand gameplay, add quality-of-life features, implement custom rule sets, or create entirely new game modes.

With the switch to Source 2, the plugin ecosystem has changed significantly. For CS2, CounterStrikeSharp has established itself as the primary and actively maintained framework for server-side plugin development.

Installing Metamod:Source

Metamod must be installed first because CounterStrikeSharp depends on it. After downloading the Metamod:Source 2.x Dev Build, extract the archive. Inside, you will find an addons directory. This directory must be uploaded directly via FTP into the CS2 game server directory.

Code
../game/csgo/

After copying the files, locate the gameinfo.gi file in the /game/csgo/ directory. Open this file with a text editor. Find the line containing Game_LowViolence csgo_lv. Directly below it, add the following entry:

Code
Game csgo/addons/metamod

Installing CounterStrikeSharp

Once Metamod is running, you can install CounterStrikeSharp. CounterStrikeSharp is distributed via the official GitHub repository and provided as a prebuilt release package. Download the CounterStrikeSharp release that includes the runtime. Extract the archive and upload the included addons directory via FTP into the same CS2 game server directory.

Code
/game/csgo/

Please do not merge or rename directories manually. The structure provided by the archive must be preserved. After uploading the files, restart the server. On startup, Metamod will automatically load CounterStrikeSharp. To verify the installation, open the server console and run:

Code
meta list
Listing 1 plugin:
  [01] CounterStrikeSharp (0.1.0) by Roflmuffin

Installing Plugins

Plugins for CounterStrikeSharp are provided as compiled .dll files. These files go into the plugins directory inside the CounterStrikeSharp installation path.

After copying a plugin into this directory and restarting the server, CounterStrikeSharp will automatically load all available plugins. If a plugin does not load, check the server logs for error messages related to CounterStrikeSharp or the plugin.

  • MatchZy – Match plugin for 5v5 scrims/pugs with knife round, pause/tech pause, backup rounds, and demo recording.
  • CS2-SimpleAdmin – Admin and ban management system with simple chat/console commands and database integration.
  • CS2-WeaponPaints – Allows players to choose custom weapon skins, gloves, and agent models.
  • cs2-retakes – Retake game mode (defend/attack bomb site after round start) for CS2.
  • AFKManager – Automatically detects and removes inactive (AFK) players from the server.
  • CS2Fixes – Metamod plugin with various engine fixes, commonly used as a base for zombie escape servers.
  • CS2-Deathmatch – Deathmatch game mode plugin with respawns and weapon selection instead of classic bomb defusal.

Conclusion

If you have followed all the steps, you should have successfully installed Metamod/CounterStrikeSharp and your desired plugins. If you have any further questions or issues, our support team is available daily – don’t hesitate to contact us! 🙂

FAQ

Frequently asked questions

CounterStrikeSharp is the primary and actively maintained framework for server-side plugin development in Counter-Strike 2.
Metamod:Source (2.x Dev Build) must be installed first, as CounterStrikeSharp depends on it. Upload the addons directory via FTP to ../game/csgo/ and add the line Game csgo/addons/metamod to the gameinfo.gi file.
Use the console command meta list. If installed correctly, CounterStrikeSharp will be listed as a loaded plugin.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.