                                 QTeam 1.00


Author :       Gary Griggs (ggriggs@gis.net)
Release Date : 8/16/96
Description:   QTeam is an QuakeC addon that provides an additional teamplay
               option that supports restricted team colors, friendly fire, 
               and team scoring.

             
Details:

   * Installing the patch

     To install the code create a directory named qteam under the main quake
     directory and copy the progs.dat from the QTeam archive there. The patch
     only needs to be installed on the server side; none of the client 
     machines need the patch installed.

   * Starting QTeam play

     1) Set teamplay=2  
     2) Set temp1 to the maximum number of teams.
        The default value is 2 and the maximum is 8.
     3) Start a new deathmatch game

     The maximum number of teams and teamplay mode cannot be changed 
     during a game. 

     If teamplay is not 2 or the game is not set for deathmatch, none
     of the QTeam enhancements will be active.

     Here's an example of how a QTeam game can be started from the command
     prompt. This example will start up a dedicated server that runs 
     the QTeam enhancements, allows a maximum of 16 players, allows a 
     maximum of 4 teams, and uses old deathmatch mode.

          quake -dedicated 16 -game qteam +hostname "QTeam" +deathmatch 2 
             +teamplay 2 +temp1 4 +map e1m1


   * Ghost Morons - The limbo state
 
     Players initially start out as Ghost Morons, a limbo state in which they
     cannot harm other players, cannot be harmed, cannot pick up objects,
     float around instead of normal walking/running, and  cannot open doors
     or pass through teleporters. Ghost Morons get fragged every thirty
     seconds if they don't create or join a team. Ghost Morons appear in
     white but they are not considered a team. 


   * Creating a new team

     Players create a new team by typing in the command create_team from the
     console or using the color command to select a color not in use.  
     the create_team command is preferred however since color selection for
     new teams is automatically chosen based on available colors and a color
     ranking. This allows for teams that stand out as much as possible.

   * Joining an existing team

     Players join an existing team by typing one of the following commands:
          join_red - Join the red team
          join_blue - Join the blue team
          join_yellow - Join the yellow team
          join_green - Join the green team
          join_purple - Join the purple team
          join_brown - Join the brown team
          join_gold - Join the gold team
          join_lblue - Join the light blue team
 
     The color command can also be used if the color specified is that of an
     existing team. The join_* commands are the recommended method of joining
     a team.

   * Scoring

     Team scores are displayed on the status bar and in the rankings screen. 
     Due to current defiencies in the interface to or this programmer's 
     current knowledge of the Quake engine, there are some oddities in the
     way team scores are displayed. Only one player per team maintains the
     team score and all other players on the team display -99.

     Players lose their individual frags when they change teams. The new team 
     does not incorporate the new player's old score but the old team does 
     have that player's invidual frag count removed. This means the old
     team's score may remain the same (if old player's individual score was
     0), increase (if old player's individual score was negative), or
     decrease (if old player's individual score was positive). The individual
     frag count for a player is displayed when he/she changes teams.

     Teams lose a frag when a team member is killed by friendly fire. The 
     killer's individual frag count is decreased by one.

     Individual scores for all players in the game (this does not include
     Ghost Morons) can be viewed by using the alias dump_iscores. 

   * Using fraglimit to end the game 
 
     The game will end if fraglimit is set and the team reaches the limit. 
     One player's individual count may exceed the limit without the game
     ending if other team member's individual score is negative thus driving
     down the team total below fraglimit.


Known problems :

     * Everyone reverts to Ghost Morons when the level changes.
     * Ghost Morons can telefrag players but noone receives points for this.
       Bad habits should not be rewarded!

Credits :
	QA    - A special thanks to duke, metal, and giggler for their help in
            running some of the less appealing tests. 
	Code  - Kevin Bowen for a coding idea from his QVote program
	Bugs  - Mine, all mine!

Reporting problems or requesting enhancements :

	Please contact me via email at ggriggs@gis.net 




 
