Quake 2 Basketball
Version 0.91
--------------------------------------------------------------

Title:		Quake 2 Basketball

Author:		Matt Shade

Email:		shademd@email.uc.edu

Webpage:	http://www.geocities.com/TimesSquare/Dungeon/5564/index.html

Details:	Quake 2 Basketball is a partial conversion for 
		Quake 2. It changes Quake 2 to a basketball
		type game.

--------------------------------------------------------------

New Models:	Yes
New Sounds:	Yes
New Graphics:	Yes
New Code:	Yes

--------------------------------------------------------------

Instructions:

1) Download the .zip file and place it in quake2\bball\ directory
2) Unzip the file in the quake\bball\ directory
3) Go to the Quake 2 directory and type:

	quake2.exe +set game bball

4) In the console type "map bball" to begin.

--------------------------------------------------------------

Game Modes

Quake 2 Basketball currently has two different game modes.  There is
a console variable used to select the desired mode.  Bring down the 
console once in the game, and type gamemode 1 for the first mode, or
gamemode 2 for the second mode.  The default mode is gamemode 1.
Following is a descriptionof the different modes:

gamemode 1
	The first game mode is based more on precision shooting than
	quick action.  In this mode, when you shoot you control not 
	only the alignment of your shot but the distance it will
	travel.  By holding down the attack button, a power meter
	will appear in the bottom center of the screen.  Letting go
	of the attack button shoots the ball with the displayed
	power, between 0 and 100.  Once the meter reaches 100 the
	ball will automatically be shot with full power.  Gamemode 1
	is ideally used with only a few players or when shooting by
	ones self. It is much more difficult than gamemode 2.

gamemode 2
	The second game mode is based more on an arcade type
	basketball game.  The player does not have to aim his shot
	at all, only press the attack button to shoot.  In this
	mode, the closer you are to the basket the better your
	chance of scoring.  Longer shots, like three pointers, will
	only go in some of the time, much like a basketball video
	game.  This mode is for when there are a lot of players, or
	when you just don't feel like having to aim.  Initially,
	this mode will be much easier than gamemode 1.  You can set
	how hard it is to score with the difficulty setting.

--------------------------------------------------------------------
Controls

**The zip file came with an autoexec.cfg file.  This file will
  bind the keys as follows:

  / = pass
  j = jumpball
  n = newteam
  k = chasecam

  If you don't like this configuration, or would like to use your
  own autoexec.cfg, delete the one that came with it and set things
  up according to your own taste.

The following are additional controls added to Quake 2 Basketball.
These controls should be bound to a key for easy use. All normal
Quake 2 controls are still there.

pass - 	The pass command will, hence the name, pass the ball.  It is
	different from plain shooting in that it fires the ball with
	one button tap in a straight line and good speed.  It works
	in either game mode.

jumpball - The jumpball command can only be used once the players are
	prompted to call jumpball on the screen.  This command is
	implemented for the occasion in which the ball gets stuck
	someplace out of reach of the player.  After the ball is
	stationary for about 7 seconds, players will be prompted to
	call jumpball.  Possession alternates between the two teams.

newteam - This command is used to change teams.  It can also be used
	if you forget which team you are on. It will bring up a the
	same menu displayed when enterring the game, with you current
	team shown as the initial selection.

chasecam - This command toggles between chasecam on and off. Chasecam
	primarily should be used during gamemode 2, as it is hard to
	aim in gamemode 1 if the chasecam is on.

**The zip file came with an autoexec.cfg file.  This file will
  bind the keys as follows:

  / = pass
  w = jumpball
  n = newteam
  f = chasecam

  If you don't like this configuration, or would like to use your
  own autoexec.cfg, delete the one that came with it and set things
  up according to your own taste.

-------------------------------
The following variables are changeable in the console:

gamemode - As described above, changes the mode of the game.
	Possible Values: 1 or 2
	Default: 1

noweapons - Sets whether weapons are allowed or not.  A value of 1
	means weapons are not allowed, while a value of 0 means
	weapons are allowed.
	Possible Values: 0 or 1
	Default: 1

scorelimit - Sets the score limit for a game.  When the scorelimit
	is hit, the game is over.  Much like fraglimit in deathmatch.
	Set to 0 for no scorelimit.
	Possible Values: 0 through any positive integer
	Default: 0

dunks - Allows dunking. Set to 1 to permit dunks, or 0 to prohibit
	them.
	Possible Values: 0 or 1
	Default: 1

difficulty - Sets how easy it is to score in gamemode 2. 0 makes you
	score the easiest, or most often, and 10 makes it the hardest
	to score. Can be any value between 0 and 10.
	Possible Values: 0 to 10
	Default: 0

forceteams - Server automatically assigns a new player to a team when
	this is set to 1.  The player can't pick his team or change
	it.  The server assigns teams in a manner as to keep the
	sizes as even as possible.
	Possible Values: 0 or 1
	Default: 0

team1name - Assigns the team name.  This name shows up on the player
	selection menu, and throughout the game as the players are
	sent messages about scoring and other actions.  Size of name
	should be 15 characters or less, or else extra characters
	will be cut off on the team selection menu.
	Possible Values: Any characters up to 15
	Default: Home
team2name - Same as team1name, but for the other team.
	Possible Values: Any characters up to 15
	Default: Visitor

d_bball - This setting isn't actually intended for use.  It was used
	by me during development. It has little purpose now, but if
	you really want, you can set it to 1 and check it out.  It
	currently does only two things. The most important use is to
	start the jumpball in a multiplayer game even if there isn't
	a player for each team.  Do this if you want to play by
	yourself in multiplayer mode.  The other thing it does is
	give extended information on your shot when in gamemode 2.
	Not real useful to most people, but it's there if you just
	have to see it.
	Possible Values: 0 or 1
	Default: 0

----------------------------------------------------------------------
Rules

Quake 2 Basketball follows the normal rules of basketball.  To begin
the game, a jumpball is dropped in the center circle.  Once there is
at least one player on each team, the screen will have a ten second
count down for the jumpball, and then the ball will be dropped.

Players get two points for all shots inside the three point line,
and three points for all shots outside their three point line.
After a team scores, a randomly selected player from the other team
will be teleported to the baseline with the ball to begin his teams
offense.

Any player that does not have the ball will see his empty hands in
front of him (when not in chasecam mode).  Players without the ball
can try to steal it from the player with the ball by pressing the
attack button.  Once the ball is shot or passed, that players hands
automatically become empty (makes sense doesn't it?).

You can dunk the ball by being close to the basket (close to
underneath the rim).  You must be under your own teams basket to 
dunk.  Also, no player from the other team can be close to you if
you want to dunk.

If the ball gets stuck, players should call jumpball as described
in the controls section.  Anything else should be easy enough to
figure out once you actually start playing.

If you wish to take a break and not participate, you can go in the
observation room (the room off the court that you have to enter
through the door).  Here you can watch the game through the upper
deck glass viewing area.  When in the observation room, you are not
considered a participant.  You will not be teleported to inbound the
ball after scores or on jumpballs. Once you go back on the court,
you are a participant once again.

--------------------------------------------------------------------
Note for playing in single player

While Quake 2 Basketball is obviously a team game, you can still play
by yourself.  I encourage you to do this once you decide to download
Quake 2 Basketball, and unless someone sets up a server for it, then
it will be the only way some of you can play unless you have a lan.
So, when playing by yourself, you'll want to make sure you have
deathmatch set at 0.  Then just type map bball in the console to play.
You can still use all the settings, but some obviously have no effect,
like forceteams and such. If you want to check out how multiplayer is,
you can set deathmatch to 1, and enter the map. Then in the console
type d_bball 1 to start the jumpball.  You'll probably want to
type d_ball 0 in the console once the jumpball has started to turn
this setting off.  You can then proceed in the total enjoyment of
playing a basketball game against yourself, switching teams after
every score if you want. What fun!

--------------------------------------------------------------------
To Begin

For single player:

Quake 2 Basketball isn't all that fun in single player, but anyway,
if "game" is set to "bball" then just type "map bball" and shoot
away.

For multiplyer:
The server should bring down the console and set the gamemode,
noweapons setting, and scorelimit the way they want, and to begin
the game type "map bball".  Then, everyone who joins the game must
select their team in the menu, and they are ready to play. Simple
isn't it?

--------------------------------------------------------------------
Credits

Quake 2 Basketball is made by Matt Shade.  All coding, modelling,
levels, and graphics were made by me. You can email me at
shademd@email.uc.edu

I would also like to thank the following people:

  Warzone - for his chasecam tutorial, which is the entire basis for
  the chasecam in Quake 2 Basketball

  All contributors to QDevels - I used many of their tutorials as
  important stepping stones throughout the process of making this
  Quake 2 Mod.

  Id Software - Of course, for making Quake 2 and letting us screw
  with it.
