Configuring AMX Mod X

Admins

See the section on Adding Admins for more information.

Plugins

Installing

Often, plugins will have their own directions if they need special installation requirements. However, this will instruct you on the basics of adding a plugin.

1. Follow any directions the plugin author has given you. If the plugin requires extra steps or special files, make sure you have them in the proper place and order.
2. If you are given a .sma source file instead of a .amxx, you must compile the plugin yourself. For more information, see Compiling Plugins (AMX Mod X).
3. Place the plugin's .amxx file in the addons/amxmodx/plugins folder.
4. Add the plugin's name to addons\configs\plugins.ini. Example:

   myplugin.amxx

5. Restart the server or change maps. If the plugin has any load errors, see Troubleshooting AMX Mod X#Plugins.

Removing

1. Remove the entry from addons\amxmodx\configs\plugins.ini by deleting it or prepending a semi-colon to comment it out.
2. Delete any associated files.

Default Plugins

Plugin	Purpose
admin.amxx	Administration Base
admin_sql.amxx	Administration Base for SQL. Use only one base.
admincmd.amxx	Basic administration commands (such as kick/slap).
adminhelp.amxx	Help for admin commands.
adminslots.amxx	Slot reservation.
multilingual.amxx	Multi-Lingual client configuration.
menufront.amxx	Front-end for admin menus.
cmdmenu.amxx	Command menu for settings.
plmenu.amxx	Player menu commands (kick, ban, etc).
telemenu.amxx	Teleport Menu (fun module required).
mapsmenu.amxx	Maps menu (vote, changeleve, etc).
adminchat.amxx	Console-based chat commands.
antiflood.amxx	Prevents clients from flooding the say chat.
scrollmsg.amxx	Displays a scrolling message.
imessage.amxx	Displays a centered, timed information message.
adminvote.amxx	Voting commands.
nextmap.amxx	Displays next map in the mapcycle.
mapchooser.amxx	Allows players to vote for the next map.
timeleft.amxx	Displays time left on the current map.
pausecfg.amxx	Allows pausing/unpausing of plugins.
statscfg.amxx	Configuration of statistical plugins.

Modules

Modules add additional functionality for plugins to use.

Installing

1. Figure out what operating system your server is: Windows, Linux, or Linux using AMD64 (64bit).
2. If the module is 3rd party, download the module corresponding to your OS. It will end in .dll for Windows, _i386.so for Linux, or _amd64.so for AMD64.
3. Place the file in addons/amxmodx/modules/ and follow any additional instructions.
4. Add the module's name to addons\amxmodx\configs\modules.ini. AMX Mod X supports generic notation, for example:

   mysql_amxx

   ... will automatically detect the correct module to use.
5. To see if the module is working, you can type amxx modules in your server console.

Removing

1. Remove the entry from addons\amxmodx\configs\modules.ini by deleting it or prepending a semi-colon to comment it out.
2. Delete any associated files if you don't need them.

Default Modules

Module	Purpose
fun_amxx	General functions for changing game values.
engine_amxx	More advanced functions for getting and setting values in the HL engine.
fakemeta_amxx	Expert/advanced functions for manipulating, hooking, and calling functions in the HL engine.
*sql_amxx	SQL/Database scripting functions.
geoip_amxx	Functions for finding countries by IP address.
array_amxx	Functions for somewhat-dynamic arrays.
sockets_amxx	Functions for socket (TCP/UDP) control and manipulation.
regex_amxx	Functions for regular expression support.

CVARs

The base CVARs AMX Mod X defines are located in amxmodx/configs/amxx.cfg. You can edit these the same way you edit the server.cfg file:

CVAR	Default Setting	Purpose
amx_default_access	"z"	Sets the default access level for non-admin players.
amx_password_field	"_pw"	Name of the setinfo key which a user should store their password in.
amx_mode	1	Changes the mode of logging into a server: 0 - Disable logging, players won't be checked and no access will be given. 1 - Normal mode which obeys flags set in accounts. 2 - Kick all players not on the users list.
amx_show_activity	2	Sets the mode of admin activity on the server: 0 - Disabled 1 - Show action anonymously 2 - Show action with the admin's name
amx_scrollmsg	"Welcome to %hostname% -- This server is using AMX Mod X" 600	Sets the parameters (message and frequency) for a scrolling message.
amx_imessage	"Welcome to %hostname" "000255100" "This server is using AMX Mod X\nVisit http://www.amxmodx.org" "00010025"	Adds a center-typed colored message. The last parameter is in RRRGGGBBB format (red, green, blue).
amx_freq_imessage	180	Frequency, in seconds, of the colored center messages.
amx_flood_time	0.75	Chat flood prevention. Sets how fast a player can chat (in seconds).
amx_reservation	0	Sets the amount of reserved slots.
amx_time_display	"ab 1200" "ab 600" "ab 300" "ab 180" "ab 60" "bcde 11"	Sets flags for remaining time display: a - Display white text on bottom b - Use voice c - Don't add "remaining" in voice d - Don't add "hours/minutes/seconds" in voice e - Show/speak if current time is less than set in parameter
amx_time_voice	1	Sets whether to announce "say thetime" and "say timeleft" with voice.
amx_vote_delay	10	Sets the minimum delay in seconds between two voting sessions.
amx_vote_time	10	Sets how long a voting sessions lasts for.
amx_vote_answers	1	Displays who votes for which options, publically.
amx_voteban_ratio	0.40	Ratio for a ban vote to be successful.
amx_votekick_ratio	0.40	Ratio for a kick vote to be successful.
amx_votemap_ratio	0.40	Ratio for a map vote to be successful.
amx_vote_ratio	0.40	Ratio for a general vote to be successful.
amx_extendmap_max	90	Maximum time a mapvote can be extended.
amx_extendmap_step	15	Amount of time a map extensions adds.
amx_client_languages	1	Enables or disables the ability for clients to choose their own language.
amx_debug	1	Sets the debug mode for plugins: 0 - No debugging (warning messages for plugin errors) 1 - Plugins with "debug" option in plugins.ini are put into debug mode. 2 - All plugins are put into debug mode (full backtraces for errors). Note that debug mode greatly decreases JIT performance.
amx_mldebug	0	Logs multi-lingual translation problems.

SQL

Make sure you have mysql_amxx enabled in AMX Mod X's amxmodx/configs/modules.ini file.

Then, open amxmodx/configs/sql.cfg and edit the cvars accordingly:

CVAR	Default Setting	Purpose
amx_sql_host	"127.0.0.1"	IP address of SQL server.
amx_sql_user	"root"	Username to connect to the SQL server.
amx_sql_pass	""	Password to connect to the SQL server.
amx_sql_db	"amx"	Database to use on the SQL server.
amx_sql_table	"admins"	The table to use for the admin_sql plugin.

Maps

If you use the mapsmenu plugin, you can either use "maps.ini" or "mapcycle.txt" to manage map rotations.

Delete "maps.ini" to use mapcycle.txt, otherwise, simply add a list of map names to maps.ini like so:

de_dust
cs_assault
de_aztec

Et cetera. For each map, you can also add a configuration file that will execute when the map loads. This is useful to set certain settings for 3rd party maps, say, removing the freeze time on fy_iceworld.

To do this, simply create a folder in amxmodx/configs called "maps" and place a .cfg file named after the map with the settings in it, for example, you might have amxmodx/configs/maps/fy_iceworld.cfg:

mp_startmoney 16000
mp_freezetime 0
mp_timelimit 20

Menus

Client Commands

File:	addons\amxmodx\configs\clcmds.ini
Format:	"Name" "Command" "Flags" "Access Level"
Options:	Name is the name that will appear on the menu. Command is the format for the console command - you can use %userid% to insert the user's id. Flags are one of the following:. a - execute from server console. b - execute from admin console. c - execute on selected player. d - display menu again once done
Example:	"Slay player" "amx_slay #%userid%" "bd" "u"

Commands

File:	addons\amxmodx\configs\cmds.ini
Format:	"Name" "Command" "Flags" "Access Level"
Options:	Name is the name that will appear on the menu. Command is the format for the console command - you can use %userid% to insert the user's id. Flags are one of the following:. a - execute from server console. b - execute from admin console. c - execute on selected player. d - display menu again once done
Example:	"Pause" "amx_pause" "bd" "u"

Configs

File:	addons\amxmodx\configs\configs.ini
Format:	"Name" "Command" "Flags" "Access Level"
Options:	Name is the name that will appear on the menu. Command is the format for the console command. Flags are one of the following:. a - execute from server console. b - execute from admin console. d - display menu again once done
Example:	"PUBLIC Settings" "servercfgfile server.cfg;exec server.cfg" "a" "u"

Speech

File:	addons\amxmodx\configs\speech.ini
Format:	"Name" "Command" "Flags" "Access Level"
Options:	Name is the name that will appear on the menu. Command is the format for the console command - you can use %userid% to insert the user's id. Flags are one of the following: a - execute from server console b - execute from admin console c - execute on selected player d - display menu again once done
Example:	"Hello!" "spk \'vox/hello\'" "cd" "u"