shrub mod

=================================================================
shrub mod for Return to Castle Wolfenstein 1.33
-----------------------------------------------------------------
Version 2.04.2b, released 7/14/02
by shrub - cmannion@earthlink.net

http://www.udpviper.com/shrubmod/
=================================================================

YOU MUST READ AND AGREE TO THE TERMS OF THE LICENSE IN SECTION 7 BEFORE USING
THE INCLUDED .DLL OR .SO FILE.  IT'S VERY REASONABLE, AND I THINK YOU'LL AGREE.

Note that this *is* a beta release, and I would appreciate any and all bug
reports you have.

This mod has been renamed to simply "shrub mod", as it is clear that its
usefulness has expanded well beyond OLTL servers.

What does this mod do?  To put it simply, I designed it primarily to give admins
increased control over every aspect of gameplay so that they may craft a unique
form of playing.  These controls include how points are assigned, what weapons
are allowed, what kind of actions are permissible, and how various in-game
objects are handled.  Second are conveniences for the player, including such
functions as shoving other players out of the way, comprehensive statistics,
automated reminders based on team composition, automated recommendations of
who should revive (which medic is closest) and who to give ammo to (who has the
greatest need, while factoring in distance from the LT), and more!

This mod is completely server-side.  The beauty of it is that it requires no
client downloads whatsoever.

Since there are so many customizable features in this mod, I have set the
variables to a default setting that I think would be a great foundation to start
from.  Details on what these default settings are can be found in Section 2:
Installation.

As always, I'm open to suggestions!  I can be reached at the email address above
or on irc.enterthegame.com as "shrub".

Want to see this mod in action?  Connect your RTCW to jester.udpviper.com:27960!
Also check out www.udpviper.com for chmod's new RTCW stats engine.

Contents of this Document:
  1. Revision History
  2. Installation
  3. Acknowledgements
  4. Command Summary
  5. Features
  6. Known Bugs
  7. License

=================================================================
1. REVISION HISTORY
=================================================================
Beta 2.04.2 - released 7/14/02
  - g_shove now defaults to 1
  - g_legDamage now defaults to 0

Beta 2.04.1 - released 7/13/02
  - changed way in which kill ratios are displayed
  - removed sarcastic remarks when player makes zero kills during life

Beta 2.04 - released 7/12/02
  - g_showTapOut now defaults to 0
  - renamed launch/throw/fling to launchn/thrown/flingn
  - added new launch/throw/fling that use clients' names
  - added g_allowLTF to disable launch/throw/fling and fun mode entirely
  - added friendly dynamite 5-second reminder g_dynaWarn
  - added g_medObjHeal to disallow medics self-healing when carrying objectives
  - enabled black text in names
  - added times killed and kill ratio to stats
  - silenced Medic and Need Ammo voice chats for fun mode
  - increased grenade and PF ammo given in fun mode
  - added round start ammo request penalty g_startAmmoPenalty
  - added leg shot speed reduction through g_legDamage
  - players can switch teams during warmup, regardless of g_maxlives

Beta 2.03 - released 7/06/02
  - added LT ammo distribution prioritizer
  - added no LT reminder
  - added g_lifeStats to toggle limbo displaying stats during life or round
  - added g_lockSpecs to keep spectators static and pointed up
  - added back team-switch anti-spam code with 5 second delay instead of 30
  - added g_flagWins to remove checkpoint flags
  - added location of downed player to medic reminders
  - added g_LTShootPenaltyRange to allow customization of enemy detection
  - increased default range of enemy detection for LT Shoot Penalty
  - fixed bug involving medic reminders detecting spectating medics
  - fixed bug involving last kill of the game not being counted in stats
  - added a number of cVars to customize bonus point values
  - added g_allowVenom to allow/disallow venom guns
  - added g_allowFlamer to allow/disallow flamethrowers
  - added g_allowMauser to allow/disallow mausers
  - helmet protection is now customizable (g_helmetProtects, g_helmetDamage)
  - fixed bug where late joiners in limited life games would still spawn
  - added g_showRevives to print revives in console
  - a player is no longer late join killed if only player on server
  - added g_teamCountConsole to enable/disable team counts in console
  - gib points can now be toggled with g_gibPoints
  - gib reporting can now be toggled with g_reportGibs
  - added g_logStats to print stats in server log at end of round
  - added g_showTapOut to disable "tapped out into limbo" messages

Beta 2.02 - released 7/02/02
  - added medic reminders
  - LT damage return now disabled when enemy is nearby
  - changed touch-gibbing to use id's new g_knifeonly code to remove weapons
  - spectators can talk to non-specs (cvar toggled, default off)
  - fixed minor spacing issue in the "tapped out" limbo message
  - ammo packs now add pistol ammo (cvar toggled)
  - changed how late joins are logged
  - now tracking team kills, gibs, team gibs, ammo & health given, head shots
  - print stats in console at end of round for each player
  - added cvar to log stats
  - Axis/Allies left reporting now cvar toggled
  - Axis/Allies left decreased frequency of reminders
  - launch/throw no longer work when someone is dead or spectating
  - added server-side command "fling"
  - added client-side command "stats"
  - added server cvar to disable corpse sinking
  - fixed bug where specs' stats would be displayed to someone else
  - fixed bug involving specs switching who they're following
  - fixed bug involving late joiners respawning in OLTL games
  - added distance function to debug mode
  - added range function to debug mode
  - added no medic reminder
  - added client-side command "classes"

Beta 2.01 - released 6/30/02
  - suicides (/kill) are explicitly reported in server log as such
  - fixed bug where self-initiate limbos would be counted as gibs by whoever
    last killed you
  - fixed bug where those joining during warmup would be late-join killed
  - decreased spawnguns to 1-10 guns (was 1-25)
  - decreased spawnnades to 10 nades (was 40)
  - added headshot detection to debug mode (debug mode is undocumented)
  - allow ammo pack syringes to be enabled/disabled by a server cvar

Beta 2.0 - released 6/29/02
  - Updated for RTCW 1.33 code
  - Added grenade shower
  - Inactivity drop won't apply to fallen
  - Added give grenades on demand for g_fun mode
  - Fixed bug with giving health on demand (could revive self)
  - /spawnGun renamed to /spawnGuns
  - Fixed spawnGuns/spawnNades spam exploit (server could crash when it exceeds
    max entities)
  - Added global debug cvar
  - Added touch-gib mode

* Changes prior to 2.0 were not documented

=================================================================
2. INSTALLATION
=================================================================
Windows:
  - Create a folder "shrubmod" inside your Return to Castle Wolfenstein Folder
    e.g. C:Program FilesReturn to Castle Wolfensteinshrubmod
  - Extract "qagame_mp_x86.dll" into this folder
  - Run RTCW with the flag "+set fs_game shrubmod"
    (create a shortcut to RTCW, right click on it and select "Properties", and
     in the "Target" box, add " +set fs_game shrubmod" at the end)

Linux:
  - Create a directory "shrubmod" in your RTCW directory
    e.g. "/usr/local/games/wolfenstein/shrubmod"
  - Extract qagamei386.so into this directory
  - Run RTCW with the flag "+set fs_game shrubmod"

If these directions aren't clear, you probably shouldn't be running a server!

QUICK SUMMARY FOR THE IMPATIENT
The default settings make the following major changes to gameplay:
  - Ammo packs give pistol ammo to all and one syringe to medics
  - Panzerfausts are disabled
  - Late joiners (15 seconds after round start) are automatically killed in
    limited or one-life games
  - Helmets protect players from their first head shot, giving them only 5
    damage, except in the case of a sniper, which still gives full damage
  - If a player calls for ammo and shoots a friendly LT within 2 seconds later,
    that damage is also returned to the player, unless there is an enemy nearby
  - The number of players on each team that still have respawns left is
    displayed when those figures change in limited or one-life games
  - Gibs (when a player can no longer be revived) are recorded in console
  - Players receive point bonuses or reductions for gibbing or team gibbing
  - When LTs say "I'm a Lieutenant", they are told who the best person to give
    ammo to is and his location
  - When a player dies, the nearest medic is asked to revive the fallen player
    and is given the appropriate location
  - If there are no medics alive on a team, a fallen player is told such
  - If there are no LTs alive on a team, a player who requests ammo is told such
  - Players receive statistics on a per-life basis when they limbo, and
    statistics for the entire round when the round ends
  - Players can access their round statistics at any time by using /stats
  - Players can use /classes to see how many of each class are left on a team
  - Players are notified 5 seconds before a friendly dynamite explodes nearby
  - Players can shove each other using +salute.  The default settings are just
    enough to allow players to shove someone out of a doorway.

Of course, there are many other features that can be selectively enabled, but
you'll need to read the rest of this file to find out what they are.

=================================================================
3. ACKNOWLEDGEMENTS (In alphabetical order)
=================================================================
Thank you to chmod 700 for his contributions to this project.

The following people helped in testing and/or contributed ideas or bug reports:
  2.01 and prior: D6M14, EvilOne, Glocksmith, Leviathan, Liquidity, logosmani,
    Mr. Underhill, Phreylan, pure
  2.02: Bishop, BluNereid, Dima
  2.03: Bishop, Glocksmith, HappyG, Infinite, KingFlea, PizDets, Reflexion
  2.04: Reflexion

Thank you to The Quark, who originally ran his own mod for 1.31 featuring gib
reporting/points, axis/allies left, and late join killing.

=================================================================
4. COMMAND SUMMARY
=================================================================
Server-Side cVars
  Name		     Default	Function
  g_allowFlamer		1	allow/disallow flamethrowers
  g_allowLateJoins	1	allow/disallow late joins
  g_allowLTF		1	allow/disallow launch/throw/fling/fun mode
  g_lateJoinTime	15	time after round start when one is late
  g_allowPF		0	allow/disallow panzerfausts
  g_allowSpecChat	0	turn on/off spec chat to non-specs
  g_allowStartVotes	1	allow/disallow map-starting votes
  g_maxStartVotes	3	# of attempts allowed before player is kicked
  g_allowVenom		1	allow/disallow venom gun
  g_ammoGivesSyringes	1	turn on/off syringes in ammo packs
  g_ammoGivesPistol	1	turn on/off pistol rounds in ammo packs
  g_dynaWarn		1	turn on/off 5-second dynamite warnings
  g_flagPoints		0	allow/disallow flag points
  g_flagWins		1	enable/disable checkpoint flag wins
  g_fun			0	turn fun mode on/off
  g_gibPoints		1	enable/disable gib points
  g_helmetProtects	1	turn on/off helmet protection
  g_helmetDamage	5	amount of damage first head shot takes
  g_legDamage		0	turn on/off leg shot speed reduction
  g_legDmgTime		300	duration (in ms) of initial speed reduction
  g_legDmgAmount	2	speed reduction constant
  g_lockSpecs		0	turn on/off spectator locking
  g_logStats		1	log round stats enable/disable
  g_lifeStats		1	use life stats (1) or round stats (0)
  g_medObjHeal		1	turn on/off medic self-healing when carrying obj
  g_reportGibs		1 	enable/disable gib reporting
  g_shootLTPenalty	1	turn LT damage return on/off
  g_shootLTPenaltyRange 1200	enemy detection range
  g_shootLTPenaltyTime	2	amount of time LT penalty applies
  g_shove		1	turn shoving on/off
  g_shoveAmount		80	amount of shove to apply
  g_shoveNoZ		1	turn z-axis shoving on/off (1 means off)
  g_showRevives		0	turn on/off printing revives in console
  g_showStats		1	turn limbo stats on/off
  g_showTapOut		0	turn on/off "tapped out into limbo" messages
  g_showTeamCount	1	turn team left reporting on/off
  g_startAmmoPenalty	1	turn on/off round start ammo request penalty
  g_teamCountConsole	1	enable/disable team counts in console
  g_sinkCorpses		1	turn on/off corpse sinking (g_maxlives 1 only)
  g_touchgib		0	turn touch gibbing on/off (map_restart after 1)

Server-Side cVars to customize point bonuses
  g_stealObjBonus	10	bonus for stealing objective
  g_captureObjBonus	15	default bonus for capturing objective
  g_killCarrierBonus	10	bonus for killing objective carrier
  g_secureObjBonus	10	bonus for securing objective from slain carrier
  g_plantBonus		5	bonus for planting dynamite at objective
  g_diffuseBonus	5	bonus for diffusing dynamite
  g_destObjBonus*	-1	bonus for destroying objective with dynamite
  g_capBlueObjBonus*	-1	bonus for capturing allied objective
  g_capRedObjBonus*	-1	bonus for capturing axis objective

  * These three bonuses are special in that the points given are specified in
    the map.  To use the map's default values, set these cVars to -1.  Anything
    above or below -1 will override the map's default values.

Server-Side Commands
  Name				Function
  launch <clientnumber>		Launch <clientnumber>
  throw <clientnumber>		Throw <clientnumber>
  fling <clientnumber>		Fling <clientnumber>
  launch <clientname>		Launch <clientname>
  throw <clientname>		Throw <clientname>
  fling <clientname>		Fling <clientname>
  cancelvote			Cancel vote

Client-Side Commands
  Name				Function
  +salute			Shove player (g_shove must be 1)
  spawnGuns			drop 1-10 random guns (g_fun must be 1)
  spawnNades			nade shower (g_fun must be 1)
  stats				display stats in console
  classes			display number of each class on your team

=================================================================
5. FEATURES
=================================================================

SHOVING
-----------------------------------------------------------------
Cvars:
  g_shove		default: 1	turn shoving on/off
  g_shoveAmount		default: 80	amount of shove to apply
  g_shoveNoZ		default: 1	turn z-axis shoving on/off (1 means off)

Commands (client-side):
  +salute

When g_shove is on (1), players can shove each other using +salute.  For example,
players may "/bind mouse2 +salute" in the console.  Shoving will push the player
they are pointing at an amount proportional to g_shoveAmount.  Players can
crouch and look up to give some lift to their shove force, but only if
g_shoveNoZ is off (0).  This feature is useful for use against players who are
blocking doorways or other key areas.  You can also have fun with it by turning
g_shoveNoZ off (0) and increasing g_shoveAmount to something greater, e.g. 300.
I'd recommend playing catch: one player stands on another, the bottom player
shoves upwards and tries to catch the launched player.


TOUCH GIB
-----------------------------------------------------------------
Cvars:
  g_touchgib		default: 0	turn touch gibbing on/off

When g_touchgib is on (1), players can gib others instantly by merely touching.
Weapons are disabled, so a map_restart is recommended after setting g_touchgib
to 1 in order to clear weapons from the game.  After map_restart, touch gibbing
is enabled 10 seconds after the map is restarted to allow time for players to
disperse.  If players are facing each other when they touch, there is a high
probability that they will gib each other.

Note: This is much more fun when respawn times are removed.  To do this, use:
  g_useralliedrespawntime 1
  g_useraxisrespawntime 1
To reset respawn times, set them both to 0.


STATISTICS
-----------------------------------------------------------------
Cvars:
  g_showStats		default: 1	turn limbo stats on/off
  g_logStats		default: 1	log round stats enable/disable
  g_lifeStats		default: 1	use life stats (1) or round stats (0)

Commands (client-side):
  stats

When g_showStats is on (1), upon entering limbo mode, players will be shown the
number of kills and revives (if applicable) they made during that life.
Additionally, the accuracy percentage (shots landed / shots fired) of any bullet
weapons used is displayed.  Note that accuracy is still displayed for flamers
since they have a pistol and the ability to switch to a venom, mauser, or SMG.

New for 2.02: Stats for the entire round (including team kills, gibs, team gibs,
shots fired, shots hit, head shots, ammo given, and health given, in addition to
the above stats) are now printed in the console at the end of the round for each
player.  This feature cannot be turned on/off.  Current stats for the round may
be viewed at any time using the client command "stats".

New for 2.03: There seems to be some confusion over the life stats that are
displayed during limbo.  These particular stats are reset whenever a player dies.
This, if a player kills someone, dies, is revived, dies again, and goes into
limbo, his stats will display zero kills since he died and did not kill anyone
after starting a new life by being respawned.  However, that kill still remains
counted in the round stats, which are displayed at the end of the round and
accessable any time with /stats.  With this in mind, if players do not prefer
life stats, admins now have the option of setting g_lifeStats to zero (0), which
will display the round stats during limbo.

When g_logStats is on (1), stats are sent to the server log at the end of the
round for all non-late joiners in the following format:

ENDROUND: <clientID>: <name>: <lastClass> <numKilled> <numTKed> <numGibbed>
          <numTGibbed> <numRevived> <healthGiven> <ammoGiven>
          <shotsFired> <shotsLanded> <headShotsLanded>

Note that lastClass can be either: 0 - Sold, 1 - Med, 2 - Engr, 3 - LT

New for 2.04: The number of times one has been killed and the kill ratio for
that round is now tracked and reported via /stats or the end-of-round stats.


LEG SHOT TEMPORARY SPEED REDUCTION - new for 2.04
-----------------------------------------------------------------
  g_legDamage		default: 0	turn on/off leg shot speed reduction
  g_legDmgTime		default: 300	duration (in ms) of initial speed
					reduction
  g_legDmgAmount	default: 2	speed reduction constant

When g_legDamage is on (1), a player's speed is temporarily reduced when shot in
the leg or foot.  The reduction in speed is proportional to the ratio of damage
taken to current health and the setting g_legDmgAmount.  The greater the value
of g_legDmgAmount, the greater the speed reduction.  The initial speed reduction
has a duration of g_legDmgTime milliseconds.  After that time has expired, the
speed begins to increase exponentially to the normal value.


AXIS/ALLIES LEFT
-----------------------------------------------------------------
Cvars:
  g_showTeamCount	default: 1	turn team left reporting on/off
  g_teamCountConsole	default: 1	enable/disable team counts in console

When g_teamLeft is on (1), when a player enters limbo mode, the number of axis
and allies left per team is displayed to every player in the center of his/her
screen.  These totals take into account who has respawns left, thus it is
particularly useful for OLTL play.  If g_maxlives is 0, this information is not
displayed, regardless of g_teamLeft.

New for 2.03: When g_teamCountConsole is off (0), team counts are not displayed
in the console.


ALLOW/DISALLOW SOLDIER GUNS
-----------------------------------------------------------------
Cvars:
  g_allowPF		default: 0	allow/disallow panzerfausts
  g_allowFlamer		default: 1	allow/disallow flamethrowers
  g_allowMauser		default: 1	allow/disallow mauser
  g_allowVenom		default: 1	allow/disallow venom gun

When g_allowPF is off (0), players will be unable to select the Panzerfaust as
their weapon.  If they attempt to, they are told that it is not allowed and are
automatically switched to their team's default SMG (Thompson or MP40).

New for 2.03: Flamethrowers, Mausers, Venoms can be selectively disabled using
g_allowFlamer, g_allowMauser, and g_allowVenom, respectively.  By default, those
three variables are on (1).


DISABLE MAP-STARTING VOTES
-----------------------------------------------------------------
Cvars:
  g_allowStartVotes	default: 1	allow/disallow map-starting votes
  g_maxStartVotes	default: 3	number of attempts allowed before player
					is kicked

When g_allowStartVotes is off (0), map-starting votes are disallowed.
Specifically, start_match and map_restart are not allowed at any time, and
reset_match is not allowed during warmup (so that reset_match can still be used
during actual round play in the event of a massive, intentional teamkill).  The
number of attempts to call a disallowed vote is tracked, and players are warned
not to call them after attempting to do so.  If the number of attempts meets or
exceeds g_maxStartVotes, the player is kicked.


DISALLOW LATE JOINS
-----------------------------------------------------------------
Cvars:
  g_allowLateJoins	default: 0	allow/disallow late joins
  g_lateJoinTime	default: 15	time after round start when one is late

If g_allowLateJoins is off (0), any players joining the game after
g_lateJoinTime seconds will be killed.  This method is preferrable to blocking
joins using other methods since it allows players to pick their team immediately,
without affecting gameplay.  Late joins are logged in the following format:

Late Joiner: <clientNum>: <clientName>


GIB REPORTING/GIB POINTS - new for 2.03: now configurable
-----------------------------------------------------------------
Cvars:
  g_reportGibs		default: 1 	enable/disable gib reporting
  g_gibPoints		default: 1	enable/disable gib points
  g_showTapOut		default: 0	turn on/off "tapped out into limbo" msgs

When g_reportGibs is on (1), player gibs (when someone transitions from being
revivable to limbo or directly from alive to limbo) are now reported in the
console and server log.  Team gibs are given a red-colored message to
distinguish themselves from enemy gibs.  Server logging of gibs occurs even when
g_reportGibs is off (0).
  FORMAT: Gib: <gibberClientID> <gibbedClientID>: <gibberName> gibbed
	  <gibbedName>

When g_gibPoints is on (1), players receive 1 point for gibbing an enemy and a 3
point deduction for gibbing teammates or gibbing himself.

When g_showTapOut is on (1), "tapped out into limbo" messages are displayed in
the console.


FUN MODE
-----------------------------------------------------------------
Cvars:
  g_fun			default: 0	turn fun mode on/off

When g_fun is on (1), the following applies:
  Commands:
    /spawnGuns	drop between 1 to 10 random guns near player
    /spawnNades	drop 10 nades randomly around player in a "nade shower" 

  Additional Features:
    Give Ammo on Demand - players are given one grenade and ammo for their
			  two-handed weapon when calling for ammo
    Give Health on Demand - players are given 20 health when calling for a medic

New for 2.04: Requests for ammo and health are silences when fun mode is on to
avoid flooding.  Grenades given and PF ammo given has also been increased.

g_allowLTF must also be on (1) for fun mode to be active.  g_allowLTF can only
be disabled in the command line (add "+set g_allowLTF 0" to the command).


LT DAMAGE RETURN
-----------------------------------------------------------------
Cvars:
  g_shootLTPenalty	default: 1	turn LT damage return on/off
  g_shootLTPenaltyTime	default: 2	amount of time LT penalty applies
  g_shootLTPenaltyRange default: 1200	enemy detection range

When g_shootLTPenalty is on (1), any damage given to a friendly LT for
g_shootLTPenaltyTime seconds after calling for ammo is doubled and returned to
the shooter.  This is intended to curb the practice of shooting LTs to "remind"
them to give out ammo.

New to 2.02: If an enemy is nearby, LT damage return is automatically disabled!

New to 2.03: The range of enemy detection can be customized.  By default,
g_shootLTPenaltyRange is 1200.


LAUNCH/THROW/FLING
-----------------------------------------------------------------
Cvars:
  g_allowLTF		default: 1	enable/disable launch/throw/fling

Commands (server-side):
  launch <clientname>		launch <clientnumber>
  throw <clientname>		throw <clientnumber>
  fling <clientname>		fling <clientnumber>

Launch propels a player into the air, while throw pushes them forward and
slightly into the air.  This is intented to be used in conjunction with programs
such as Wolfenstein Admin Bot which can parse "say" or "say_team" commands for
"launch" and "throw" and a player name and send the appropriate command along
with the client number derived from the specified player name.  However, there's
nothing stopping you from experimenting with the command manually.  e.g., if
you're the first person to connect, a "launch 0" will launch yourself.

New for 2.02: fling has the upwards velocity of launch and a random direction on
the x-y plane.

New for 2.04: launch/throw/fling have been renamed to launchn/thrown/flingn.
New launch/throw/fling commands have been implemented that will allow you to
use a client's name instead.  Do not use colors when typing the client's name.
You may have a maximum of three spaces in the name.  If there are more than
three spaces, use the client number instead.

g_allowLTF must be on (1) for any of the launch/throw/fling commands to work.
This variable can only be set to 0 through the command line (add the following:
"+set g_allowLTF 0").  It cannot be modified through the console.  This is
useful for admins who wish to deny launch/throw/fling to rcon users.


CANCEL VOTE
-----------------------------------------------------------------
Commands (server-side):
  cancelvote

Cancelvote cancels a vote taking place.


5-SECOND DYNAMITE WARNINGS - new for 2.04
-----------------------------------------------------------------
Cvars:
  g_dynaWarn		default: 1	turn on/off 5-second dynamite warnings

When g_dynaWarn is on (1), players near a friendly, armed dynamite are warned
that the dynamite will detonate 5 seconds prior to it doing so.


DISABLE CHECKPOINT FLAG WINS
-----------------------------------------------------------------
Cvars:
  g_flagWins		default: 1	enable/disable checkpoint flag wins

When g_flagWins is off (0), checkpoint flags are removed from the map after a
map_restart is called.  This effectively turns any solely checkpoint map into a
team deathmatch, and is not recommended for unlimited life games.


DISABLE FLAG POINTS
-----------------------------------------------------------------
Cvars:
  g_flagPoints		default: 0	allow/disallow flag points

When g_flagPoints is off (0), players do not receive points for retrieving flags.


AMMO PACKS HAVE SYRINGES and PISTOL ROUNDS
-----------------------------------------------------------------
Cvars:
  g_ammoGivesSyringes	default: 1	turn on/off syringes in ammo packs
  g_ammoGivesPistol	default: 1	turn on/off pistol rounds in ammo packs

When g_ammoGivesSyringes is on (1), medics will receive one syringe per ammo
pack that they pick up.  The ten syringe limit still applies.  Similarly, when
g_ammoGivesPistol is on (1), pistol ammo is refilled by ammo packs.


HELMET PROTECTS FROM HEAD SHOTS - now customizable for 2.03
-----------------------------------------------------------------
Cvars:
  g_helmetProtects	default: 1	turn on/off helmet protection
  g_helmetDamage	default: 5	amount of damage first head shot takes

When g_helmetProtects is on (1), the first head shot a player receives will
take do g_helmetDamage damage on the player and knock off his helmet.  The idea
here is that the helmet largely protects a player from his first head shot.

Note that this applies to all shots except those coming from a sniper, where
normal damage still occurs.


ENABLE/DISABLE MEDIC SELF-HEALING WHEN CARRYING AN OBJECTIVE - new for 2.04
-----------------------------------------------------------------
Cvars:
  g_medObjHeal		default: 1	turn on/off medic self-healing when
					carrying obj

When g_medObjHeal is off (0), medics cannot heal themselves with their health
packs when they are carrying an objective.  They may still pick up enemy health
packs or health packs from other medics.


START OF ROUND AMMO REQUEST PENALTY - new for 2.04
-----------------------------------------------------------------
Cvars:
  g_startAmmoPenalty	default: 1	turn on/off round start ammo request
					penalty

When g_startAmmoPenalty is on (1), anyone who calls for ammo within the first 5
seconds of a round start receives an ammo reduction (20 for flamer, 50 for venom,
3 for others).  Their request for ammo is also not broadcast.


SPECTATORS CAN TALK TO NON-SPECS - new for 2.02
-----------------------------------------------------------------
Cvars:
  g_allowSpecChat	default: 0	turn on/off spec chat to non-specs

When g_allowSpecChat is on (1), spectator chat using the "say" command will also
be relayed to non-spectator players, i.e. axis and allies.


SPECTATOR LOCKING - new for 2.03
-----------------------------------------------------------------
Cvars:
  g_lockSpecs		default: 0	turn on/off spectator locking

When g_lockSpecs is on (1), spectators cannot moved and are forced to look
straight up.  This is a simple mechanism to help curb any voice chat "cheating"
that may occur.  It's not perfect, however, as specs can still hear sounds.


DISABLE CORPSE SINKING - new for 2.02
-----------------------------------------------------------------
Cvars:
  g_sinkCorpses		default: 1	turn on/off corpse sinking

When g_sinkCorpses is off (0), corpses will remain on the ground indefinately,
unless gibbed by an explosive or other force.  Note that this setting will only
take affect if g_maxlives is 1.


CLASSES
-----------------------------------------------------------------
Commands (client-side):
  classes

Upon issuing the "classes" command (either via bind or in the console using
/classes), a player will receive, in the center of his/her screen, the number of
each class on his/her team.


SHOW REVIVES - new for 2.03
-----------------------------------------------------------------
  g_showRevives		default: 0	turn on/off printing revives in console

When g_showRevives is on (1), revives are printed in the console in the format:
<revivedName> was revived by <reviverName>


CUSTOMIZE BONUS POINTS VALUES - new for 2.03
----------------------------------------------------------------
Cvars:
  Name		     Default	Function
  g_stealObjBonus	10	bonus for stealing objective
  g_captureObjBonus	15	default bonus for capturing objective
  g_killCarrierBonus	10	bonus for killing objective carrier
  g_secureObjBonus	10	bonus for securing objective from slain carrier
  g_plantBonus		5	bonus for planting dynamite at objective
  g_diffuseBonus	5	bonus for diffusing dynamite
  g_destObjBonus*	-1	bonus for destroying objective with dynamite
  g_capBlueObjBonus*	-1	bonus for capturing allied objective
  g_capRedObjBonus*	-1	bonus for capturing axis objective

  * These three bonuses are special in that the points given are specified in
    the map.  To use the map's default values, set these cVars to -1.  Anything
    above or below -1 will override the map's default values.

These values are fairly self-explanatory, however, note that g_capBlueObjBonus
is added to an allied player who captures an objective for his team.  For
example, an allied player transmits the documents on mp_beach.  Likewise,
g_capRedObjBonus is for axis objectives.

Note that g_captureObjBonus is rarely used.


NON-MODIFIABLE/INTERACTIVE FEATURES
-----------------------------------------------------------------
If you are an admin who would like to turn off one of these features, contact me
and I'll make it customizable in the next build.
-----------------------------------------------------------------

LT Ammo Distribution Prioritizer - new for 2.03
  When an LT says "I'm a Lieutenant" to his team, he is told who the best person
  to give ammo to based on need and distance from the LT.

Medic Reminders - new for 2.02
  Moments after a player dies, the nearest, living medic is told that the player
  is down and needs a revive.  This process is repeated every 10 seconds.

  New for 2.03: The location of the downed player is now sent.

No Medic Reminders - new for 2.02
  If a player dies but is revivable, and there is no medic left on his team in
  OLTL mode, then he will be reminded of such.

No LT Reminders - new for 2.03
  If a player requests ammo and no LT is alive or has respawns left, the player
  is told that no LTs are left.

Don't Drop Client if Down
  If a player is down and waiting for a revive, the server will not drop him/her
  for inactivity.  Thus, g_inactivity can still be used without worrying about
  its effect on limited-life games.

Revive Logging
  Revives are now logged in the server log.
  FORMAT: Revive: <reviverClientID> <revivedClientID>: <reviverName> revived
          <revivedName>

30 second team-change wait is disabled
  Players no longer need to wait 30 seconds before joining or switching teams.

  New for 2.03: Delay is back, with a 5 second requirement between team switches
  to avoid floods.

/kill logging
  /kills are not logged as actual kills, but are logged in the following format:
  Suicide: <clientNum>: <clientName>

Black text can be used at beginning of name - new for 2.04
  Black text can now be used at the beginning of a name.  Preceeding black text
  with a karat is no longer necessary.

Players can switch teams during warmup - new for 2.04
  Regardless of the g_maxlives setting, players can always switch teams during
  the warmup period.

=================================================================
6. KNOWN BUGS
=================================================================
  - shrub has not been getting enough sleep lately

=================================================================
7. LICENSE
=================================================================
You may use the included .DLL or .SO file with your RTCW server.  You may
distribute the .DLL or .SO file if and only if this text file is included.  You
may not make modifications to the .DLL or .SO file.  You may not hold "shrub"
responsible for any damage of any kind resulting from the use of the included
.DLL or .SO file.

END OF FILE

Read More