Add install-amx-mod-x-1-9/en.md
Browse Source
Daemon666 committed
parent d8a2d9b2c8
commit d2a95aefec22b03e830bdcf43c30307849593566
1 changed file
with 112 additions and 0 deletions
install-amx-mod-x-1-9/en.md
A
| @@ -0,0 +1,112 @@ | ||
| 1 | +--- | |
| 2 | +title: "How to Install AMX Mod X 1.9 Step by Step" | |
| 3 | +excerpt: "Install AMX Mod X 1.9 — the safe default for CS 1.6 in 2026 — on top of Metamod: file layout, plugins.ini, admins, modules and verification." | |
| 4 | +category: "installation" | |
| 5 | +tags: "amxmodx, 1.9" | |
| 6 | +image: "" | |
| 7 | +read_time: "9 min read" | |
| 8 | +--- | |
| 9 | +<p>AMX Mod X 1.9 is the version to install if you are not sure which version to install. It is stable, it has <code>client_print_color</code> 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.</p> | |
| 10 | + | |
| 11 | +<h2>1. Prerequisites</h2> | |
| 12 | +<p>Metamod must be loaded. In the server console:</p> | |
| 13 | +<pre>meta version</pre> | |
| 14 | +<p>If that says <code>Unknown command: meta</code>, install <a href="/tutorials/install-metamod-r">Metamod-r</a> first. AMX Mod X is a Metamod plugin; it cannot load without it.</p> | |
| 15 | + | |
| 16 | +<h2>2. Download Base + Counter-Strike</h2> | |
| 17 | +<p>AMX Mod X is distributed as a <strong>Base</strong> package plus a per-game addon. For CS 1.6 you need both:</p> | |
| 18 | +<ul> | |
| 19 | +<li>AMX Mod X 1.9 <strong>Base</strong> (your platform)</li> | |
| 20 | +<li>AMX Mod X 1.9 <strong>Counter-Strike</strong> addon (same version, same platform)</li> | |
| 21 | +</ul> | |
| 22 | +<p>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.</p> | |
| 23 | + | |
| 24 | +<h2>3. Extract over the mod directory</h2> | |
| 25 | +<pre>cd /home/steam/hlds/cstrike | |
| 26 | +tar -xzf amxmodx-1.9.0-base-linux.tar.gz | |
| 27 | +tar -xzf amxmodx-1.9.0-cstrike-linux.tar.gz | |
| 28 | +ls addons/amxmodx</pre> | |
| 29 | +<p>You should now have:</p> | |
| 30 | +<pre>addons/amxmodx/ | |
| 31 | +├── configs/ amxx.cfg plugins.ini users.ini modules.ini maps.ini | |
| 32 | +├── data/ lang/ (translations) | |
| 33 | +├── dlls/ amxmodx_mm_i386.so | |
| 34 | +├── logs/ | |
| 35 | +├── modules/ cstrike_amxx_i386.so fun_amxx_i386.so fakemeta_amxx_i386.so … | |
| 36 | +├── plugins/ admin.amxx admincmd.amxx menufront.amxx … | |
| 37 | +└── scripting/ amxxpc compile.sh include/ *.sma</pre> | |
| 38 | + | |
| 39 | +<h2>4. Tell Metamod to load it</h2> | |
| 40 | +<p>Add to <code>cstrike/addons/metamod/plugins.ini</code>:</p> | |
| 41 | +<pre>linux addons/amxmodx/dlls/amxmodx_mm_i386.so</pre> | |
| 42 | +<p>or, on Windows:</p> | |
| 43 | +<pre>win32 addons\amxmodx\dlls\amxmodx_mm.dll</pre> | |
| 44 | +<p>Paths are relative to <code>cstrike/</code>, not to the metamod folder. Full syntax: <a href="/tutorials/metamod-plugins-ini-explained">plugins.ini explained</a>.</p> | |
| 45 | + | |
| 46 | +<h2>5. Permissions (Linux)</h2> | |
| 47 | +<pre>cd /home/steam/hlds/cstrike/addons/amxmodx | |
| 48 | +chown -R steam:steam . | |
| 49 | +chmod -R u+rwX,go+rX . | |
| 50 | +chmod +x scripting/amxxpc scripting/compile.sh</pre> | |
| 51 | +<p>AMXX writes to <code>logs/</code> and to <code>data/vault.ini</code>. If those are not writable, plugins that save data fail silently and your <code>error_*.log</code> never gets written — which then makes every other problem invisible.</p> | |
| 52 | + | |
| 53 | +<h2>6. Set up an admin</h2> | |
| 54 | +<p><code>addons/amxmodx/configs/users.ini</code>:</p> | |
| 55 | +<pre>; "<auth>" "<password>" "<access flags>" "<account flags>" | |
| 56 | +"STEAM_0:1:123456" "" "abcdefghijklmnopqrstu" "ce"</pre> | |
| 57 | +<p>Account flags: <code>c</code> means the auth field is a SteamID, <code>d</code> an IP, <code>e</code> skip password check, <code>a</code> no password needed. <code>ce</code> is the standard Steam-server admin entry. Get your SteamID from the console with <code>status</code> while you are connected.</p> | |
| 58 | +<p>After editing, either restart or run <code>amx_reloadadmins</code>.</p> | |
| 59 | + | |
| 60 | +<h2>7. Enable the modules you need</h2> | |
| 61 | +<p><code>addons/amxmodx/configs/modules.ini</code> controls which modules load. The default is:</p> | |
| 62 | +<pre>; auto = load automatically when a plugin requires it | |
| 63 | +fun | |
| 64 | +engine | |
| 65 | +fakemeta | |
| 66 | +geoip | |
| 67 | +sockets | |
| 68 | +regex | |
| 69 | +nvault | |
| 70 | +cstrike | |
| 71 | +csx | |
| 72 | +hamsandwich | |
| 73 | +;mysql | |
| 74 | +;sqlite</pre> | |
| 75 | +<p>Uncomment what you need, leave the rest. Loading a module you do not use costs memory and startup time and nothing else. See <a href="/tutorials/install-amxx-modules">the modules.ini guide</a>, and for database work <a href="/tutorials/install-mysql-module-amxx">the MySQL module</a>.</p> | |
| 76 | + | |
| 77 | +<h2>8. Restart and verify</h2> | |
| 78 | +<pre>meta list | |
| 79 | +amxx version | |
| 80 | +amxx plugins | |
| 81 | +amxx modules</pre> | |
| 82 | +<p>Expected:</p> | |
| 83 | +<pre>Currently loaded plugins: | |
| 84 | + name version author file status | |
| 85 | + [ 1] Admin Base 1.9.0 AMXX Dev Team admin.amxx running | |
| 86 | + [ 2] Admin Commands 1.9.0 AMXX Dev Team admincmd.amxx running | |
| 87 | + [ 3] Menus Front-End 1.9.0 AMXX Dev Team menufront.amxx running | |
| 88 | + … | |
| 89 | +25 plugins, 25 running</pre> | |
| 90 | +<p>Then in-game, connect and type <code>amxmodmenu</code> in your console. The admin menu opening is proof that the plugin loaded, the config parsed, and your admin entry matched.</p> | |
| 91 | + | |
| 92 | +<h2>9. Adding your own plugins</h2> | |
| 93 | +<p>Drop the <code>.amxx</code> in <code>addons/amxmodx/plugins/</code>, add its filename on its own line in <code>addons/amxmodx/configs/plugins.ini</code>, and change the map (or restart). AMXX does <strong>not</strong> auto-load files that are not listed. Details: <a href="/tutorials/install-amxx-plugin-files">how to install an AMXX plugin correctly</a>.</p> | |
| 94 | + | |
| 95 | +<h2>Common errors</h2> | |
| 96 | +<ul> | |
| 97 | +<li><strong><code>Unknown command: amxx</code></strong> — AMXX is not loaded. Check <code>meta list</code>; if it is not there, your <code>plugins.ini</code> line or path is wrong.</li> | |
| 98 | +<li><strong><code>bad load</code> next to AMX Mod X in <code>meta list</code></strong> — wrong architecture or an AMXX built for a different Metamod API. <code>file addons/amxmodx/dlls/amxmodx_mm_i386.so</code> must report <em>ELF 32-bit, Intel 80386</em>. See <a href="/tutorials/fix-metamod-bad-load">bad load</a>.</li> | |
| 99 | +<li><strong><code>Plugin failed to load: Invalid Plugin</code></strong> — an <code>.amxx</code> compiled for a newer AMXX than the one running. Recompile it from source with your 1.9 <code>amxxpc</code>.</li> | |
| 100 | +<li><strong><code>Module failed to load</code></strong> — mismatched module version, or a module in <code>modules/</code> from a different AMXX release. See <a href="/tutorials/fix-amxx-module-failed-to-load">that fix</a>.</li> | |
| 101 | +<li><strong>Admin menu opens but every option is greyed out</strong> — your access flags string in <code>users.ini</code> is too narrow. Give yourself the full flag set while testing.</li> | |
| 102 | +</ul> | |
| 103 | + | |
| 104 | +<h2>Verification checklist</h2> | |
| 105 | +<ol> | |
| 106 | +<li><code>meta list</code> — AMX Mod X <code>RUN</code>.</li> | |
| 107 | +<li><code>amxx version</code> — reports 1.9.x.</li> | |
| 108 | +<li><code>amxx plugins</code> — every plugin <code>running</code>; zero <code>bad load</code>, zero <code>error</code>.</li> | |
| 109 | +<li><code>amxmodmenu</code> opens in-game for your admin.</li> | |
| 110 | +<li><code>addons/amxmodx/logs/error_*.log</code> stays empty across a full map.</li> | |
| 111 | +</ol> | |
| 112 | +<p>If all five hold, AMX Mod X 1.9 is correctly installed. Next: <a href="/tutorials/install-reapi">ReAPI</a> if you are on ReHLDS + ReGameDLL, and <a href="/tutorials/install-cs16-public-plugin-pack">an essential plugin pack</a> for a public server.</p> | |
| 0 | 113 |
