Configuring AMX Mod X

From AlliedModders Wiki
Revision as of 17:32, 15 January 2006 by BAILOPAN (talk | contribs) (Configs)
Jump to: navigation, search

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