Upgrading Amx Mod X
This document contains information on upgrading AMX Mod X versions. Almost all versions follow the same pattern, although notes on specific versions can be found here as well. If you're upgrading from a very old verison, you will need to stage your upgrade. For example, you must read the upgrade notes for each version in between.
Contents
All Versions
For general upgrades, you should make sure you:
- Read the changelog!
- Replace all binaries.
- dlls, modules / *.dll/*.so - This includes amxmodx_mm and all modules.
- plugins/*.amxx - Any default plugins AMX Mod X comes with.
- data/GeoIP.dat - If you use GeoIP, make sure you update the database.
- Replace language files.
- data/lang/*.txt - Important to make sure plugins are using the right language phrases.
- Read the upgrade notes to see any other custom changes needed.
- If you do scripting locally...
- Replace all base include and source files (.inc, .sma).
- Replace the compiler and its binaries (amxxpc, amxxpc32, amxxpc64).
Upgrading to AMX Mod X 1.8.0
There are no extra upgrade instructions -- AMX Mod X 1.8.0 should be fully backward compatible with old installations. If you wish to use new configuration features, it is recommended that you merge configuration files on a case-by-case basis.
Upgrading to AMX Mod X 1.76d
Instructions for upgrading to AMX Mod X 1.76 from older versions are below.
From 1.76c
- Follow general upgrade instructions. This was a binary-only update.
- Backwards Compatibility Warning: Certain non-GPL plugins will no longer load under AMX Mod X. The "hall of shame" list currently includes: (note - heuristics updated 3/10)
- czgungame.amxx by "Live"
- Changed files:
[ALL PACKAGES] configs/ core.ini plugins/ (all recompiled) [BASE] dlls/ amxmodx_mm modules/ fakemeta_amxx scripting/ amxmod_compat/ vexdum.sma include/ amxmod_compat/ maths.inc VexdUM.inc amxconst.inc amxmisc.inc amxmodx.inc csx.inc dbi.inc dodfun.inc dodx.inc engine.inc engine_stocks.inc fakemeta.inc fakemeta_const.inc fakemeta_stocks.inc float.inc fun.inc geoip.inc message_const.inc message_stocks.inc messages.inc ns.inc ns2amx.inc nvault.inc sockets.inc sqlx.inc string.inc tfcconst.inc tfcx.inc tsfun.inc tsx.inc vector.inc amxxpc32.so/dll amxxpc64.so/dll admin.sma adminchat.sma admincmd.sma pausecfg.sma [COUNTER-STRIKE] scripting/ miscstats.sma statsx.sma [NATURAL SELECTION] modules/ ns_amxx scripting/ idlekicker.sma
From 1.76b
- Follow general upgrade instructions. This update was a binary-only update.
- Backwards Compatibility Warning: CSX no longer ranks bots by default. Set csstats_rankbots to 1 to revert this change.
- Changed files:
AMX Mod X Base: dlls/ amxmodx_mm nvault_amxx plugins/ (all recompiled) scripting/ admin.sma mapschooser.sma mapsmenu.sma menufront.sma pausecfg.sma telemenu.sma includes/ amxmodx.inc amxconst.inc geoip.inc sqlx.inc amxmod_compat/ xtrafun.inc Counter-Strike: modules/ csx_amxx plugins/ (all recompiled) scripting/ restmenu.sma statsx.sma Day of Defeat: plugins/ (all recompiled) scripting/ stats.sma Natural Selection: plugins/ (all recompiled) scripting/ nscommands.sma
From 1.76a
- Follow general upgrade instructions. This update was a binary-only update, except for a language change to statsx.txt.
From 1.76
- Follow general upgrade instructions. This update was a binary-only update, except for "common.txt."
From 1.75
- Follow general upgrade instructions.
- You may want to recompile your plugins for new implementations of replace_all() and other stocks, however, 1.76 is a binary only upgrade from 1.75.
From 1.71
- Follow general upgrade instructions.
- Make the following configuration changes:
- Recommended: Open configs/sql.cfg. Add the new cvar:
- amx_sql_type "mysql"
- Note: Other option is "sqlite"
- Optional: Open configs/modules.ini.
- If you are using MySQL or SQLite, or any custom modules, write them down.
- Replace your old modules.ini with 1.75's stock version.
- Re-add your custom or SQL modules back in.
- Recommended: Open configs/sql.cfg. Add the new cvar:
- Optional: Recompile 3rd party plugins.
- If you wish to take advantage of some automatic module loading features, plugins will need to be recompiled with the 1.75 compiler. However, all old plugins will work as is.
From 1.70
- Follow general upgrade instructions.
- Make the following configuration changes:
- Open configs/core.ini.
- Replace the contents with the core.ini from AMX Mod X 1.75.
- Note: Make sure to note any custom changes!
- Open configs/core.ini.
- Continue by following instructions for 1.71.
From 1.50, 1.55, 1.60
- Follow general upgrade instructions.
- Make sure you have Metamod version 1.19 or higher installed.
- Continue by following instructions for 1.70.
From 1.01, 1.00, or 0.20-RC4+
- Follow general upgrade instructions.
- Recommended: replace all of your scripting tools with the latest versions of includes and the compiler. Then, recompile all of your custom or 3rd party plugins with AMX Mod X 1.75.
- Continue by following instructions for 1.50/1.55/1.60.