
   -------------------------------------------------------------------------------------------

   RS UAIO (Ultimate All-In-One) Admin Menu System
   File: UAIO Admin README File
   Version: 1.51
   Date: Aug. 01, 2006

   Origionally By:    Rob Secord
   Alias: xeroblood (aka; Achilles; sufferer)
   Email: xeroblood@msn.com

   Updated By:    Dan Weeks
   Alias: $uicid3
   Email: suicid3m3@gmail.com

   -------------------------------------------------------------------------------------------

   For More Help, Visit the Online Forums at AMX Mod X (http://www.amxmodx.org/forums)
   Plugin Address: http://forums.alliedmods.net/forumdisplay.php?f=95

   -------------------------------------------------------------------------------------------
   Required Modules:  
   -------------------------------------------------------------------------------------------
      Engine, Fun, Cstrike

   -------------------------------------------------------------------------------------------
   Description:
   -------------------------------------------------------------------------------------------
      
      UAIO is the Ultimate-All-In-One Admin Menu System for AMX and AMX Mod X!

      UAIO has the potential to house 128 Internal Commands + 128+ External Commands all
         from 1 Menu System In-Game! Currently only 81 Internal & 35 External, though
         External Commands may be added/removed by You, depending on any other plugins
         you may have installed on your server!

      Best of all, any command(s) can be restricted from
         some admins, and granted to others!  100% Customizable, UAIO has its own Unique
         Admin System built soley for UAIO!

      With 4 Command Types: Vote, Good, Evil and Misc, and Admin Groupings to help handle
         Admin Management, UAIO is very organized and easy to use! Including its own Help
         features in console!

      Not to mention that each Internal Command can be run individually from the console to 
         allow for more control of the Command, and key-binding for 1-Touch Access!

   -------------------------------------------------------------------------------------------
   Installation Instructions:
   -------------------------------------------------------------------------------------------
     --------------------------------
     AMXX Version 1.75
     --------------------------------
      1. Extract the all the files to a temporary folder (on the Desktop works best).
         a. (Local Game Server)
            1. Open the directory of your local game server. 
                  e.g C:/Program Files/Steam/Steamapps/<username>/dedicated server/cstrike/
            2. Open the temporary directory of the extracted files.
                  (go into the cstrike folder if you haven't)
            3. Copy the contents from the extracted files to your server files.
              * Make sure that you DO NOT have something like the following happening:
                C:/.../dedicated server/cstrike/cstrike/addons/
              * It should just have one cstrike directory.

         b. (Remote Game Server)
            1. Open your FTP program.
            2. In the FTP navigate to the temporary directory of the extracted files on the
                 local files and navigate to your cstrike directory on the remote side.
            3. Upload everything from the temporary extracted files (in cstrike) to your
                 remote server files (in cstrike)

      2. Configure your CVARS. Open cstrike/uaio_config.cfg and edit them as you please.
          * Make sure you add a line in your server.cfg file like the following:
            exec uaio_config.cfg

      3. Configure admins. Open cstrike/addons/amxmodx/configs/uaio/uaio_admins.ini
            and read how to add admins in that file. Or continue on to next step and use
            the uaio_addadmin command to go through a menu to add admins.

      4. Change maps / restart server and both plugins should be running.

      5. To not use the manager plugin open up cstrike/addons/amxmodx/configs/plugins-uaio.ini
            and put ; at the beginning of the line infront of uaio_manager.amxx so that it looks like:
            ;uaio_manager.amxx

     --------------------------------
     AMXX Version < 1.75
     --------------------------------

      1. The 'cstrike' folder that comes packaged with this ZIP file has all of the files in 
         their proper places; simply copy this folder onto your existing 'cstrike' folder!

      2. Add a line to your /cstrike/addons/amxmodx/configs/plugins.ini file containing:
           uaio_admin.amxx

      3. Open your /cstrike/addons/amxmodx/configs/modules.ini file. Make sure you have enabled
         Fun, Engine, and Cstrike modules. Enable by removing the ; from the beginning of the line.

      4. Configure CVARs to suit your needs!
         Read the CVAR Config File (cstrike/uaio_config.cfg) for more help with CVARs!

      5. Installation Complete!
         NOTE: You CANNOT use UAIO Menu yet, until you configure yourself (and any others)
         as UAIO Admins.  Read next section carefully!

      6. UAIO Comes with an additional Plugin for Managing UAIO Admins In-Game!
              Created for UAIO by Dan ($uicid3), Thx Dan! ...( No Prob :P)
         To install the Admin Manager Plugin simply add another line to your
         /cstrike/addons/amxmodx/configs/plugins.ini file containing:
            uaio_manager.amxx
            
         Note: You may still create your Groups manually, but you only do that once,
               usually done when you install UAIO.  After that, you can assign New Admins
               in-game to have access to UAIO!

      7. Optional: UAIO Contains a Recruit Info MOTD (Misc->Recruit Info MOTD) that you can
                   display to players who wish to join your clan/team.
                   If you plan to use this feature, you must edit the MOTD file located at:
                   /cstrike/addons/amxmodx/configs/uaio/uaio_recruit.htm
                   to reflect Your Clans/Teams Recruitment Information.

   -------------------------------------------------------------------------------------------
   Using UAIO Admin Menu
   -------------------------------------------------------------------------------------------
  
     There are two ways to use UAIO:

       1. From the console; you can call any command from the Console as well as the Menu.
          Use: uaio_help for more information in-game.

       2. Use the Menu!  uaio_menu
          Bind it to a key: bind F2 uaio_menu

          Simply walk through the Menu selecting your desired Options along the way!

   -------------------------------------------------------------------------------------------
   Using the Addon Plugin: UAIO Admin Manager
   -------------------------------------------------------------------------------------------
  
     As stated above, UAIO Comes with an additional Plugin for Managing Admins In-Game!
     Created for UAIO by Dan (Suicid3), Thx again Dan! :P

     To add an admin, simply join your server and enter the following command in the console:
        uaio_addadmin
     Then follow the Menu Instructions and Select the player who you wish to give access
     to the UAIO Admin Menu!
     
     HINT: Bind the menu to a key: bind F3 uaio_addadmin
     
     NOTE: The player must be in the server to add them as admin with this plugin.
           And don't forget to change the map to refresh the admins after adding them!
     NOTE: This menu is accessible to any admin with flag 'm' by default. To change this
           open cstrike/addons/amxmodx/scripting/uaio_inc/config.inc and change the line:
                 #define UAIO_LVL_SUPER ADMIN_LEVEL_A
           to any level you want. Or you can just not give any admin access to flag 'm'

   -------------------------------------------------------------------------------------------
   Setting Up Groups & Admins
   (This is the ADVANCED way!  Easy way: use the UAIO Admin Manager Plugin to Add Admins!)
   -------------------------------------------------------------------------------------------
      Groups:
      ------
        For reference: there are 5 Group-Sets (each with 4 Group-Types) already made for you!
        They could be refered to as Groups-Sets; TypeA, TypeB, TypeC, TypeS and TypePublic, and 
        can be found in: /cstrike/addons/amxmodx/configs/uaio/uaio_groups.ini


        There are 4 Command-Types; Vote, Good, Evil, Misc.
        A Group represents the Access Level an Admin has for each command of that particular
        Command-Type. Each Group must specify its Command-Type and a set of
        associated Command-Flags which represent each individual Command of that Type.
        To make a Group-Set, you would make 4 Groups; 1 for each Command-Type.

        Here is an example of a Group:

               group       "grp_vote_typeS"       "vote"       "abcdefghijklmnopqr"

        Well spaced so you can see the 4 different sections.
        - The first part simply indicates to the plugin that this line is a Group. DO NOT CHANGE IT!
        - The second line is the Name of the Group and will be used to associate 
            the Group to any Admins.  This name could be called anything you want to call it,
            but the shorter the name the better chance of it working!  ;)
        - The third part indicates the Command-Type; vote, good, evil or misc. Notice that 
            they are not capitalized in the example above.
        - The forth part is a string of characters, each one representing a Command in the
            associated Command-Type.  If the character is in the string then that group has
            access to that Command! A list of the Command-Flags and their associated
            Commands can be found /cstrike/addons/amxmodx/configs/uaio/Command Flags Help.txt
            
        If you notice in the reference file (mentioned at the top of this section), each
        Group-Set gradually gets smaller.  TypeA has more access than TypeB, and so on.
        TypeS would be Super-Admin, and TypePublic would be all the rest of the regular
        players in the game.  Notice also how the Public Group only has access to a few
        Vote Commands, which could also be removed!


      Admins:
      ------
        Admins must be registered with both: AMXX and UAIO.

        For reference: there are 4 default admins already registered for you!
        They can be found in: /cstrike/addons/amxmodx/configs/uaio/uaio_admins.ini


        For AMXX, all you need is flag 'n' set in users.ini for each Admin you want 
            to give Access to UAIO.
            If an admin does NOT have flag 'n', then they will only have Public Access
            as set by the TypePublic Groups.
            Super-Admins should have flags 'mn' set in users.ini, which will give access
            to UAIO Debug Commands as well as the ability to turn the Whole Plugin On/Off
            from the console In-Game! Other Commands still rely on the Admins Groups.

        For UAIO, you must edit /cstrike/addons/amxmodx/configs/uaio/uaio_admins.ini
            and add each Admin to UAIO with their SteamID and 4 Groups.

          Example:

     admin      "1857286"       "grp_vote_typeS grp_good_typeS grp_evil_typeS grp_misc_typeS"

        Well spaced so you can see the 3 different sections.
        - The first part simply indicates to the plugin that this line is an Admin. DO NOT CHANGE IT!
        - The second part is the Admins SteamID excluding the 'STEAM_0:0:' or 'STEAM_0:1:'
            portion. Only the Unique Number portion is required.
            (Note: IPs may also be used -- Excluding Port)
        - The third part is the name of 4 Groups to which this particular Admin belongs, and
            are seperated by a single space.  (These Groups are mentioned above)
            The 4 Groups MUST be one of each Command-Type: vote, good, evil, misc.
            And if you will notice, each Group in the example above is the name of a Group with
            each one pertaining to one of the 4 Command-Types.
            

        If you notice in the reference file (mentioned at the top of this section), there
        are some admins already registered:

        The first one is my (xeroblood) SteamID registered as a Super-Admin! However,
           if an admin has No Access to AMXX (not registered in users.ini) then nor do
           they have Access to UAIO (other than the Public Access), no matter how they are
           registered in UAIO.  So make sure to setup both when adding Admins!

        The Next 2 are your SteamID when running a Listen Server from your own PC.

        And last is the "Default" admin (which is for all regular players) and MUST NOT BE
           REMOVED!  However, the groups may point to empty command flags, meaning no-access.


        NOTE: When assigning an Admin with Groups, each Admin MUST have 1 Group of each
              Command-Type, with a total of 4 Groups.

   -------------------------------------------------------------------------------------------
   Customize UAIO with CVARs:
   -------------------------------------------------------------------------------------------

      Now, for the Final (and optional) part of the Setup for UAIO is the CVARs!
      CVARs are 'Configuration Variables' are do exactly as the name suggests: Configure!

      The CVARs for UAIO can be found in cstrike/uaio_config.cfg

      CVARs can be added in a number of ways, but just one way will do, so I will list some
        options, and you decide what you want to do:

      1. Copy & Paste the UAIO CVARs into your /cstrike/addons/amxmodx/configs/amxx.cfg file.

      2. Copy & Paste the UAIO CVARs into your /cstrike/server.cfg file.
         (or alternatively for ListenServers, into your /cstrike/listenserver.cfg file)

      3. Add a single line to your /cstrike/server.cfg file containing:
          exec uaio_config.cfg


      NOTE: For the CVARs that have a value of: "0 15 30 60 90 120 300 600 900"
            These CVARs represent a Time Duration in Seconds.
            0 Turns the command OFF, all others turn the comamnd ON for the specified
            Time Duration.

            To have a duration last as long as the map, simply multiply your map time by 60
            and use the resulting number as your Max Time Duration.
            Example: If your map timer is set to 45 minutes, then you could alter the CVAR to:
            "0 15 30 60 90 120 300 600 2700"

   -------------------------------------------------------------------------------------------
   Credits:
   -------------------------------------------------------------------------------------------
      
     UAIO Admin Manager:                  $uicid3
       -- Seperate Plugin; uaio_manager.sma   (Comes Packaged with UAIO)

     HLDS Server Hosting & Debugging:     RAD Clan, Mad Dog (v3x), $uicid3, Abhishek,
                                          GodLike

     Ideas & Testing:                     Mad Dog (v3x), $uicid3, Abhishek, GodLike,
                                          WillZ, FaDe, MattCook

     Bug Fixes:                           jtp10181

     Code Samples From:
       - Diving Kit                       AssKicR, Lazy
       - Sunglasses, Poison               AssKicR
       - Fire, Human-Rocket               f117bomb
       - Buy Locker                       AssKicR, Scarzzurs
       - Player Trails                    Lazy
       - Grenade Trails                   AssKicR
       - Drugs                            Twilight Suzuka
       - Crazy Crosshair                  Mad Dog (v3x)
       - Nade Drops                       VEN

     Language Translations:
       - Dutch:                           Proach
       - Swedish:                         [ --<-@ ] Black Rose

     Special Thanks to:
       The AMX Mod X Development Team!     <-- Visit: http://www.amxmodx.org
       The Original AMX Mod Developers!    <-- Visit: http://www.amxmod.net

   -------------------------------------------------------------------------------------------
    Enjoy! :D
   -------------------------------------------------------------------------------------------