• AMX Guide Home
  • Step 1: Installing AMX
  • Step 2: Enabling AMX
  • Step 3: Configuring AMX
  • AMX by File:
    • amx.cfg
    • mysql.cfg
    • clcmds.ini
    • cmds.ini
    • configs.ini
    • cvars.ini
    • maps.ini
    • modules.ini
    • paths.ini
    • plugins.ini
    • speech.ini
    • users.ini
  • AMX by Topic:
    • Creating Admins
    • Commands Guide
    • Plugin Installation
    • Plugin Compiling
    • Module Setup
    • Menu Use
    • Language Setup
    • Language Install
    • Weapon Restriction
    • Stats Setup
    • Custom Map Configs
  • Misc. Resources
  • Credit
AMX Mod 2006 Setup Guide
Half-Life server administration

amx.cfg - The main config

The amx.cfg file in your addons\amx\config folder is where most of the settings are made for AMX. This file is executed every map change. So if you make a change to this file, it's not necessary to restart the server unless the change is needed immediately.

All the settings in this file have comments describing what that setting does, and the different values that can be used. Below you will find additional help for the amx.cfg file

amx_default_access

Valid Settings:
Example:
Description:
a through u & z (can be more than one letter)
amx_default_access "z"
This is what access any player would have when joining your server. Be careful with this. If you wanted to allow voting, you would assign this value the letter j.

amx_password_field

Valid Settings:
Example:
Description:
Anything.
amx_password_field "_pw"
This password field needs to match on the server and the client. It can be what ever you want, but it must match. If you use the default shown above, then the clients should have setinfo _pw "password" set in their userconfig.cfg file in their mod folder. For more info on how to set a client up as an admin using password go here.

amx_mode

Valid Settings:
Example:
Description:
0, 1 or 2
amx_mode "1"
0 Disables admin access all together. AMX runs, but no one will have admin access even if they are set up to. 1 is normal operation for AMX. 2 will kick anyone not in the users.ini file. This is in effect the same as a private server.

amx_correct_usersfile

Valid Settings:
Example:
Description:
0 or 1
amx_correct_usersfile "1"
0 is for normal operation. 1 will attempt to correct easily identifiable errors in the users.ini file.

amx_show_activity

Valid Settings:
Example:
Description:
0, 1 or 2
amx_show_activity "2"
This will cause AMX to make public some AMX functions as they happen in game (amx_show_activity "1"), and also the admin who is running the command if desired ("2"). This may be helpful in keeping admins accountable, but it also reveals who an admin is.

amx_scrollmsg

Valid Settings:
Example:
Description:
Any message.
amx_scrollmsg "Welcome! You're on %hostname%" 600
This message appears in the lower center of the screen and scrolls by at a specified interval. The number at the end is the interval in seconds, so 600 seconds would make the message appear every 10 minutes. Make sure to use quotes around your message. If you use %hostname% it will be replaced with your server's hostname.

amx_imessage

Valid Settings:
Example:
Description:
Any message.
amx_imessage "Welcome to %hostname%!" "000100255"
This message appears in the center of the screen. The number at the end is the color you want the message to appear in. Use this web applet to get the numeric value of the RGB color you want to use. Make sure to use quotes around your message. %hostname% will be replaced with your server's hostname. You can specify several amx_imessage lines: the messages will cycle.

amx_freq_imessage

Valid Settings:
Example:
Description:
Length of time in seconds.
amx_freq_imessage "180"
Setting this to 180 would cause the amx_imessage to display every 3 minutes.

amx_flood_time

Valid Settings:
Example:
Description:
Length of time in seconds.
amx_flood_time "0.75"
Setting this to 0.75 means players can't use the say command more than once every 3/4's of a second. This helps to prevent people from flooding the server with unwanted chat.

amx_reservation

Valid Settings:
Example:
Description:
0~4
amx_reservation "0"
The value this is set to will control how the reserved slot is handled. 0 disables the plugin. 1 kicks the player with the shortest playing time. 2 kicks the player with the longest playing time. 3 kicks the player with the highest ping. 4: AMX 099 Mode: 'amx_reservedslots' are reserved, nobody is kicked when an admin connects to a full server.

amx_reservedslots

Valid Settings:
Example:
Description:
0~maxplayers
amx_reservedslots "0"
Number of slots you want to reserve for your admins (if amx_reservation is set to 4).

amx_hideslots

Valid Settings:
Example:
Description:
0 or 1
amx_hideslots "0"
Hide the reserved slots or not (if amx_reservation is set to 4).

amx_time_display

Valid Settings:
Example:
Description:
See amx.cfg file.
See amx.cfg file.
This controls the text reminder at the bottom of the screen that tells you how many minutes are remaining on the current map. The amx.cfg has the best description for this. Most people will probably leave this its default setting.

amx_time_voice

Valid Settings:
Example:
Description:
0 or 1
amx_time_voice "1"
When a player types /thetime or /timeleft as a chat message, the current time or time left for the map is displayed. This setting will cause a voice to say what time it is as well when set to 1.

amx_vote_delay

Valid Settings:
Example:
Description:
Length of time in seconds.
amx_vote_delay "30"
This is the time in seconds before another vote is allowed.

amx_vote_time

Valid Settings:
Example:
Description:
Length of time in seconds.
amx_vote_time "20"
Time in seconds a vote will stay up for voting.

amx_vote_answers

Valid Settings:
Example:
Description:
0 or 1
amx_vote_answers "1"
Setting this to 1 causes what people voted to be known to everyone.

amx_votekick_ratio

Valid Settings:
Example:
Description:
0.00 to 1.00
amx_votekick_ratio "0.60"
Vote ratios work like this: 0.10 = 10%, 0.50 = 50%, 1.00 = 100%. You get the idea. This is the percentage required for a kick vote to go through. Consider carefully what you set this to, or the minority of players on your server will have decision making abilities if you allow voting.

amx_voteban_ratio

Valid Settings:
Example:
Description:
0.00 to 1.00
amx_voteban_ratio "0.60"
Vote ratios work like this: 0.10 = 10%, 0.50 = 50%, 1.00 = 100%. You get the idea. This is the percentage required for a ban vote to go through. Consider carefully what you set this to, or the minority of players on your server will have decision making abilities if you allow voting.

amx_votemap_ratio

Valid Settings:
Example:
Description:
0.00 to 1.00
amx_votemap_ratio "0.60"
Vote ratios work like this: 0.10 = 10%, 0.50 = 50%, 1.00 = 100%. You get the idea. This is the percentage required for a map vote to go through. Consider carefully what you set this to, or the minority of players on your server will have decision making abilities if you allow voting.

amx_vote_ratio

Valid Settings:
Example:
Description:
0.00 to 1.00
amx_vote_ratio "0.60"
Vote ratios work like this: 0.10 = 10%, 0.50 = 50%, 1.00 = 100%. You get the idea. This is the percentage required for a vote to go through. Consider carefully what you set this to, or the minority of players on your server will have decision making abilities if you allow voting.

amx_mapsmenu_mapsloc

Valid Settings:
Example:
Description:
0, 1 or 2
amx_mapsmenu_mapsloc "0"
Allows you to choose the location of the maps listed on the maps menu. 0 uses the maps.ini. 1 uses the mapcycle.txt. 2 uses the contents of the maps folder.

amx_mapchooser_mapsloc

Valid Settings:
Example:
Description:
0, 1 or 2
amx_mapchooser_mapsloc "0"
Allows you to choose the location of the maps that can be voted on. 0 uses the maps.ini. 1 uses the mapcycle.txt. 2 uses the contents of the maps folder.

amx_mapchooser_type

Valid Settings:
Example:
Description:
0 or 1
amx_mapchooser_type "0"
This setting controls how the maps are voted on for the next map. 0 chooses random maps from what amx_mapchooser_mapsloc is set to. 1 chooses maps by nomination.

amx_nominfromfile

Valid Settings:
Example:
Description:
0 or 1
amx_nominfromfile "0"
This setting controls what maps can be nominated for voting. 0 chooses from the maps folder. 1 uses the setting from amx_mapchooser_mapsloc.

amx_maxnominperplayer

Valid Settings:
Example:
Description:
Any number.
amx_maxnominperplayer "1"
This setting controls how many maps each player can nominate.

amx_extendmap_max

Valid Settings:
Example:
Description:
Any number.
amx_extendmap_max "3"
This is the maximum amount of times a map can be extended (if you use mp_timelimit).

amx_extendmap_step

Valid Settings:
Example:
Description:
Length of time in minutes.
amx_extendmap_step "15"
Time in minutes that a mapcycle will be extended if vote to do so succeeds.

amx_extendround_max

Valid Settings:
Example:
Description:
Any number.
amx_extendround_max "3"
This setting controls how many times a map can be extended (if you use mp_maxrounds).

amx_extendround_step

Valid Settings:
Example:
Description:
Any number.
amx_extendround_step "3"
This setting controls how many rounds a map is extended. If amx_extendround_max is set to 3, then a map can be extended three times. Each extension lasts 3 rounds, or whatever amx_extendround_step is set to.

amx_extendwin_max

Valid Settings:
Example:
Description:
Any number.
amx_extendwin_max "3"
This method for map extension can be used if the server uses mp_winlimit. This setting controls how many times the map can be extended in wins. For example if mp_winlimit is set to 10, an extension vote is called when the number of wins of a team reaches 8. If people vote to extend and amx_extendwin_step is set to 3, mp_winlimit is set to 13.

amx_extendwin_step

Valid Settings:
Example:
Description:
Any number.
amx_extendwin_step "3"
This setting controls how many wins a map is extended. If amx_extendwin_max is set to 3, then a map can be extended three times. Each extension lasts 3 wins, or whatever amx_extendwin_step is set to.

amx_manage_plugins

Valid Settings:
Example:
Description:
0 or 1
amx_manage_plugins "0"
Automatically add/remove plugins from AMX's plugins.ini according to the content of the plugins folder.

amx_manage_modules

Valid Settings:
Example:
Description:
0 or 1
amx_manage_modules "0"
Automatically add/remove modules from AMX's modules.ini according to the content of the modules folder.

amx_debug

Valid Settings:
Example:
Description:
0, 1 or 2
amx_debug "0"
Provides extra output on the console and/or AMX log files for debugging problems. 0 = No logging, 1 = Prints to server console, 2 = Prints to server console and the AMX logs.

amx_langdebug

Valid Settings:
Example:
Description:
""
amx_langdebug "fr de pl"
To debug a language put its 2 letter code between quotes. Separate the codes by a space.
For example: amx_langdebug "fr de pl"
If you want to debug a language for a plugin, enable only this plugin in your plugins.ini
Errors are logged to amx/logs/error_lang.log
"" means disabled

Counter-Strike Specific cvars

amx_bomb_frags

Valid Settings:
Example:
Description:
Any number.
amx_bomb_frags 3
This allows you to modify the number of frags awarded to a successful bomb plant or defusal.

amx_statsx_duration

Valid Settings:
Example:
Description:
Length of time in seconds.
amx_statsx_duration 12.0
The amount of seconds that the player stats stay up on the screen after you die.

amx_statsx_freeze

Valid Settings:
Example:
Description:
Length of time in seconds.
amx_statsx_freeze -2.0
This is the amount of time that the stats from the previous round stay up on the screen. Giving this a -2 value means the stats will disappear 2 seconds before the freezetime ends (ie. whatever the mp_freezetime cvar is set to).

csstats_rank

Valid Settings:
Example:
Description:
0, 1 or 2
csstats_rank 1
This controls how player ranks are tracked. 0 = Playername, 1 = Steamid, 2 = IP address.

csstats_rankbots

Valid Settings:
Example:
Description:
0 or 1
csstats_rankbots 1
This controls whether or not bots are included in the rankings.

csstats_pause

Valid Settings:
Example:
Description:
0 or 1
csstats_pause 0
0 = Normal operation, stats being tracked, 1 = Player stats will not be tracked.

csstats_maxsize

Valid Settings:
Example:
Description:
0 to 7000
csstats_maxsize 3500
When the number of players tracked reaches this amount, the stats are reset. Setting this to 0 disables the stat tracking.

csstats_reset

Valid Settings:
Example:
Description:
0 or 1
csstats_reset 1
Setting this to 1 will force the stats to be reset on the next map change.
Half-Life is a registered trademark of VALVe Software and Sierra
AMX Mod was created by OLO and is not affiliated with VALVe.