How to Install AMX Mod X 1.9 Step by Step

AMX Mod X 1.9 is the version to install if you are not sure which version to install. It is stable, it has client_print_color and the modern string natives, essentially every plugin published in the last decade compiles against it, and — unlike 1.10 — you will not run into the occasional plugin that assumes an older core. This guide gets it running on a Metamod server and verified in about ten minutes.

1. Prerequisites

Metamod must be loaded. In the server console:

meta version

If that says Unknown command: meta, install Metamod-r first. AMX Mod X is a Metamod plugin; it cannot load without it.

2. Download Base + Counter-Strike

AMX Mod X is distributed as a Base package plus a per-game addon. For CS 1.6 you need both:

• AMX Mod X 1.9 Base (your platform)
• AMX Mod X 1.9 Counter-Strike addon (same version, same platform)

Same version on both. A 1.9 base with a 1.10 CS addon gives you module load failures whose error messages point nowhere useful.

3. Extract over the mod directory

cd /home/steam/hlds/cstrike
tar -xzf amxmodx-1.9.0-base-linux.tar.gz
tar -xzf amxmodx-1.9.0-cstrike-linux.tar.gz
ls addons/amxmodx

You should now have:

addons/amxmodx/
├── configs/    amxx.cfg  plugins.ini  users.ini  modules.ini  maps.ini
├── data/       lang/  (translations)
├── dlls/       amxmodx_mm_i386.so
├── logs/
├── modules/    cstrike_amxx_i386.so  fun_amxx_i386.so  fakemeta_amxx_i386.so …
├── plugins/    admin.amxx  admincmd.amxx  menufront.amxx …
└── scripting/  amxxpc  compile.sh  include/  *.sma

4. Tell Metamod to load it

Add to cstrike/addons/metamod/plugins.ini:

linux addons/amxmodx/dlls/amxmodx_mm_i386.so

or, on Windows:

win32 addons\amxmodx\dlls\amxmodx_mm.dll

Paths are relative to cstrike/, not to the metamod folder. Full syntax: plugins.ini explained.

5. Permissions (Linux)

cd /home/steam/hlds/cstrike/addons/amxmodx
chown -R steam:steam .
chmod -R u+rwX,go+rX .
chmod +x scripting/amxxpc scripting/compile.sh

AMXX writes to logs/ and to data/vault.ini. If those are not writable, plugins that save data fail silently and your error_*.log never gets written — which then makes every other problem invisible.

6. Set up an admin

addons/amxmodx/configs/users.ini:

; "<auth>" "<password>" "<access flags>" "<account flags>"
"STEAM_0:1:123456" "" "abcdefghijklmnopqrstu" "ce"

Account flags: c means the auth field is a SteamID, d an IP, e skip password check, a no password needed. ce is the standard Steam-server admin entry. Get your SteamID from the console with status while you are connected.

After editing, either restart or run amx_reloadadmins.

7. Enable the modules you need

addons/amxmodx/configs/modules.ini controls which modules load. The default is:

; auto = load automatically when a plugin requires it
fun
engine
fakemeta
geoip
sockets
regex
nvault
cstrike
csx
hamsandwich
;mysql
;sqlite

Uncomment what you need, leave the rest. Loading a module you do not use costs memory and startup time and nothing else. See the modules.ini guide, and for database work the MySQL module.

8. Restart and verify

meta list
amxx version
amxx plugins
amxx modules

Expected:

Currently loaded plugins:
       name                 version  author         file            status
 [  1] Admin Base           1.9.0    AMXX Dev Team  admin.amxx      running
 [  2] Admin Commands       1.9.0    AMXX Dev Team  admincmd.amxx   running
 [  3] Menus Front-End      1.9.0    AMXX Dev Team  menufront.amxx  running
 …
25 plugins, 25 running

Then in-game, connect and type amxmodmenu in your console. The admin menu opening is proof that the plugin loaded, the config parsed, and your admin entry matched.

9. Adding your own plugins

Drop the .amxx in addons/amxmodx/plugins/, add its filename on its own line in addons/amxmodx/configs/plugins.ini, and change the map (or restart). AMXX does not auto-load files that are not listed. Details: how to install an AMXX plugin correctly.

Common errors

• Unknown command: amxx — AMXX is not loaded. Check meta list; if it is not there, your plugins.ini line or path is wrong.
• bad load next to AMX Mod X in meta list — wrong architecture or an AMXX built for a different Metamod API. file addons/amxmodx/dlls/amxmodx_mm_i386.so must report ELF 32-bit, Intel 80386. See bad load.
• Plugin failed to load: Invalid Plugin — an .amxx compiled for a newer AMXX than the one running. Recompile it from source with your 1.9 amxxpc.
• Module failed to load — mismatched module version, or a module in modules/ from a different AMXX release. See that fix.
• Admin menu opens but every option is greyed out — your access flags string in users.ini is too narrow. Give yourself the full flag set while testing.

Verification checklist

1. meta list — AMX Mod X RUN.
2. amxx version — reports 1.9.x.
3. amxx plugins — every plugin running; zero bad load, zero error.
4. amxmodmenu opens in-game for your admin.
5. addons/amxmodx/logs/error_*.log stays empty across a full map.

If all five hold, AMX Mod X 1.9 is correctly installed. Next: ReAPI if you are on ReHLDS + ReGameDLL, and an essential plugin pack for a public server.