Name of Mod        : Scientist Hunt
File Name          : shunt08.zip
Version            : 0.8
Date               : June 13, 2000
Author(s)          : Rich Whitehouse and Brian McClelland
E-mail             : thefatal@telefragged.com
Web Site           : http://www.telefragged.com/thefatal/

Additional Credits : Thanks to Hondo for level design and
                     testing.

AUTHOR INFO
-----------
I (Rich) am also the author of the Famkebot, Head Soccer, the Jumbot,
and many other things.

Hondo can be contacted at hondo@telefragged.com. He's also the
author of 5am for Action Half-Life and BlockWar for Action Quake II,
among other things.

LEVEL CREDITS
-------------
Brian McClelland (or Hondo):
Backyard, football, Temple, Scisub, 5amsci, Factory, scihouse,
scioffice, scihorror

Rich:
duskhunt, huntring, mexprisn

TYPE OF MOD 
-----------
This is a multiplayer mod (with bots included) for Half-Life.

Programming  : Yes.
Sound        : No.
MDL          : No.
Maps         : Yes.
Graphics     : No.

VERSION HISTORY
---------------
0.8:
Scientist Hunt now works with version 1.1.0.0 of Half-Life.

Version 2.0 of the Jumbot has been ported over to SH.

A few bugs have been fixed, such as scientists respawning over the
sh_scimax value.
---
0.71:
A small fix has been put in place so that players get their arsenals
restored on a timer in traditional slaughter mode if sh_resarsenal is
set.

A number of people have complained that scientists often run toward you
when they get scared. That's fixed now.
---
0.7:
There are now three different modes of play:

    1. Standard Hunting - Just like usual. The scientists run around and
       scream while you shoot them to win the round.

    2. Stealth Hunting - Like above, but scientists don't run until they
       see you, and you get extra points for killing them before they can
       see you.

    3. Traditional Slaughter - Traditional scientist murder. Scientists trust
       you until you hurt them or they see you kill another one of their
       kind. This mode is also not round-based, and scientists just respawn
       shortly after they're killed. Breakable objects will also respawn on
       a timer (rather than each round) if you have it set to respawn
       breakable objects.

Two new levels by Hondo are included. The first is scioffice, and the other
is scihorror.

Added an option to have blood shoot from a scientist's wound as he
flies through the air. It can be set in the advanced server options
menu while starting a server.

Added a gore multiply option (can be set in the advanced server options
menu). This multiplies blood splatter by the amount you set up to 10
times. Be warned that it's mainly just for screen shots and such, since
it can be very bad on the framerate.

Added an option to force each scientist to have a random appearance.

Fixed a negative velocity bug in the scientist-fly-through-glass
routine, as well as a general scientist velocity bug.

Changed the Jumbot v1.8 AI to work better with Scientist Hunt.
---
0.6:
Fixed problem where players would respawn on the same spawn spot
every time (when the spot was not blocked) instead of random spots.

Made it so that "Sci Hunt" is issued as the game description rather
than "HL Teamplay".

Version 1.8 of the Jumbot is now fully implemented.

Scientists can be blown back through glass. This is probably the
most enjoyable feature I've added in a while (for one can have
endless fun sending scientists flying out of windows).
---
0.5:
Distribution now includes 5amsci (a Scientist Hunt conversion of
Hondo's popular Action Half-Life level), Factory (an original SH
level by Hondo), and scihouse (another original SH level by Hondo).

Fixed up the bot AI a little (though it's not nearly up to speed
with the latest version of the Jumbot).

Destructable level objects (windows, TVs, etc) now respawn every
round. This can be disabled in the server startup menu's advanced
options.

Added a map_default.cfg which is executed by default for every
map to reset defaults if there's no CFG for a specific map.

Added a new scientist AI realism mode, where scientists react to
the environment and look for threats, as well as communicate with
each other and a variety of other things. All of the AI is done from
scratch and is designed to work quickly, efficiently, and in a
multiplayer environment.

The advanced options server menu has been changed to accomodate SH
better.

In stealth hunting mode, you're awarded more points for murdering a
scientist without letting him notice you. This is to encourage
players to use stealth more, as it can be fun when your only goal
is to murder scientists.

Added a sh_clprint cvar so the server can toggle client messages on
and off.
---
0.4:
Fixed the string handling that I completely destroyed by trying to
fix a bug in 0.3. Bots also run at a constant perfect speed despite
quick framerate changes now.
---
0.3:
Fixed a problem with clients overflowing and the server sometimes
crashing if sh_resarsenal was enabled.

Fixed a problem where if a scientist was killed by a player's
snark and the player had another weapon selected, the game would
think the player used that weapon to kill the scientist (this also
applies to grenades, tripmines, etc).
---
0.2:
Various things added and fixed. New optional scientist death physics,
scientist score info, and more. Make sure you look at the new updated
installation and use instructions before doing anything.
---
0.1:
First release.

INSTALLATION AND USE
--------------------
Extract the zip file WITH DIRECTORY STRUCTURE directly to your Half-Life
directory. If you did it correctly, you'll have a new "scihunt" folder
under your Half-Life folder. Now start Half-Life with the console
(-console at the command line). Once in the menu, use the custom
game option to activate the mod.

First, go to the control configuration menu. You'll notice there is a
new entry for viewing the scientist round scores. Assign a key to it, as
you'll probably want to use it.

Now just start a regular LAN game through the menu (don't forget to set
the frag and time limits) and use the console (~ key) to enter commands
and change values (which are listed below). Or, if you want to start a
public internet server, you can follow the same instructions and just
start an internet game instead of a LAN game.

Remember, if you want to enable bots, you'll have to check the option
to enable them under the advanced options in the server start menu. Also
remember to set any other options you may want to change from the default
in the advanced options menu.

Also remember to set up the shconfig.cfg in your scihunt directory to
fit your needs before you do anything.

After you get everything else set up, you can also edit the starteqp.txt
file. You can add the names of weapons/ammo into it (it uses the standard
HL entity names that you'll also see in WorldCraft and such) to have
players spawn with those weapons and ammo each time they die. If you
don't want to have anything extra given to the player, then either make
the file blank or delete/rename it.

If you really want to start configuring things, then you can edit the
level CFG files to point the sh_weapfileloc to different files in the
arsenals folder. Then you can have different weapon configurations and
such for each level. You can also set any other console command in each
level CFG file. There are a lot of possibilities.

INFORMATION
-----------
The object of the game is fairly simple. There are two teams. The red team,
and the blue team. Each team starts out in a different part of the level,
and some scientists will spawn around the middle. It is your job to track
down and murder as many scientists as you can until they're all dead, and
try to get more than the other team. While you're after the scientists, you
can kill members of the other team as well. If you manage to pick off the
last remaining scientist for the round, you'll get a bonus of one frag.
Each time a team wins a round, each member of the team gets a total of
ten frags. Each scientist you kill under regular conditions will get you
one frag, and killing one under normal conditions with a crowbar will
get you two frags. If one team kills all scientists on the level and the
other team gets no kills, the winning team will get a two frag bonus for
every team member. Note that regular kills are doubled in stealth hunt mode
if you can manage to kill the scientist without him noticing you. So,
killing a scientist with a standard weapon without him noticing you will
get you two frags instead of one, and killing him with the crowbar without
being noticed will get you a total of four frags for that single kill.

So, that's pretty much it. Go find a server or load up a game with bots
by yourself and have fun.

By the way, if you want to build your own map for Scientist Hunt, then
be sure to take a look at the mapspecs.txt file to see what you need
to do.

SETTINGS AND COMMANDS
---------------------
changeteam (command): As a client, this will change the team you are on.

sh_enablebots (cvar): Setting to 1 enables Jumbots. The options for the
bot are still basically the same as when you run the bot by itself. All
the files for the bot are in the \botfiles subdirectory under your
scihunt folder. For more information on the bot, see the jumbot_readme.txt
file. The default is 0 (bots disabled). Note that this is also settable
by a check box from the main server startup menu (under advanced options).

sh_allowteamchange (cvar): Setting this to 1 allows clients to change
teams with the changeteam command. Setting this to 0 disables that ability.
The default is 1.

sh_forcemodel (cvar): Setting this to 1 forces players to use the Gordon
model. This is because some models do not have visible colors on them,
and you cannot see what team a person is on that way. Setting to 0 allows
players to use any model they wish. The default is 1.

sh_scispeed (cvar): Set this to the speed you want scientists to run at.
Higher is faster, lower is slower. The default is 40.

sh_scifly (cvar): If set to 1, this allows scientists to fly back with
impact damage when hit. Setting to 0 disables this and makes them act
the same as they do in regular single player.

sh_deadsciphys (cvar): Allows corpse juggling and other fun things if
set to 1. Default is 1.

sh_announcescideath (cvar): Set to 1 to announce scientist deaths to
everyone playing. Default is 0.

sh_announcescinum (cvar): Set to 0 to disable the client's ability to
see the scientist round score with +sciscore. Default is 1.

sh_scimax (cvar): Sets the maximum amount of scientists to spawn on the
level. If sh_scimax is less than the number of scientist spots on the
level, then the scientists will treat each scientist spot as a spawn
spot and spawn on them randomly each round. The default value is 5.

sh_crowbar (cvar): Set to 1 to make it so no one can use any weapon other
than the crowbar. This rule applies to both bots and humans. The default
is 0 (disabled).

sh_clprint (cvar): Allows the server to toggle client messages on and off.
1 is on, 0 (default) is off.

sh_restorehealth (cvar): Set this to 1 to restore every player's health
to 100 if it is less than that at the start of each round. The default
is 0 (disabled).

sh_resarsenal (cvar): Set this to 1 to destroy the player's weapons and
restore his arsenal to the default each new round. The default is 0
(disabled).

sh_levelexec (cvar): Looks in the maps folder to see if there is a CFG
with the same name as the map name and executes it, if this is set to
1. This allows you to have your own custom server options depending on
the level. For example, if the level is backyard.bsp, it will look
for a file named backyard.cfg and execute it if it exists. The default
for this value is 1 (enabled).

sh_weapfileloc (cvar): Points to the location of the file which tells
what weapons and ammo to give players upon spawning in non-crowbar
mode. The default is arsenals/starteqp.txt.

sh_realistic (cvar): Sets the game mode. This should be set in the
advanced options menu while starting a server.

sh_respbreak (cvar): Toggles breakable objects respawning each round on
and off (1 respawns, 0 does not). This can be set in the advanced options
while starting a server as well.

All of the options and commands for the Jumbot are listed in the
jumbot_readme.txt file.

BUGS, ETC.
----------
No serious bugs are known currently.

COPYRIGHT/PERMISSIONS
---------------------
This mod may only be distributed if this file and all the other files that
came with it are included in the redistribution, and no money is charged
for the product being distributed. This excludes such things as video
game magazines which include a CD and things such as that, which are
permitted to include this mod (provided they meet the requirements above)
as long as they notify me before doing so and get my permission through
e-mail or some other form. You may not use any part of this mod in your
own mod, and you may not distribute any part of this mod without the
rest of the mod under the previously stated terms.

