How To Install AMX Mod X for Half-Life

This guide will show you how to install AMX Mod X on a GoldSrc Half-Life Dedicated Server (HLDS). AMX Mod X is a Metamod plugin that extends server functionality with scripting and plugins. It works with Half-Life and mods such as Counter-Strike, Team Fortress Classic, Day of Defeat, Natural Selection, and Opposing Force.

Step 1: Install AMX Mod X

For this tutorial we’ll use AMX Mod X v1.8.2 (stable). You can also try newer builds if needed:

  • v1.8.2 – Current stable build.
  • v1.9 – Experimental, may be unstable.
  • v1.10 – Latest development build (recommended for advanced plugin use).
Tip: Most plugins work fine with v1.8.2, but some newer ones may require v1.10.

1. Download AMX Mod X Base files (and the Mod Addon Pack if you’re installing on a mod like cstrike, tfc, or dod).
2. Extract the contents into your mod folder (e.g. valve, cstrike, tfc, etc).
3. This creates the addons/amxmodx directory.

Next, edit the plugins.ini file in your addons/metamod folder. If it doesn’t exist, create it. Add one of the following lines:

Windows:

win32 addons/amxmodx/dlls/amxmodx_mm.dll

Linux:

linux addons/amxmodx/dlls/amxmodx_mm_i386.so
Important: Linux file systems are case-sensitive. Keep all folder and file names lowercase.

Save and restart your server. Open the in-game console and type:

meta list

If installed correctly, AMX Mod X will appear in the list:

Step 2: Install AMX Mod X Plugins

Plugins add extra features to your server. To install one:

  1. Download the plugin (.amxx file).
  2. Place it in addons/amxmodx/plugins.
  3. Edit addons/amxmodx/configs/plugins.ini and add the filename (e.g. example.amxx).
  4. Restart the server.

Step 3: Compile AMX Mod X Plugins

Some plugins come as .sma source files and must be compiled into .amxx files.

  1. Place the .sma file in addons/amxmodx/scripting.
  2. Run compile.exe (Windows) or amxxpc (Linux).
  3. The compiled .amxx will be in the compiled subfolder.
  4. Move it to addons/amxmodx/plugins and add it to plugins.ini.

Conclusion

That’s it! You now know how to install AMX Mod X, add plugins, and compile your own. With AMX Mod X, you can transform your HLDS server with custom features, commands, and gameplay mods.

Summary

  • Works on both Windows and Linux HLDS
  • Requires Metamod to run
  • Base + Mod Pack setup (e.g. cstrike, tfc)
  • Plugins: .amxx, Sources: .sma
  • Check install with meta list