Name of Mod : The C.R.Bot, for Quake II
File Name   : crbot099.zip
Version     : 0.99
Date        : January 30, 1998
Author      : Mike Malakhov
E-mail      : crbot@planetquake.com
              ww@pobox.com
Web Site    : http://planetquake.com/crbot
              http://www.pobox.com/~ww/bot.html
Build time  : > 100 hours

AUTHOR INFO
-----------
My name's Mike Malakhov, you can get more info about me 
on my homepage at http://www.pobox.com/~ww/


TYPE OF MOD 
-----------
DLL      : Yes
Sound    : No
MDL      : No
Maps     : No
Graphics : No
Menu     : Yes


FORMAT
------
It was compiled using Visual C++ v5.0. 
You will need Quake2 with patch v3.09 or later.



INSTALLATION
------------
Unzip this file with subdirectories in your Quake2 dir. For example, if your 
Quake2 directory is d:\quake2\ after unzipping you will get d:\quake2\crbot\ 
subdirectory. Then copy your standard shortcut for running Quake2 into a new 
one and then add 
 +set game "crbot" +set deathmatch 1
to the command line.



COMMANDS
--------

addbots <skill> <amount> -- to spawn several bots; <skill> could be a number
                          from 1(easy) to 10(most advanced), or could be a 
                          range like this: <min_skill>..<max_skill>
                          that'll allow you to create random set of bots with 
                          different skills; example:  addbots 3..6 5
                          it'll create 5 bots with random skills from 3 to 6;
                          skill 0 has special meaning -- bot with this skill 
                          level will be adjusting his abilities dynamically
                          to match player's skills;

cmd addbot "<name>" <skill> <male?> <skin_no> <team_no>
              -- add a bot, where <skill> is a number from 1 (low) to
                 10 (most advanced); <male> is 0 if you want female bot or
                 1 if you want it male; you can repeat this command
                 to add more bots; you can also use this command in .CFG files
                 (see BOTS.CFG for example how to do this) to create predefined
                 set of bots by typing "exec bots.cfg" in console window;

killbot <name> -- remove bot with name <name> from the game permanently;

bot_team # -- (# is a number from 0 to 9) you can assign next created bot to 
              specified team; bots from the same team don't attack each other 
              unless they'll accidentally hurt each other;
              team 0 has special meaning, all bots in that team fight for 
              themselves (default team).

cmd set_team # -- put yourself into the team number # together with bots;

bot_skin # -- default is 1; as bot_team command this one presets the skin for
              all bots created afterwards;

Here is list of all skins you can use and their numbers,
  Male:
      0: cipher          5: major           10: razor     
      1: claymore        6: nightops        11: recon     
      2: flak            7: pointman        12: scout     
      3: grunt           8: psycho          13: sniper    
      4: howitzer        9: rampage         14: viper     
         
  Female:
      0: athena          5: jungle    
      1: brianna         6: lotus     
      2: cobalt          7: stiletto  
      3: ensign          8: venus     
      4: jezebel         9: voodoo    
         
bot_male # -- if 0 than next bot gonna be female, if 1 -- male;

bot_chat # -- set this var to 0 if you don't want to hear anything from bots,
              default is 1;

obituary_msgs # -- deafult is 1; if it's set to 0 you will not see any
                   "bot killed by bot", "human killed by bot", etc., messages;

restricted_mode # -- set this variable to 1 if you don't want anyone to add 
                     more bots using "cmd addbots"

cmd bot_stats -- type information about all bots in the game;

Note: All commands without "cmd" prefix will be effective only if 
      typed on server;
      All 'bot_' vars will be saved in config.cfg.


For example, if you want to start the game with 8 bots, two female ones in one 
team with skill 3, three males in another team with skills between 3 and 7, 
three individual bots with skills 6, 8 and 10 and names, and assign distinctive 
skins to every team and to individual bots, you have to type in console window:

 bot_male 0
 bot_skin 1
 bot_team 1
 addbots 3 2

 bot_male 1
 bot_skin 2
 bot_team 2
 addbots 3..7 3

 cmd addbot scout  6  1  3  0
 cmd addbot bitch  8  0  4  0
 cmd addbot "ultimate bot" 10  1  5  0


MENU USAGE
----------

 You can use menu system to edit different settings and to create
bots. To access it use your "inventory" key -- <TAB> by default.
To navigate menu use "]" and "[" ("next in inventory" and "previous in 
inventory" keys) and to select menu item use <ENTER> (or your "use inventory"
key),.


EXTERNAL CONFIG FILES
---------------------

 There are four text files you can edit which contain lines bot will say 
in different situations:

DEATH.TXT -- when bot dies
KILL.TXT  -- when bot kills somebody
PAIN.TXT  -- when bot gets hurt by somebody
FIGHT.TXT -- random saying during melee



KNOWN BUGS
----------

1. "Error: cprintf to a non-client". I have no idea what causes it. 
   I'm trying to contact ID Software on this issue.



FREQUENTLY ASKED QUESTIONS:
-------------------------

Q: I love your bot, but in the game I see gray diamonds floating around instead
   of normal bot's model. Why?
A: Make sure you've unzipped archive with subdirectories. You should have
   BOTS/FEMALE and BOTS/MALE subdirectories under QUAKE2/CRBOT with bot's 
   model in it.

Q: I've installed everything as you said, but can't create any bots, game 
   doesn't understand "addbot" or "addbots" commands. Why?
A: Make sure you DO NOT have gamex86.dll in base Quake2 directory. It should
   be located only in QUAKE2/BASEQ2 and/or QUAKE2/CRBOT subdirs.

Q: I've created special bot.cfg script file to be able to put my favourite bots
   configuration in the game every time I play. But when I'm doing 
   "exec bot.cfg" game executes only last command in my script. Why?
A: I have no control over reading .cfg files in Quake2, but I'm going to find
   some work-around for this problem.     

Q: Can I use my own skin with your bot?
A: No. It was trade off to be able to assign different skins to all bots.
   You can just replace one of the skins in QUAKE2/BASEQ2/PLAYERS/MALE or
   .../FEMALE directory though, since bot model refernces them directly.

Q: What about Linux and Alpha port?
A: Yes, eventually I'm going to do it. But not right now.

Q1: I've done everything as you said, but can't create the bot. Why?
Q2: You bot is great, but how do I play it?
Q3: Where do I find Quake2 shortcut and how to add "+set game crbot" 
    to the command line?
A: (by Jay Fortman <chaosfox@inetarena.com>)
    Double click on the .zip to open up your .zip program (presumably
WinZip).  When the file names show up goto edit and "Select All" (or
press Ctrl+A).  Press extract.  It will then ask for a location to
extract the files to.  Enter: C:\Quake2 (where C: is the drive Q2 is
installed on and assuming you didn't rename the directory from default
Quake2).  The files will then be extracted to a new directory under
Quake2 labeled CRBot automatically.  Future updates can be performed in
the same manner--they will just overwrite the old files (and, as a
suggestion, keep your old version in its original .zip just in case the
new one doesn't work for you).  Now you'll need to RIGHT click (the
mouse button) on the Taskbar at the bottom of the Desktop (that's that
area between the Start button and clock that doesn't have
taskbuttons--if you don't know that you don't belong on a computer).
Select Properties.  A new window will pop up titled Taskbar
Properties--select the Start Menu Programs tab just under the titlebar.
Some new options come up--select the button labeled Advanced.  Assuming
you didn't move the Q2 start menu shortcut open the plus next to
Programs, you should now see Quake II.  Click on the Quake II folder and
all of its contents will be displayed in the right window.  From the
window with the Q2 contents, RIGHT click on Quake II -or- Quake II -
Compatability Mode (whichever you prefer to use--I recommend the
compatability mode myself).  Select the option COPY.  Now RIGHT click in
the empty space of the same window and choose PASTE.  You should now
have a COPY OF QUAKE II - COMPATABILITY MODE.  RIGHT click that and
rename it whatever you like ("Quake II - CRBot" is my choice ; ).  Now
RIGHT click it again and choose PROPERTIES.  Click on the SHORTCUT tab
under the title bar.  In the window that pops up there should be an
entry labeled TARGET.  Click in the text area and make sure you move the
cursur all the way to your right (the end of the entry).  Add one space
after the last entry and add the following:  +set game "crbot" +set
deathmatch 1 .  So the TARGET should read something like this (where C:
is the drive your Q2 is in and E: is your CD-rom drive):
C:\Quake2\quake2.exe +set cddir E:\install\data +set basedir c:\QUAKE2
+set vid_ref soft +set vid_fullscreen 0 +set sw_mode 0 +set s_wavonly 1
+set game "crbot" +set deathmatch 1 .  If everything is set up just like
that your copy of Quake II - CRBot should now be ready to run like the
blood splattered on the wall after you were supremely gibbed.  Close all
windows and then go through the start menu and select your CRBot
shortcut.  BINGO!  To add bots to your working Q2 game simply follow the
instructions posted in the README.TXT file extracted from the .zip file
directly into your CRBot directory (may I suggest making a start menu
shortcut for that too--it's simple, you can do it).  If you feel you
need to peruse the contents of the readme and are in the middle of your
Q2 game simply hold down ALT and then press TAB.  This will return you
to windows without losing your game (most of the time--everything has
bugs sometimes).  And that about sums it up fragies and fragmen.  I hope
this was informative enough to help you out ;) .


Q: Blah-blah-blah. Why?
A: I don't know.
  


COPYRIGHT/PERMISSIONS
----------------------
This bot was solely created for my own use, therefore it is distributed AS IS 
and I can not guarantee you'll enjoy it. I also will not take any responsibility 
for your system crashes, any damage or loss of data. I can however guarantee that 
I have not intentionally added any malicious content to this application. 
This mod is in no way associated with id Software. 
You may freely distribute this archive, as long as it remains intact.
For commercial distribution or distribution on CDs, please get my written 
permission first. 

Enjoy,
Mike Malakhov (ww@pobox.com, crbot@planetquake.com)
