Installing AMX Mod X Manually

This guide will help you install AMX Mod X without the assistance of an automated tool.

Introduction

There are a few ways you can install AMX Mod X. If you have shell or direct access to your server, you can do all pf the operations directly on the server itself. If you only have FTP access, it's best to install AMX Mod X on a "dummy" folder on your hard drive, do all configuration there, and then upload the files to your server. Otherwise, you can upload the files as you're installing and then use FTP to change things along the way.

Throughout the documentation we'll refer to your "mod folder" - this is the folder your mod is stored in, like "cstrike" (for Counter-Strike), or "dod" (for Day of Defeat). If you're installing on a listen server, it will be in \Program Files\Steam\SteamApps\<your steam login>\<Valve game or Half-Life>\<mod folder>. If you're using a dedicated server, it will be HLServer\<mod folder>. On linux this is hlds_l/<mod folder>. If you are using remote/FTP access, you may be restricted to your mod folder or hlds_l already, and don't need to find it. For this documentation, <mod folder> will refer to the mod folder mentioned above. For Linux users, binaries will not end in ".dll", they will usually end in "_i386.so" or "_amd64.so" for AMD64 machines.

Directory Structure

You should familiarize yourself with AMX Mod X's directory structure. The addons folder resides in your mod folder.

--addons         - this is where Server addons go
 |--metamod      - this is where Metamod goes. Metamod is necessary to run AMX Mod X
 |--dlls         - this is where Metamod's binaries go
 |--amxmodx      - this is where AMX Mod X goes
   |--dlls       - amxmodx_mm.dll should go here
   |--modules    - Where modules are stored (_amxx.dll or _amxx_i386.so etc)
   |--plugins    - Where plugins are stored (.amx or .amxx)
   |--scripting  - Where example source code and the compiler/assembler are stored
     |--include  - Where include files for source code is stored
     |--compiled - Where the compiler batch file stores .amxx output
   |--doc        - This documentation is kept here
   |--data       - Binary data, for example saved stats, language caches, and GeoIP information
     |--lang     - Dictionary text files for AMX Mod X ML features (multi lingual)
   |--configs    - Configuration files
   |--logs       - AMX Mod X log files

Installing Metamod

Because AMX Mod X is a Metamod plugin, you must first install Metamod. If you already have it installed, you may skip this section and jump to #Installing AMX Mod X.

Directory Structure

1. In your mod folder, create a folder called "addons".
2. In <mod folder>\addons, create a folder called "metamod".
3. In <mod folder>\addons\metamod, create a folder called "dlls".

Upload Binaries

1. Go to the Metamod Website and download Metamod. You will want to get either the Windows DLL or the Linux SO (for either 32bit Linux or Linux on AMD64).
2. Extract the metamod file and upload or copy it to your server. It must be placed in <mod folder>\addons\metamod\dlls.

Configure

1. In your mod folder, find the "liblist.gam" file. Open the file with a text editor, such as notepad. If you're using FTP or a control panel, you will need to download the file first.
2. For Windows, find this line:

   gamedll "dlls\mp.dll"

   Replace it with this line:

   gamedll "addons\metamod\dlls\metamod.dll"

   For Linux, find this line:

   gamedll_linux "dlls/mp_i386.so"

   Replae it with this line:

   gamedll_linux "addons/metamod/dlls/metamod_i386.so"

   (Note: use metamod_amd64.so for Linux on AMD64!)

3. Save liblist.gam (and upload it over the old one if your server is remote).
4. Edit the file <mod folder>\addons\metamod\plugins.ini. If it does not exist, create it. This file is your list of Metamod plugins.
5. For Windows, add

   win32 addons\amxmodx\dlls\amxmodx_mm.dll

   For Linux (32bit) add:

   linux addons/amxmodx/dlls/amxmodx_mm_i386.so

   For Linux (AMD64) add:

   linux addons/amxmodx/dlls/amxmodx_mm_amd64.so

6. Save (and upload) plugins.ini.