Skip to content
Game Servers

Fix AMX Mod X "Couldn't load library" / Plugin Failed in CS 1.6

Couldn't load libraryPlugin failedbad load
7 min read Updated 12 June 2026 ESAGAMES Team

When an AMX Mod X plugin shows "bad load", "failed" or "Couldn't load library" in your CS 1.6 console, the server is telling you the plugin couldn't start. It's almost always one of a handful of causes — here's how to find which one and fix it.

First, read the real error

Type amxx plugins in the server console (or check addons/amxmodx/logs/). The status word next to each plugin — running, bad load, failed, debug — tells you exactly what's wrong.

Cause 1: a required module isn't loaded

Most "Couldn't load library" errors mean the plugin needs a module (like sqlite, mysql, cstrike, fakemeta or hamsandwich) that isn't enabled. Open addons/amxmodx/configs/modules.ini and make sure the required module line is present and not commented out with a semicolon.

; addons/amxmodx/configs/modules.ini
cstrike
fun
fakemeta
hamsandwich
sqlite

Cause 2: the .amxx wasn't compiled / wrong version

A plugin written for AMX Mod X 1.8 may not load on 1.9/1.10 (or vice-versa). Re-compile the .sma source against your AMXX version using the web compiler or amxxpc, then drop the fresh .amxx into addons/amxmodx/plugins/.

Cause 3: it's not listed in plugins.ini

A plugin file on disk does nothing unless it's registered. Add the filename to addons/amxmodx/configs/plugins.ini, one per line, with no path:

; addons/amxmodx/configs/plugins.ini
admin.amxx
adminslots.amxx
my_plugin.amxx

Cause 4: load order / dependency

Some plugins depend on another (a "core" plugin, or a natives provider). If plugin B uses natives from plugin A, A must appear above B in plugins.ini. Re-order them so dependencies load first.

The clean checklist

  1. Run amxx plugins and note the exact status word.
  2. Enable any required module in modules.ini.
  3. Re-compile the plugin against your AMXX version.
  4. Make sure it's listed in plugins.ini, no path.
  5. Put dependency plugins above the ones that use them.
  6. Restart the server and re-check amxx plugins.
90% of AMXX "couldn't load" errors are a missing module or a plugin compiled for the wrong version. Fix those two first.

Cause 5: a corrupted or incomplete .amxx file

If the .amxx file was uploaded in text/ASCII mode over FTP instead of binary, or the transfer was interrupted, the plugin binary is corrupted and AMX Mod X reports "Couldn't load library" even though the module and plugins.ini entry are correct. Re-upload the .amxx in binary mode, or re-download it fresh from the compiler, and compare its file size to the original.

Cause 6: a 32-bit vs 64-bit binary mismatch

AMX Mod X modules are native libraries and must match your HLDS/ReHLDS binary's architecture. Running a 64-bit ReHLDS build with 32-bit-only AMXX modules (or the reverse) throws "Couldn't load library" for every module-dependent plugin at once. If every plugin using a module fails together, this is the likely cause — match your AMXX package to your server binary.

How to prevent "Couldn't load library" from coming back

  • Always upload .amxx files in binary FTP mode, never ASCII/text.
  • Keep a backup copy of modules.ini and plugins.ini before any bulk plugin update.
  • Re-compile third-party plugins whenever you update AMX Mod X itself, not just when something breaks.
  • Test new plugins on a staging/second server before pushing them to your live CS 1.6 server.
  • Check addons/amxmodx/logs/ after every restart, not just when players report a problem.

Related errors and next steps

"Couldn't load library" is one of several CS 1.6 loading and connection errors. If plugins load fine but players get kicked over mismatched files, that's a different problem — see "server is enforcing consistency for this file". If your server refuses to bind to its port at all, check "port already in use / bind failed". For SteamCMD/HLDS install problems, see common SteamCMD errors.

Run CS 1.6 without the headaches

Our CS 1.6 hosting gives you a clean AMX Mod X install, a file manager and instant restarts on a protected Frankfurt network.

CS 1.6 hosting
FAQ

Frequently asked questions

What does "bad load" mean in AMX Mod X?

It means the plugin file was found but couldn't be loaded — usually a version mismatch (compiled for a different AMXX version) or a missing module it depends on. Re-compile it and enable the required module.

Where are AMXX logs stored?

In addons/amxmodx/logs/ on your server. The dated log file shows the exact reason a plugin failed to load, which is the fastest way to diagnose it.

How do I know which module a plugin needs?

Open the plugin's .sma source and look at the #include lines (e.g. #include needs the cstrike module, #include needs sqlite). Enable those in modules.ini.

What does it mean if ALL my plugins show "Couldn't load library" at once?

That points to a bigger problem than one plugin — either modules.ini itself is missing/corrupted, or your AMXX build doesn't match your HLDS/ReHLDS binary's architecture. Check modules.ini first, then confirm your AMXX package matches your server binary.

Can a bad FTP upload cause "Couldn't load library"?

Yes. Uploading a .amxx file in ASCII/text mode instead of binary corrupts the compiled plugin. Re-upload it in binary mode and check the file size matches the original.

Do I need to restart the whole server to reload a fixed plugin?

No — use amxx reload from the console for most changes. A full restart is only needed if you changed modules.ini, since modules only load at startup.

Where can I recompile a .sma file if I don't have a compiler installed?

Use the AMX Mod X web compiler (upload the .sma, download the compiled .amxx) or install amxxpc locally. Always compile against the same AMXX version your server runs.

Knowledge base

Related articles

Skip the troubleshooting

Managed, protected hosting in Frankfurt — we handle the Linux, the network and the DDoS so you don't have to.

Payments Secure checkout with cards, banking apps and digital wallets.

Choose the payment flow that fits your stack and region without leaving the platform.

Pay by Zen Visa Mastercard Paysafecard PaysafeCash Skrill Trustly Bancontact UnionPay iDeal WebMoney