Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
FREEDOM251

Freedom251 › Blog › Counter-Strike 2

How to Install Plugins on a CS2 Server With CounterStrikeSharp

By Freedom251 Team · · 10 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install the dependency chain in this order: Metamod:Source, CounterStrikeSharp, then the plugin. CounterStrikeSharp uses Metamod:Source to communicate with the Counter-Strike 2 server, so a plugin cannot load on a vanilla server without both frameworks. Put the frameworks under the server’s game/csgo directory, edit gameinfo.gi for Metamod, and place each compiled plugin DLL in CounterStrikeSharp’s plugins directory.

The first installation should use CounterStrikeSharp’s package that includes the .NET runtime. After every stage, restart the server and verify the loader before moving to the next one. This sequence isolates failures and prevents a missing dependency from looking like a broken plugin.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What you need before installing

Prepare the server and files before changing anything. You need:

  • A running Counter-Strike 2 dedicated server and access to its active game/csgo directory through a file manager, SFTP, or the machine’s local filesystem.
  • Metamod:Source 2.x Dev Build 1467 or newer with KHook support, matching the server’s operating system.
  • The current CounterStrikeSharp release marked with runtime for the first installation. This bundle contains the .NET runtime CounterStrikeSharp needs.
  • A plugin release that explicitly targets CounterStrikeSharp and is compatible with the current CS2 and Metamod versions.
  • Permission to stop and restart the server, edit gameinfo.gi, and copy files into game/csgo/addons.

On Linux, .NET may also require the distribution’s ICU package. Depending on the distribution, that package is named libicu, icu-libs, or libicu-dev. If ICU cannot be installed, CounterStrikeSharp documents the globalization-invariant setting DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true as an alternative, with the limitations that setting entails.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Understand the installation chain

CounterStrikeSharp is not a replacement for Metamod:Source. Metamod is the loader and communication layer that CounterStrikeSharp uses to interact with the game server. The practical dependency order is:

  1. Metamod:Source loads into CS2.
  2. CounterStrikeSharp loads through Metamod and starts its .NET-based API.
  3. CounterStrikeSharp plugins load through the CounterStrikeSharp plugin manager.

Installing a plugin first, or copying CounterStrikeSharp without its required runtime, leaves the server with no functioning path to load the DLL. A clean restart and a check at each layer is faster than troubleshooting all three at once.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Back up the server and stop it

  1. Stop the CS2 server cleanly. Do not copy framework files while the process is writing logs or loading modules.
  2. Make a full backup of the active game/csgo directory.
  3. Back up gameinfo.gi separately so you can restore the original search paths if Metamod prevents startup.
  4. Record the server operating system, the CS2 build, and the exact Metamod and CounterStrikeSharp release files you are installing. Compatibility is version-sensitive, especially after a major CS2 update.

Keep the backup until the server has started successfully and the plugin has been verified in-game. If the server will not start after a change, stop it, restore the affected file or directory, and test the last known-good state before trying another build.

Install Metamod:Source

1. Download the correct Metamod build

Obtain the current Metamod:Source CS2 development build for the server’s operating system. The CounterStrikeSharp getting-started requirements call for a 2.x Dev Build numbered 1467 or newer with KHook support. Do not use a package built for another platform or an older branch simply because its archive name looks similar.

2. Extract the files into game/csgo

Open the Metamod archive and copy its addons directory into the server’s active game/csgo/ directory. Merge with existing directories when your file manager asks. The result should include a Metamod directory below:

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

game/csgo/addons/metamod/

If you see the files nested one level too deep, such as game/csgo/addons/addons/metamod, move them up. A correct archive extraction is essential; Metamod cannot load when its files are hidden inside an extra directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Add Metamod to gameinfo.gi

Open the gameinfo.gi file in the same active game/csgo tree. In the Game_LowViolence csgo_lv entry, add this search-path line in the appropriate SearchPaths block:

Game csgo/addons/metamod

Preserve the file’s existing braces, indentation, and other search paths. Do not edit a similarly named file in a different installation directory; only the gameinfo.gi read by the running server matters. Save the file, then compare it with your backup to confirm that the only intentional change is the Metamod search path.

4. Restart and run meta list

Start the server and open its console. Run:

meta list

A Metamod entry in the output confirms that the loader was found. If the command is unknown or the list is empty, stop here and fix Metamod before installing CounterStrikeSharp. Continuing with the next layer only obscures the original fault.

Install CounterStrikeSharp with its runtime

1. Use the with-runtime package for the first install

Download the current CounterStrikeSharp release labeled with runtime. The package includes the .NET runtime required to launch CounterStrikeSharp, so it avoids a separate runtime installation and version mismatch during a first setup.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

2. Merge the CounterStrikeSharp files

Extract the archive’s addons directory into game/csgo/, merging directories when prompted. The central installation path should become:

game/csgo/addons/counterstrikesharp/

Do not rename this directory. If the archive creates game/csgo/addons/counterstrikesharp/counterstrikesharp, the extraction target was one level too high or too low; correct the layout before restarting.

3. Restart and confirm the API message

Restart the server after copying the files. A healthy startup prints:

CounterStrikeSharp.API Loaded Successfully.

This message proves that CounterStrikeSharp reached the .NET startup stage. It does not prove that an individual plugin is valid; plugin installation is the next, separate step.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linux ICU failure

If the message never appears and the console reports a .NET globalization or ICU error, install the ICU package supplied by your Linux distribution. Common package names are libicu, icu-libs, and libicu-dev. Restart after installing it. When the distribution cannot provide ICU, set DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true in the server process environment as documented for CounterStrikeSharp, then restart and check the console again.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Install a CounterStrikeSharp plugin

1. Check the plugin release notes first

Choose a release that explicitly targets CounterStrikeSharp, not a SourceMod or another framework plugin. Confirm the release’s supported CS2 and Metamod versions, required CounterStrikeSharp version, and any listed dependencies. A plugin can be present in the correct directory and still refuse to load when its API or game-data requirements are incompatible.

2. Copy the compiled DLL to the plugins directory

Place the plugin’s compiled DLL under:

game/csgo/addons/counterstrikesharp/plugins/

Do not put source code, the release ZIP, or an unrelated framework’s binary in this directory. CounterStrikeSharp scans for plugin assemblies, so the file must be the compiled DLL supplied by the plugin author.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Preserve the required matching subfolder

Create or preserve the subfolder required by CounterStrikeSharp’s official Hello World layout. Its name must exactly match the output DLL name expected by that plugin release. When the archive already contains the folder, copy that structure instead of flattening it. Do not rename the DLL or its matching folder to make them “cleaner.”

Keep configuration files, language files, game-data files, and dependency DLLs in the locations specified by the plugin’s release notes. Some plugins place those files beside the assembly; others provide a dedicated configuration or data directory. There is no universal safe location for files that the plugin author documents separately.

4. Restart and inspect the plugin list

Restart the server after a new plugin or dependency is installed. Use the CounterStrikeSharp plugin-list command supported by your installed build; hosting documentation commonly exposes:

css_plugins list

The list should show the plugin as loaded rather than failed or missing. A full restart is the clearest first-install test because it reloads Metamod, CounterStrikeSharp, dependencies, and the plugin in one sequence.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Verification checklist

Use these checks in order, from the lowest dependency to the plugin:

  1. Confirm the server starts from the backed-up, active game/csgo directory.
  2. Run meta list; verify that Metamod is present.
  3. Search the startup console for CounterStrikeSharp.API Loaded Successfully..
  4. Check that the plugin DLL is physically inside game/csgo/addons/counterstrikesharp/plugins/.
  5. Confirm the plugin’s required matching subfolder and any dependency files are present.
  6. Run css_plugins list, or the equivalent plugin-list command exposed by the installed CounterStrikeSharp build.
  7. Review the server console for the plugin’s own load message or an explicit dependency, API, or game-data error.

Why a CS2 plugin does not load

Symptom Likely cause Fix
meta list is unavailable or shows no Metamod entry The active gameinfo.gi was not edited, the search path is malformed, files are in the wrong game/csgo tree, or the build does not match the server platform. Stop the server, verify the Metamod addons layout, confirm the line Game csgo/addons/metamod is inside the Game_LowViolence csgo_lv search paths, and reinstall a compatible build.
Metamod loads but the CounterStrikeSharp success message is absent The package is incomplete, the runtime was omitted on a first install, the directory is misnested, or .NET cannot start because ICU is missing. Re-extract the complete with-runtime package into game/csgo, verify game/csgo/addons/counterstrikesharp, install the platform’s ICU package, and restart.
CounterStrikeSharp loads but the plugin is missing from the list The DLL is outside the exact plugins directory, the archive was not extracted, or the required matching subfolder was renamed. Copy the compiled DLL into game/csgo/addons/counterstrikesharp/plugins/, restore the release’s folder structure, and restart.
The plugin appears but reports an error or fails immediately A required dependency, game-data file, configuration, language file, or compatible API version is absent. Read that plugin’s release notes, install every named dependency in its documented location, and verify compatibility with the current CS2, Metamod, and CounterStrikeSharp builds.
The server stops starting after editing gameinfo.gi The search-path line was inserted outside the intended block, braces were changed, or the wrong file was edited. Restore the backup, confirm the server starts, then reapply only the documented line inside the active Game_LowViolence csgo_lv SearchPaths block.

Hot reload versus a full restart

The CounterStrikeSharp Hello World guide notes that replacing a DLL in the plugin directory can trigger automatic hot reload. Hot reload is convenient for iterative development, but it is not a substitute for a clean first-install test. A full restart is preferable whenever you add Metamod, change CounterStrikeSharp, install a dependency, alter game data, or update a plugin that hooks early in server startup.

When testing a replacement DLL, keep the old file backed up, copy the new assembly without changing its required name, and watch the console for unload and reload errors. If the plugin remains in a failed state, stop the server and perform a complete restart before drawing conclusions.

Upgrading CounterStrikeSharp safely

  1. Read the current release notes and check compatibility with the installed Metamod build and current CS2 update.
  2. Stop the server and back up game/csgo/addons/counterstrikesharp along with any plugin configuration and game-data directories.
  3. Download the latest CounterStrikeSharp release and copy it over the existing installation, merging directories as directed.
  4. Use a package containing the runtime again if the required .NET runtime major or minor version changed. For upgrades that keep the same required runtime, the bundled runtime is not needed every time.
  5. Restart and verify the API success message before checking plugins.
  6. Run the plugin-list command and test each plugin. Recheck plugin compatibility after major CS2 patches because game binaries and loaders can change.

Do not delete the entire installation before making a backup. Preserving the existing configuration, game data, and plugin folders makes rollback possible if the new build exposes an incompatibility.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choosing a server setup that will be easy to maintain

The framework files themselves do not require a particular hosting company, but the server environment determines how practical updates and recovery will be. Before renting or migrating a server, check these capabilities:

  • Operating-system support: the host must offer the OS for which your Metamod and CounterStrikeSharp builds are released.
  • File access: SFTP or a reliable file manager must expose the active game/csgo directory so you can edit gameinfo.gi and copy DLLs.
  • Backup and rollback: snapshots or downloadable backups reduce the risk of a broken loader update.
  • Restart controls: you need a reliable console or control-panel restart after every framework and plugin change.
  • Patch responsiveness: CS2 updates can make loaders and plugins version-sensitive, so a provider that communicates maintenance windows and updates promptly is easier to operate.
  • Documented compatibility: look for explicit CounterStrikeSharp support rather than assuming that generic CS2 hosting includes access to native addons.

No authoritative dated benchmark establishes that one hosting arrangement loads CounterStrikeSharp faster or more reliably than another. The practical decision is whether you can reach the correct files, make backups, restart on demand, and recover quickly after a CS2 or framework update.

Common mistakes to avoid

  • Installing CounterStrikeSharp without Metamod:Source.
  • Editing a copy of gameinfo.gi that the running server does not use.
  • Using a CounterStrikeSharp package without the runtime on a first installation.
  • Extracting an archive into an extra nested addons or counterstrikesharp directory.
  • Placing a plugin DLL in game/csgo/addons instead of the CounterStrikeSharp plugins directory.
  • Renaming the plugin DLL or its required matching folder.
  • Ignoring plugin-specific game-data, configuration, language, or dependency instructions.
  • Testing several changes at once, which makes the first failure difficult to identify.
  • Skipping a backup before changing gameinfo.gi or replacing framework files.

Minimal installation sequence

For a quick reference, the complete procedure is:

  1. Stop CS2 and back up game/csgo and gameinfo.gi.
  2. Extract Metamod’s addons into game/csgo.
  3. Add Game csgo/addons/metamod under the Game_LowViolence csgo_lv search paths in the active gameinfo.gi.
  4. Start the server and confirm meta list shows Metamod.
  5. Extract CounterStrikeSharp with runtime into game/csgo.
  6. Restart and confirm CounterStrikeSharp.API Loaded Successfully..
  7. Copy the compatible plugin DLL into game/csgo/addons/counterstrikesharp/plugins/ with its required matching folder and support files.
  8. Restart and run css_plugins list, or the plugin-list command supported by the installed build.

The Bottom Line

A working CounterStrikeSharp installation is a three-layer chain: Metamod:Source must load first, CounterStrikeSharp must report its API loaded successfully, and only then should the plugin DLL be checked. Validate those layers in order, keep the DLL and matching folder in the exact plugins layout, and back up the server before every framework or game-data change.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Counter-Strike 2CounterStrikeSharpCS2 servergame server pluginsMetaMod:Sourceserver administration

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.