
----------------------------------------------------------------
                           README.TXT
                  Dungeon Bowl Java Server/Client
----------------------------------------------------------------
****************************************************************
NOTE: This program is incomplete and you will most likely
encounter problems that do not allow you to finish a game.
It is given out for preview purposes only.
****************************************************************

This Java program requires that Sun's Java Runtime Environment 
version 1.3 or higher (JRE 1.3+) be installed on your computer.  
The JRE can be downloaded from Sun's website.  The url is below.

http://java.sun.com/j2se/1.3/jre/download-windows.html

----------------------------------------------------------------
Installing the program
----------------------------------------------------------------

This explains how to install the DB Java Client, not Sun's JRE.
You should be able to easily install the product by unzipping 
the zip file to a directory you created and keeping the embedded 
directory structure.
The directories should look like the following:

<Directory Created Before Unzip[I suggest you use C:\Dbowl]>
	|
	----pics
	|
	----teams
	|
	----sound

The pics folder should contain all the images in the zip file.

The sound folder should contain all the .wav files in the zip file.

The teams folder has one sample team for each race so you know 
what each position type needs to be to match up with the default
position pictures.

All other files reside in the root unzip folder.

----------------------------------------------------------------
Starting the program
----------------------------------------------------------------

If you have the JRE in your path then you should be able to run
the game simply by double clicking the bbowl.jar file from
explorer.  Other methods are described below.

There is a windows shortcut included in the zip file.  If the 
shortcut does not work on your system you may need to correct 
the target path in the shortcut to point to the directory that
contains the javaw.exe program installed by Sun's JRE 1.3 install.
Also make sure the "start in:" field has the correct path to your
install directory.  The default start-in directory points to
c:\Dbowl

If the you cannot get the shortcut to run properly or you are on
a system other than a windows system, you can run the program 
from a command line by typing the following:

java -jar dbowl.jar

You must be in the directory where the dbowl.jar is installed.
Also, java.exe, must be in your system path.  If you can't 
get the java.exe into your path try the following on the command
line:

<full path to java.exe>\java -jar dbowl.jar

NOTE: The program was written to be used with a screen
resoulution of 1024x758 or higher.  A smaller desktop would need 
to use a virtual size of 1024x758 or higher to be able to use the 
program.  The higher the color depth the better but I am unaware
of a color depth limitation.

----------------------------------------------------------------
Known problems:
----------------------------------------------------------------

(1) Sometimes when you first run the game after a fresh re-boot the
game screen comes up so small that you can only see the title bar
and the "X" to close the game.  If this happens close and run the 
game again.  Everything should work fine now.

(2) On some Windows 2000 machines the graphics of the game will 
flicker as you move the mouse around the screen.  This is a 
problem with the JRE 1.3 and direct draw in Windows 2000.  To fix 
this start the game.  Hit CTRL-ATL-DEL to bring up the 
log-off/restart screen.  Hit ESCAPE to leave this screen.  The
flicker should now be gone.  This forces Windows 2000 out of 
direct draw mode.  Unfortunately this must be done again when you 
next reboot the machine.

(3) I have not completely tested the reading of hand edited team 
HTML files.  The program will always read original team files 
created by the Blood Bowl Team Editor by Mike Howard and the 
exported HTML files from the Team Tracker XLS spreadsheet.  The 
program starts having trouble with certain kinds of edits.  
An example of an unsupported edit is adding font tags around 
individual entries in the roster table.

(4) The program does not handle team rosters that leave blank rows.  
Example: There are players in rows 1, 2, 4, 5, with 3 blank.  
The program will think the list of players ends after #2 and you 
will get a team with only 2 players (#1 and #2).  Don't leave blanks
unless you want the program to ignore players after the first blank
roster row.

----------------------------------------------------------------
Game Play Notes:
----------------------------------------------------------------

There are shortcut keys to actions and movement

When a character is selected the following keys can be used to 
select an action:

M = move
B = block
Z = blitz
H = Hand-off
P = pass
G = GFI

Once and action is selected use number keys to move, block, foul.
The numbers and their directions are as follows from the ".":

789
4.6
123

These were picked so they make sense from a keypad perspective. 
(numlock on).  You can use the numbers above the alpha keys as 
well but it's not really intuitive that way.


----------------------------------------------------------------
Mixed Race Rosters:
----------------------------------------------------------------

To create mixed race rosters you must prefix any allied players 
with their race.  Case doesn't matter.

Format:
<race> position

Example: 
To place a dark elf thrower on a human team you would put
"Dark Elf Thrower" in the position column.  While a human
thrower only needs "Thrower" in the position column because
the default race matches the team race type on the roster, 
which is "human".  


----------------------------------------------------------------
Niggling Injuries and Missed Games:
----------------------------------------------------------------

To tell the program what players should miss the game and what 
players have niggling injuries simply place a "m" or "n" in 
the "Injury" column of the roster on the affected player's row 
before loading the game.  The game will make the niggling injury
rolls for each player marked with a "n".  For players with 
multiple niggling injuries place and many comma seperated "n"s
as there are niggling injuries. 
 
Example:  a player with 2 niggling injuries would have 
"n,n" in the Injury box.

"n,m" is also a valid entry.  Case does not matter.  The coaches
will be prompted to use an apothecary (if they has one) on any
player who fails the niggling injury roll.  Player's marked with
an "m" or player's who fail their niggling injury roll will be
marked stunned in the reserves box and will not be able to be
used in the game.


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

Blood Bowl and the Blood Bowl Logo are trademarks of Games Workshop 
Limited and are used without permission.  
Dungeon Bowl and the Dungeon Bowl Logo are trademarks of Games Workshop 
Limited and are used without permission.
No challenge to their status is intended.

You must own a legitimate copy of Blood Bowl (the board game) 
and Dungeon Bowl (the board game) to legally use this program.

In no event shall we be liable for any special, incidental, 
indirect, or consequential damages whatsoever arising out of 
the use of or inability to use the Dungeon Bowl Java Server/Client.

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

