Admin Mod Version 2.50e Documentation and Online Help June 15, 2001 v2.50e.150601 Please visit our web site at http://www.adminmod.org/ Admin Mod works alongside Metamod Check out Metamod at http://metamod.org/ The latest version of the Admin Mod documentation can always be found online, at the Admin Mod web site: http://www.adminmod.org/help Visit the Admin Mod web forums to discuss Admin Mod with others and to get help when you can't find answers to your questions in the manual. Documentation Revision Information: v2.50e.150601 v2.50d.060601 Revision information for recent release is available in the Reference Section 1 Table of Contents ADMIN MOD VERSION 2.50E..............................................................................1 WHAT'S NEW?.....................................................................................................4 ABOUT ADMIN MOD ...........................................................................................8 Introducing Admin Mod.................................................................................................8 What this document covers (and what it doesn’t)........................................................10 IMPORTANT INFORMATION FOR BEFORE YOU START...............................11 Introductory Information (or, Read Me First)...............................................................11 READ THIS DOCUMENTATION BEFORE YOU START.............................................................. 11 IMPORTANT NOTE ABOUT EDITING CONFIGURATION FILES................................................ 11 HOW ADMIN MOD WORKS ......................................................................................................... 11 INSTALLING AND CONFIGURING ADMIN MOD 2.50......................................13 Default Windows Installation of Admin Mod................................................................13 Unzipping Admin Mod the Right Way .........................................................................15 Running the Windows Installation Script.....................................................................16 Manual Installation - Walk-Through ............................................................................22 Linux Installation Information......................................................................................27 1st Time Linux Install output.......................................................................................28 Linux Upgrade Install..................................................................................................29 Linux Encrypted Passwords .......................................................................................30 Uninstalling Admin Mod..............................................................................................31 Setting up Admin Mod with MySQL ............................................................................32 CONFIGURATION..............................................................................................34 The Admin Mod Configuration Files............................................................................34 Setting up server.cfg and the .ini files.........................................................................37 Setting up your server.cfg file .....................................................................................38 Creating/Configuring Your server.cfg file:.......................................................................................... 39 SETTING UP YOUR USERS.INI FILE................................................................44 Setting up your plugin.ini file.......................................................................................51 Setting up your ips.ini file............................................................................................53 Setting up your maps.ini file .......................................................................................54 2 Setting up your models.ini file.....................................................................................55 How to Use Bots with Admin Mod ..............................................................................56 SETTING UP CLIENTS TO USE ADMIN MOD ..................................................59 Client configuration via setinfo commands..................................................................59 ADMIN MOD PLUGINS ......................................................................................64 The Admin Mod Default Plugins .................................................................................64 Downloading and Installing Additional Plugins............................................................66 SCRIPTING BASICS ..........................................................................................68 A Beginner's Guide to Scripting..................................................................................68 A SCRIPTING CRASH-COURSE.................................................................................................. 68 Declaring variables:....................................................................................................................... 68 Commenting: ................................................................................................................................. 69 Using functions:............................................................................................................................. 70 Statements and Loops:.................................................................................................................. 71 Other random things:..................................................................................................................... 73 Compiling Admin Mod Scripts 101..............................................................................74 DOWNLOADING ADMIN MOD PLUGINS .................................................................................... 74 A BASIC COMPILING TUTORIAL................................................................................................. 74 ERRORS AND WARNINGS DURING COMPILING...................................................................... 75 Compiling scripts by hand ..........................................................................................77 ADMIN MOD REFERENCE ................................................................................79 Materials for reference when installing, configuring and using Admin Mod .................79 Admin Mod Commands..............................................................................................80 Admin Mod Configuration Variables (CVARs) ............................................................85 User Access Levels - Version 2.50d...........................................................................97 Spawning HL Entities ...............................................................................................100 Developer Change Log - AM plugins........................................................................104 Developer Change Log - AM DLL.............................................................................106 Admin Mod Error Codes...........................................................................................109 ADMIN ETC ......................................................................................................111 FREQUENTLY ASKED QUESTIONS (FAQ) ...................................................111 WHERE TO GO FOR HELP .............................................................................117 3 What's New? Admin Mod 2.50 has a load of new commands and functions, making it more accessible and powerful. Some are obvious, such as the implementation of plugin scripts, and others are less so. Below is a high-level list of the changes in the last few releases of Admin Mod. New in version 2.50e release (June 15, 2001): Version 2.50e contains several bug-fixes and performance enhancements. See the change logs in the Admin Mod Reference section for details. The procedure for using Bots with Admin Mod has been changed, and is now simpler. Please see How to Use Bots with Admin Mod for more information. Updated the credits for the A-Team in the readme and docs. New in version 2.50d maintenance/bug-fix release (June 2001): Among the most notable of the changes made for 2.50d are: Client Authentication instructions and procedures modified For security reasons, the installer will no longer create an autoexec.cfg file. Instead, it creates a file called adminpass.cfg , which you can either exec from the console, or you can add it to a desktop shortcut just for connecting to your server. More information is available in the section Required Client Configuration Instructions. New CVARs: admin_repeat_freq, admin_vote_echo, amv_autoban You now have the ability to specify in your server.cfg file how often the center- say repeating message should appear. You also can control voting display a little better, and an auto-kick/ban option has been added for dealing with players that use non-printable characters in the game to crash people. Access levels chaged for admin_exec functions All admin_exec functions have now been changed to a higher access level. See that section of the documentation for more information. You can now use * without it being recognized as a comment This was causing some confusion and unnecessary tech support requests. It has been fixed in this version.