--------------------
	BOMBJACK README FILE
	--------------------

The arcade game "BombJack" is (C) Copyright 1984 by TEHKAN LTD.
This emulator was written by Jakob Frandsen (jfrandsen@ite.dk) in 1996/97.
(C) Copyright 1996/97 by Jakob Frandsen. All rights reserved for the
emulator program.


	-------------------
	SYSTEM REQUIREMENTS
	-------------------

 - PC
 - DOS (or Windows 95 (TM))
 - Fast 486 or Pentium (TM) (recommended)
 - VGA card (Fast PCI card recommended)
 - 4MB RAM

This game is definately best when it runs every frame. For this you will
probably need at least a Pentium (TM) and a fast VGA-card.

If the game does not function right, (monsters weird, controls weak,
whatever), you can try to specify a numbered parameter to the exe-file.
You can use numbers from 1-10, the higher the number, the more time the
computer will spend emulating Z80 code (rather than drawing on the screen).
Default is 1. Experiment, if the game does not behave right.


	----------------------
	HOW DO I GET TO PLAY??
	----------------------

You will need the ROM images from the arcade machine. There are 16 ROMs,
all sized 8192 bytes except number 2, 3, 4, and 5. Once you have obtained
the ROMs, copy all 16 to this directory (where the executable file is),
rename the ROMs, so that they are called:

	bj-01.bin
	bj-02.bin
	bj-03.bin
	bj-04.bin
	bj-05.bin
	bj-06.bin
	bj-07.bin
	bj-08.bin
	bj-09.bin
	bj-10.bin
	bj-11.bin
	bj-12.bin
	bj-13.bin
	bj-14.bin
	bj-15.bin
	bj-16.bin

I cannot supply the ROMs and please don't e-mail me for them, they
are copyrighted by TEHKAN LTD.


	---------------------------
	INGAME CONTROL AND COMMENTS
	---------------------------

When the game starts, it will do a ROM and a RAM test. The ROM tests will
always fail, which is because I patch the Z80-code at startup-time. The
reason for this is that it makes the emulation of some hardware registers
faster. Don't mind this, though. At this point, you can press FIRE (which
is SPACE or CTRL) to pass the test and move on. After the ROM/RAM test, a
grid filling the screen will appear, don't mind this, just press SPACE or
CTRL again to get to the real game. Once there, you can use the following
keys to play:

	C	Credit (like inserting a coin). You must inserts coin(s)
		to play.

	F1	One player button.

	F2	Two player button.

	ARROW-
	KEYS	Steer BombJack (use also left and right to write hiscore)

	SPACE/
	CTRL	JUMP/"BREAK IN MID-AIR", select button when writing hiscore)

	ESC	Quit the game.


	----------------
	JOYSTICK SUPPORT
	----------------

There is a special way, you can get to play with a real joystick in this
game. Simply make a cable from a 9 pin male to a 25 pin male (from an AMIGA/
C64 joystick to a parallel connector). The pin assignment follows (I take
NO responsibility for any damage you might cause to your hardware by making
this cable):

JOYSTICK			PARALLELPORT

pin 1 ------------------------- pin 10
pin 2 ------------------------- pin 12
pin 3 ------------------------- pin 13
pin 4 ------------------------- pin 15
pin 6 ------------------------- pin 11
pin 8 ------------------------- pin 18 (GND)

You enable this control by adding a '1' parameter when starting the game
after the framerate parameter (example: BOMBJACK.EXE 1 1).

NOTE: This will only work on LPT1 (port 378h).


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

1)	Sometimes, a 'B' appears right before every 5000 points, strange..

2)	The 'bird'-monster does not seem to be seeking for Jack, instead it
	seems to seek away from him, which is wrong (compared with the real
	arcade machine.)


	------------------
	LATER IMPROVEMENTS
	------------------

1)	Sound support. I'm working on this. The BombJack-machine has 3
	AY-3-8910s (and an extra Z80 to control these) mounted and I have
	only just got a datasheet on the AY-3-8910.

2)	DIP switch selection (a menu-interface)

3)	Option for saving hiscores to disk and reloading them.


	----------------
	ACKNOWLEDGEMENTS
	----------------

 - Thanks to Thomas Scherrer and to Thomas Brask Jorgensen for lending me
   books on the Z80 processor and an EPROM-reader.

 - Thanks to Steffen Elmstrom for supplying me with a joystick->parallel-
   cable.

 - Thanks to Thomas Skellund for helping me with miscellanous tests. (This
   guy has the highest BombJack score, I have ever seen (over 16000000!!!))

 - Thanks to Niels Krogh Mortensen for letting me play his arcade BombJack
   for years.

 - And, well, thanks to anyone, I might have forgotton.

	----------------------
	TELL ME WHAT YOU THINK
	----------------------

Please e-mail me if you have comments or questions: jfrandsen@ite.dk