

			Admin MOD for Halflife
			       v2.50.09
                October 24, 2001
			
				 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:

(Note that some of the mods listed may have changed versions or been updated 
since this list was last updated, and therefore may not be completely 
compatible. Also  note that there may be mods that are not list which Admin 
Mod will work with)

  Judgement
  FireArms rc2.5
  DoD 1.1
  DeathMatch Classic mod (Valve) v1
  Phineas (v0.21): The normal Half-Life mod with bots ! 
  Golden Eye (1.7): You loved it on the N64, now its on the PC! 
  Counter-Strike (1.1): The cool counter terrorist mod 
  Action Half-Life:  (beta 4) 
  Freeze:  (untested) 
  Botman
  TFC (v1.1.0.6):
  Valve (v1.1.0.6): The standard Half-Life death match 
  Oz (v1.7): Extended death match 
  SvenCoop (v1.3): You have to try this 
  Science and Industry (v0.96):  A unique idea with a great execution.  
  Front Line Force (v1.1):  Join the battle on the front lines.  
  WizardWars (beta 2):  Zap, kapowi, spin up a spell.  
  GangstaWars (beta 2.5):  Become the don!  
  Arg! (one):  Become a pirate!  
  Swarm (2.1.0.4):     Buzz?
  Opposing Force:  Bang?
  Global Warfare
  Jailbreak
  Paintball
  Valve
  Vampire Slayer
  Wasteland

  Others: (Tell us if it works - or if it doesn't)

(NOTE - If you are a mod author contact Will at http://www.metamod.org 
so he can add support for your mod, its easy to do. He will need a complete
list of the game's entities)          


Installation
______________

For Linux
	
	1) Unzip the file into the halflife directory 
           (e.g /usr/local/games/hlds_l ).
	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) Go to the forums at http://www.adminmod.org/ if you need help
           or want to participate in the community there.


For Win32

      Documentatio is located it the Admin\docu directory: 
      Launch/run the index.htm file in the admin/docu/html directory and 
      follow the instructions inside. Or read the PDF file contained in the 
      admin/docu directory. A windows help file is also available.

	
Samples of the required configuration files can be found in:
     
     Admin/config/
     Admin/config/samples.

The various Admin Mod documentation files are in: 

     Admin/docs/


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

A more complete scripting tutorial and primer can be found in the
admin mod documentation. Here is some basic scripting information:

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 the manual or http://www.adminmod.org/ascript/ 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 and fire up the server and test :)

Rinse and repeat until you get the desired results.

( ***** 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
  Jaegermeister for the web design
  Jon Paul Nollmann for mysql stuff

Here's the crew that brought you Admin Mod 2.50 ...

The core team in no particular order:

  Alfred Reynolds  (CEO)  (Alfred)
  Magua  (Admin Mod Man of Mystery)  (Jaguar)
  Florian Zschocke  (Head of Operations and Coding)  (Da Rope)
  Greg Hughes  (Borg Communications Officer and Documentation Guy)  (Gerg)
  Scott Brownlow  (Keeper of the Scripts)  ([fah-q] Dio)
  Will Day  (He who brought us Metamod)  (WillD)
  Karel Verbiest  (what was it he does?)  (KaReL)
  Gerald Mahlmeister  (The Scripting Pro in the Background)  (Ramirez)
  David Mart (Installer and VBS Genius) (Wraith,)
  Pieter de Zwart (Scripter and Docs Helper) (Bud-froggy)
  Chad Ness  (Aspiring Jungle Cat and Pathetic Sorcerer of the Good)  (yensid)


And then our beta testers who risked their servers to see if it worked:

  Luke Sankey  (experiments and finds them bugs)  (Sank)
  John Bossaller  (our Linux beta tester)  (GeSpot)
  Tim K.  (tested DoD support)  (thetoulman)
  Sparks  (Server op and buddy to Dio)  ([fah-q] Sparks)
  Lee C.S. Young (man, he's got servers) (Scoutn)

and of course...

  The Forgotten Helper 


Thanks to all who contributed by finding bugs and making suggestions.



Nothing to see here. Move on.

(C) Alfred Reynolds 2000,2001

Last updated: 15/Jun/2001
