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).
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
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:
- Download the plugin (
.amxx
file). - Place it in
addons/amxmodx/plugins
. - Edit
addons/amxmodx/configs/plugins.ini
and add the filename (e.g.example.amxx
). - Restart the server.
Step 3: Compile AMX Mod X Plugins
Some plugins come as .sma
source files and must be compiled into .amxx
files.
- Place the
.sma
file inaddons/amxmodx/scripting
. - Run
compile.exe
(Windows) oramxxpc
(Linux). - The compiled
.amxx
will be in thecompiled
subfolder. - Move it to
addons/amxmodx/plugins
and add it toplugins.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