			Admin MOD for Halflife
			       v2.0x
			
				By

		Alfred Reynolds <alfred@mazuma.net.au>


Introduction
---------------
              This mod will let you give people access to your servers,
without giving access to rcon. It also lets you define users who can access
the server, each with a different password. It will plug-in to the
following mods:
      Phineas (v0.21) :         The normal Half-Life mod with bots!
      Firearms rc2.4:             If you haven't played it you must!

      Golden Eye 1.7:          You loved it on the N64, now its on
                                the pc!
      Counter-Strike
      (1.0) :             The cool counter terrorist mod
      Action Half-Life :        (untested)
      Freeze :                  (untested)                 
      Bot :                     (untested)
      TFC (v1.1.0.4) :          The Oh High-N-Mighty Team Fortress
      Valve (v1.1.0.4) :        The standard Half-Life death match
      Oz (v1.7) :               Extended death match
      Svencoop (1.3):           The multiplayer masterpiece (wonder why...)
      Arg! (1.0)
      Wizard Wars (beta 2)
      Gangstawars (beta 2.5)
      Frontline Forces (1.1)
      Science And Industry (beta 0.96)
      Swarm (2.1.0.4)
      

	Others :                  You tell me if it works, it shouldn't
                                
      (NOTE - If you are a mod author contact me so I can add support for 
your mod, its easy to do).          


Installation
______________

For Linux
	
	1) Unzip the file into the halflife directory (i.e /home/halflife/ ).
	2) Go into the admin directory and run "./install_admin <mod name>"
 Where <mod name> is the name of the mod you want to install admin mod into.

	3) Read the admin/docs/admin_mod_config.txt.
	4) Read the admin/docs/admin_mod_faq.txt.                          
	5) Go to the forums at http://www.adminmod.org/.


For Win32

	1) Unzip the file into the halflife directory (i.e c:\sierra\half-life) .
	2) Go into the admin directory (via explorer of such like )
      and double click on "install_admin.vbs"	
     When it asks for the mod name type in the directory of the mod you want to
    install into (i.e cstrike);

	3) Read the admin/docs/admin_mod_config.txt.
	4) Read the admin/docs/admin_mod_faq.txt.                     
	5) Go to the forums at http://www.adminmod.org/.


	
Samples of the requied configuration files can be found in 
admin/samples.

 The various admin mod commands are detailed in 
admin/docs/admin_mod_commands.txt.


Scripting
-------------

The commands in admin mod, and the periodic stuff is all controlled by a scripting 
engine. There are two parts to the scripting, compiling the script and then
running it in admin mod. 
The scripting engine is called Small and can be found at:
http://www.compuphase.com/small.htm

That page has a good description of the language. 
Next, read admin/docs/admin_mod_scripting.txt for a list of admin mod functions.
Then, look at admin.sma for a source to the current commands in admin mod.
Once you have this worked out, change the source so it does what you want.

Then, compile is using sc (or sc.exe) with the command
..\compiler\sc -i..\include admin.sma  (this is for win32, for linux flip the \)

This produces an admin.amx. Now copy the admin.amx to your mods dlls/ directory
as admin_win32.amx (or admin_linux.amx for linux) and fire up the server 
and test :)
Rinse and repeat until you get the desired results.

( ****** NOTE - This needs to be flesh out ******** )
( ***** Double NOTE - linux and windows admin.amx files ARE DIFFERENT, You
MUST recompile for each platform. Its the same source code file, just
slightly different binaries ********)


Credits
__________

These people have really helped admin mod become what is it today:

Botman for writing the loader code and comming up with the ENTITY
                  workaround :) 
Teflon for the great website. 
hlds_l mailing list for letting me bounce ideas off them. 
"Simon Garner" for chasing down o so many bugs. 
M.R. van Schouwen for a couple bug fixes 
Rod May, ip and reserve_slot stuff 
Kemal Hadimli , mysql stuff 
Jason for getting me to include a scripting engine 
them@clanwho.com for parts of the admin.sma script
Jaguar (<magua@wedgewood.net>) for the new script functions





















Nothing to see here. Move on.

(C) Alfred Reynolds 2000

Last updated: 7/Dec/2000
