Title    : Brutal_Battle Server Patch
Filename : brutalsrv10.zip
Version  : 1.0
Date     : 14 Apr 1997
Author   : Dr. Banzai
Email    : phosk@tesla.uah.ualberta.ca
IRC      : Dr_Banzai
           

Type of Mod
-----------
Quake C  : yes
Sound    : no
MDL      : no
BSP      : no

Category : Server Patch

Source Included :  yes

Introduction
------------

This is a great, original server patch which I have been 
running on my server for some time. It provides for 
enhanced deathmatch and teamplay Quake, and adds new 
features and weapons.

Note that this patch is server-only, so clients do not
have to download a .PAK file to play on a server that
is running this.

New features include:

Runes
	The Runes are from Capture the Flag by
	Dave "Zoid" Kirsch. The runes include
	Haste, Regeneration, Strength and Resistance.	
Grappling Hook
	This is also from CTF. You can hook onto
	walls and ceilings, and the hook will pull
	you up. You can also hook onto other players
	to disembowel them.
MOTD
	This is yet another feature from CTF. It
	provides a startup message which is displayed
	to all clients when they connect to the server.
Boobytraps
	These are very interesting. They are based off
	of a small amount of code I got off the net.
	I have enhanced them greatly. A player can lay
	either Rocket traps, or Napalm traps. Rocket
	traps take 20 rockets. The trap looks exactly
	like a regular box of rocket ammo. An opponent
	touches the trap and BOOM! it explodes, severely
	damaging or killing the victim. Napalm traps
	take 150 nails. Upon detonation, the trap will
	engulf the victim in flames. The flames will
	keep burning, sucking health away, until the
	player jumps in some water or gets armor.
	Booby traps are a blast!
BlazeGun
	This is a patch by Nelno the Amoeba which I 
	have integrated into this server patch. It 
	converts the nailgun into a flamethrower, 
	with which players can set others on fire!
	The burning players will have to find water
	or armor to extinguish the flames. One can
	also use the BlazeGun to fly upwards. Just
	point down and shoot!
Random Map Chooser
	This code is from the "randmap" patch
	by Stefan Schwoon. When the timelimit
	or fraglimit expires, the server will pick
	a new level randomly. This adds an element
	of surprise when a new level is chosen.
Voting
	This patch works with the Random Map
	Chooser. I wrote the code for it. With
	it, players can input an impulse to 
	vote for a new level. When over 50% of
	players have voted, a new level is
	automatically selected and the server
	changes to it. This is especially useful
	when the server changes to a large level
	when there are only 3-4 people on.
Remote Administration
	This is a patch by Doug Keegan which 
	allows server administrators to change
	game settings and levels while connected
	as a client. The player simply enters
	an impulse sequence to be verified as
	an administrator, then they have full
	access to all functions including:
		Changing to any level
		Changing the fraglimit/timelimit
		Setting the deathmatch/teamplay variables
		Altering gravity and friction
		Kicking players

There are also countless tweaks and optimizations
to make this patch a blast in Deathmatch, from
two to sixteen players.

To preview this patch, just hop on to my server at
129.128.109.135 (tesla.uah.ualberta.ca).

Installation
------------

Unzip the contents of brutalsrv10.zip into a dir
under the Quake dir (for example, "QUAKE\BRUTAL").
If you are using PKUNZIP, be sure to use the -d
paramater.

The source is placed in the "SRC" dir. The progs.dat
and text files are placed in the "BRUTAL" dir (or 
whatever name you chose).

Please read the entire text of this document if
you plan on including this patch on your server.

Servers should set "noexit 1" and "samelevel -1"
for maximum enjoyment of the features included
in this patch.

If you are using this patch on your server, be sure
to change the Admin password. To change it, just
edit "admin.qc" and put your three-impulse sequence
in where it says "// Put Password Here". The default
is 164, 56, 145. 

Also open the file "maplist.qc" and put in the
maps you want the server to choose from. There is
a maximum of 26 map files per Group.

You will then need to recompile the
source using QCC. QCC is available from:

ftp.cdrom.com/pub/idgames2/quakec/utils

I assume you know how to use new quake-c patches 
on your server. If you run a server and want to 
know how to put new patches on it, mail me at:
phosk@tesla.uah.ualberta.ca

Please mail me comments, requests for new features
and questions about this patch. Also give me a mail
if you include this patch on your server, so I can
check out the action.


Impulses
---------

There are no impulses which the players need
to know. The MOTD tells the players how to
use traps, voting and the grapple. The grapple
can be selected by selecting the axe twice,
while the traps can be used by simply pressing
0 or 9.

Administrator Impulses

	Please refer to the above section on how
	to set up your password. You can only
	use admin commands if you have been verified
	by using the password.

	Impulse 99	Show menu of all impulses

	All other impulses should be self-explanatory
	from looking at the menu.

	I have included "admin.txt" for people wishing
	for more in-depth information on the administration
	function.

Player impulses

	Impulse 20	Select Grapple

	Impulse 100	Register vote
	Impulse 101	Check voting status

	Impulse 120	Lay Rocket trap
	Impulse 121	Lay Napalm trap

The code will auto-bind "0" (The number) for
setting Rocket traps, and "9" for setting napalm
traps. This auto-binding will occur when a player
joins the server. The MOTD, displayed a few seconds
after they join, explains how to use all the above
functions.


Notes on the source code
-------------------------

Every piece of new code in this patch is surrounded
by these indicators:

// HKCSRV START: 

< ... New code ... >

// HKCSRV END

Any code that has been modified will usually be in
this format:

< ... Modified code ... >	// HKCSRV: Modified: 

In any case, you may find all new and changed code
by searching for the string "HKCSRV".


Known bugs
----------

None

Copyright and Distribution Permissions
--------------------------------------

You may alter this code for use on your own
server only.

You may modify the source code and redistribute
altered versions of this patch, as long as you
ask for permission from me and from everyone who 
has written code which is included in this patch.
You must also include this text file, unaltered,
and all of the source code in the new distribution.
For a list of people who's code I have integrated
into this patch, see below.

You may not sell this patch under any circumstances.


External code (code not written by me)
--------------------------------------

Runes, Grappling Hook and MOTD
  Author: Dave "Zoid" Kirsch
  E-Mail: zoid@threewave.com

Blazegun
  Author: Nelno the Amoeba
  E-Mail: nelno@ionstorm.com

Random Map Chooser
  Author: Stefan Schwoon
  E-Mail: ssch0098@rz.uni-hildesheim.de

Remote Administration
  Author: Doug Keegan
  E-Mail: doug.keegan@tamu.edu


Revision History
----------------

1.0 - Initial Release.