"JUST FOR FUN", yet another arcade emulator.     RELEASE 0.24
 ^    ^   ^

Just for Fun is an emulator which runs some arcade games; all of the emulations
are playable, even if no one of them could claim to be arcade perfect.


USAGE

To operate JFF just unpack the supported romsets in the corresponding
directories (that is,"AMBUSH","HIGEMARU",etc.).
Run the emulator by command line by typing:

JFF game [-s]

"-s" option is for disabling sound emulation;
"game" must be any of the following:

AIRBUST		Air Buster (aka Aero Blaster)
AMBUSH          Ambush
ARGUS           Argus
BUTASAN         Butasan
GETSTAR         Getstar
HIGEMARU        Higemaru
MNIGHT          Mutant Night
NINJAKD2        Ninja Kid II
NINJAK2A        Ninja Kid II (alternate romset)
NOVA2001        Nova 2001
OMEGAF          Omega Fighter
PSYCHIC5        Psychic 5
PKUNWAR         Penguin-Kun Wars
RAIDERS5	Raiders 5
RDACTION        Rad Action (American version of Ninja Kid 2)
ROBOKID		Atomic Robo Kid
ROLLRACE        Roller Aces
VALTRIC         Valtric
VASTAR          Vastar
XXMISS          XX Mission

You can also try running jff24.bat, which lets you choose the games from
a dos-based menu (notice: "choice" dos command should be in path).

This emulator is for plain DOS, but it will probably run under W9X; it has no
joystick support, but prelimary sound code for some games is available.


The soundblaster detection relies on a properly configured blaster
environment variable: you should have a proper statement in your autoexec
for it.

Since the sound driver is really experimental, I don't know whether it'll work
on any machine other than mine.

Since version 0.24 there's support for FM sound emulation in some games; this
is done by emulating YM2203 chip via OPL3 chip--most Sound Blasters and clones
are equipped with it. OPL3 can't really emulate the YM2203 chip, but by some
fiddling one can get reasonable sound out of it.
If you are really curious you can make a GNGSND directory and put the gg2.bin
rom from Ghosts'n Goblins in it, then run JFF with GNGSND as game name.
You can also take the sound rom from other early Capcom games and try the
emulator with it...after renaming the file to gg2.bin; "supported" games are
1943, Avengers, Black Tiger, Gunsmoke, Legendary Wings, and Section Z.

!!! IMPORTANT !!!

this emulator ISN'T TO BE DISTRIBUTED WITH ROMS...so don't ask me
for!



KEYS AND MAIN FEATURES:

If the emulator doesn't run full speed disabling vertical sync by pressing
the TAB key should help; if the speed is still unreasonable you  can resort to
go frameskipping.

Control keys:

ARROWS,ALT,CTRL         player's control
1-2                     1/2 player start
3-4                     insert coin

TAB                     toggles vertycal sync on/off

F1-F2-F3-F4             frameskip 0-3

F5                      cpu reset key

ESC                     quits emulation



SUPPORTED GAMES INFO:

### AIR BUSTER ###

ROM directory name:

AIRBUST

Rom names:


PR-11J   BIN       131,072
PR-14J   BIN       131,072
PR-21    BIN       131,072
PR-001   BIN       524,288
PR-02    BIN        65,536
PR-000   BIN       524,288
PR-200   BIN       262,144

Features:

No sound emulation.
No two player game emulation.

###  AMBUSH  ###

ROM directory name:

AMBUSH

Rom names:

AMBUSH   E7          8,192
AMBUSH   F7          8,192
AMBUSH   G7          8,192
AMBUSH   H7          8,192
AMBUSH   M4          8,192
AMBUSH   N4          8,192

Features:

Ambush emulation has got some sound support. Colors are completely made up,
because color proms weren't available when I wrote my driver.


### ARGUS ###

ROM directory name:

ARGUS

ROM names:

AG_01    BIN        16,384
AG_02    BIN        32,768
AG_03    BIN        32,768
AG_04    BIN        32,768
AG_05    BIN        32,768
AG_06    BIN        32,768
AG_07    BIN        32,768
AG_08    BIN        32,768
AG_09    BIN        32,768
AG_10    BIN        16,384
AG_11    BIN        32,768
AG_12    BIN        32,768
AG_13    BIN        32,768
AG_14    BIN        32,768
AG_15    BIN        32,768
AG_16    BIN        32,768
AG_17    BIN        32,768

Features:

No Sound.
Some color glitches. Window color have been intentionally trimmed down due to
color mapper overload. Incomplete sprite effects emulation.

### ATOMIC ROBO KID ###

ROM directory name:

ROBOKID

ROM names:

ROBOKID  12A        65,536
ROBOKID  12C        65,536
ROBOKID4 12K        65,536 ; ROM ROBOKID3.12K should be renamed this way
ROBOKID  14A        65,536
ROBOKID  14C        65,536
ROBOKID  15A        65,536
ROBOKID  15C        65,536
ROBOKID  15D        65,536
ROBOKID  15F        65,536
ROBOKID3 15K        65,536
ROBOKID  16A        65,536
ROBOKID  16C        65,536
ROBOKID  16D        65,536
ROBOKID  16F        65,536
ROBOKID  17A        65,536
ROBOKID  17C        65,536
ROBOKID  17D        65,536
ROBOKID  17F        65,536
ROBOKID  18A        65,536
ROBOKID  18C        65,536
ROBOKID  18D        65,536
ROBOKID  18F        65,536
ROBOKID1 18J        65,536
ROBOKID2 18K        65,536
ROBOKID  19C        65,536
ROBOKID  19D        65,536
ROBOKID  19F        65,536
ROBOKID  20C        65,536
ROBOKID  20D        65,536
ROBOKID  B9         32,768
ROBOKID  K7         65,536

Features:

Emulated FM sound via sound blaster OPL chip.
"Sticky sprites".
If game doesn't run, try checking the rom names.


### BUTASAN ###

ROM directory name:

BUTASAN

ROM names:

BUTA-01  BIN        65,536
BUTA-02  BIN        65,536
BUTA-03  BIN        65,536
BUTA-04  BIN        32,768
BUTA-05  BIN        65,536
BUTA-06  BIN        65,536
BUTA-07  BIN        65,536
BUTA-08  BIN        32,768
BUTA-09  BIN        65,536
BUTA-10  BIN        65,536
BUTA-11  BIN        65,536
BUTA-12  BIN        65,536
BUTA-13  BIN        65,536
BUTA-14  BIN        65,536
BUTA-15  BIN        65,536
BUTA-16  BIN        65,536
BUTA-01  PRM           256
BUTA-02  PRM           256

Features:

No sound emulation.
No two players game.
(Some) colors are wrong for sure. I don't know how much...feedback from people
who have played the real thing is appreciated!

Notes:

I have never seen Butasan in the arcades, but I was motivated to emulate it
because it was made by the team behind Psychic 5.
"Butasan" can be roughly translated as "Mr. Pig"; surprisingly enough the
weird game has been converted to CBM64 and other 8 bit machines under the name
"Psycho Pigs UXB"(!).


### GETSTAR ###

Rom directory name:

GETSTAR

Rom names:

GS_05    ROM         8,192
GS_02    ROM        32,768
GS_03    ROM        32,768
GS_04    ROM        32,768
GS_01    ROM        32,768
GS_06    ROM        32,768
GS_07    ROM         8,192
GS_08    ROM         8,192
GS_09    ROM        32,768
GS_10    ROM        32,768
GS_11    ROM        32,768
GS_12    ROM        32,768
GS_13    ROM        16,384
GS_14    ROM        16,384

Features:

Colors are hand made, I need color proms to fix them!

### HIGEMARU ###

ROM directory name:

HIGEMARU

Rom names:

HG1                  8,192
HG2                  8,192
HG3                  8,192
HG4                  8,192
HG5                  8,192
HG6                  8,192
HG7                  8,192
HGB1                   256
HGB3                    32
HGB5                   256

Features:

Higemaru emulation has got sound support.

Notes:

I emulated this game because I was really curious to play one of the first games
ever made by Capcom.

### MUTANT NIGHT ###

ROM directory name:

MNIGHT

Rom names:

MN13-B23 BIN        65,536
MN11-B20 BIN        65,536
MN12-B22 BIN        65,536
MN10-B10 BIN        32,768
MN1-J7   BIN        65,536
MN2-J12  BIN        32,768
MN3-J14  BIN        32,768
MN4-J16  BIN        32,768
MN5-J17  BIN        32,768
MN6-J19  BIN        32,768
MN7-E11  BIN        65,536
MN8-E12  BIN        65,536
MN9-E14  BIN        65,536

Features:

Emulated FM sound via sound blaster OPL chip.
If the rom check fails (this will happen if the bad dump is used)
press fire button to skip it.


### NINJAKID II ### 

ROM directory name:

NINJAKD2

Rom names:

NK2_08   ROM        65,536
NK2_12   ROM        32,768
NK2_11   ROM        65,536
NK2_10   ROM        65,536
NK2_09   ROM        65,536
NK2_07   ROM        65,536
NK2_06   ROM        65,536
NK2_05   ROM        32,768
NK2_04   ROM        32,768
NK2_03   ROM        32,768
NK2_02   ROM        32,768
NK2_01   ROM        32,768

ROM directory name:

NINJAK2A

Rom names:

NK2_08   BIN        65,536
NK2_12   BIN        32,768
NK2_11   BIN        65,536
NK2_10   BIN        65,536
NK2_09   BIN        65,536
NK2_07   BIN        65,536
NK2_06   BIN        65,536
NK2_05   BIN        32,768
NK2_04   BIN        32,768
NK2_03   BIN        32,768
NK2_02   BIN        32,768
NK2_01   BIN        32,768


Features:

No sound emulation.
Due to experimental color mapping code the emulation is still slow, even if
a P133 is more than enough.


### NOVA 2001 ###

ROM directory name:

NOVA2001

ROM names:

NOVA2001 1           8,192
NOVA2001 2           8,192
NOVA2001 3           8,192
NOVA2001 4           4,096
NOVA2001 5           8,192
NOVA2001 6           8,192
NOVA2001 7           8,192
NOVA2001 8           8,192
NOVA2001 CLR            32

Features:

"Full" emulation.

### OMEGA FIGHTER ###

ROM directory name:

OMEGAF

ROM names:

1BACK2   15B       524,288
2BACK1   27B       524,288
3BACK3   5F        524,288
4        18H        32,768
5        3L        131,072
6        4L        131,072
7        7M         65,536
8        23M       131,072

Features:

Emulated FM sound via sound blaster OPL chip.
No two player game emulation.


### PENGUIN KUN WARS ###

ROM directory name:

PKUNWAR

ROM names:

PKWAR    01R        16,384
PKWAR    01Y        16,384
PKWAR    02R        16,384
PKWAR    02Y        16,384
PKWAR    03R         8,192
PKWAR    03Y        16,384
PKWAR    04Y        16,384
PKWAR    COL            32

Features:

"Full" emulation.


### PSYCHIC 5 ###

ROM directory name:

PSYCHIC5

ROM names:

P5A                 65,536
P5B                 65,536
P5C                 65,536
P5D                 32,768
P5E                 65,536
P5F                 32,768
P5G                 65,536
P5H                 65,536

Features:

No sound,of course...
Demo still doesn't play right; window scrolling is not emulated (but you will
notice that only if you finish the game).
By the way...color effects emulation (SW button,grey screen etc.) is completely
arbitrary (and very slow); information on what PRECISELY should happen would be
appreciated.


### RAD ACTION ###

ROM directory name:

RDACTION

ROM names:

2        3S         32,768
1        3U         32,768
NK2_03   ROM        32,768
NK2_04   ROM        32,768
NK2_05   ROM        32,768
NK2_06   ROM        65,536
NK2_07   ROM        65,536
NK2_08   ROM        65,536
NK2_09   ROM        65,536
NK2_10   ROM        65,536
NK2_11   ROM        65,536
12       5N         32,768

Features:

Rad Action is Ninja Kid 2 American version.

### RAIDERS 5 ###

ROM directory name:

RAIDERS5

ROM names:

RAIDERS5 1          16,384
RAIDERS5 2          16,384
RAIDERS5 3          16,384
RAIDERS5 4          16,384
RAIDERS5 5          16,384

Features:

I doubt everything is in place...most things surely are, anyway.


### ROLLER ACES ###

ROM directory name:

ROLLRACE

ROM names:

1        17A         8,192
1        8K          8,192
1        9M          8,192
10       17T         8,192
11       18M         8,192
12       18P         8,192
13       18T         8,192
14       19M         8,192
15       19P         8,192
16       19T         8,192
2        17C         8,192
2        8H          8,192
2        8M          8,192
3        18A         8,192
3        7M          8,192
3        8F          8,192
4        18C         8,192
4        8D          8,192
5        20F         8,192
6        20J         8,192
7        18J         8,192
8        17M         8,192
8        6E          4,096
9        17P         8,192
TBP24S10 6T            256
TBP24S10 7T            256
TBP24S10 7U            256

Features:

No sound effects. Some little troubles with tiles.

Notes: 

The original game has been developed by Kaneko.

### VALTRIC ###

ROM directory name:

VALTRIC

ROM names:

VT_01    BIN        32,768
VT_02    BIN        65,536
VT_03    BIN        65,536
VT_04    BIN        32,768
VT_05    BIN        65,536
VT_06    BIN        65,536
VT_07    BIN        32,768
VT_08    BIN        65,536
VT_09    BIN        65,536
VT_10    BIN        65,536
VT_11    BIN        65,536

Features:

No sound emulation.

Notes:

Valtric inspired the very well known 16 bit game Xenon by Bitmap Brothers.

### VASTAR ###

ROM directory name:

VASTAR

ROM names:

C_C9     ROM         8,192
C_F7     ROM         8,192
C_F9     ROM         8,192
C_N4     ROM         8,192
C_S4     ROM         8,192
E_F2     ROM         4,096
E_F4     ROM         4,096
E_H4     ROM         4,096
E_J2     ROM         4,096
E_J4     ROM         4,096
E_K4     ROM         4,096
E_L4     ROM         4,096
E_N4     ROM         4,096
E_N5     ROM         4,096
E_N7     ROM         4,096
TBP24S10 6M            256
TBP24S10 6P            256
TBP24S10 6S            256

Features:

No sound emulation.

### XX MISSION ###

ROM directory name:

XXMISS

Rom names:

XX11     4B	    32,768
XX2      4B	    16,384	
XX10     4C         32,768
XX1      4L         32,768
XX3      6A         32,768
XX4      6B         32,768
XX5      6D         32,768
XX9      8E         32,768
XX8      8F         32,768
XX7      8H         32,768
XX6      8J         32,768


Features:

Some funny CPU sync problems ("water shoots" on dry land).
50 Hz update instead of 60 Hz due to resorting to strange vid-mode. 
No sound emulation.


HISTORY:

V0.24   Added support for Penguin-Kun Wars. FM sound emulation in Atomic
        Robo Kid, Omega Fighter and Mutant Night.        
V0.23   Added support for Argus, Omega Fighter and Roller Aces.
V0.22   Added support for Butasan, Nova 2001 and Valtric.
V0.21   Added support for Rad Action(!), Atomic Robo Kid and Raiders 5.
V0.20   Added Air Buster support.
V0.19   Added XX Mission support.
V0.18   Switched to PMode dos Xtender. Added Mutant Night support.
        Some improvements in game hardware emulation.
V0.16	Added Getstar support. Fixed Higemaru sound speed.
V0.15   Added Higemaru support; demo game is now playing in Psychic 5.
V0.14b	New complete Psychic 5 romset support. Improved Psychic 5 emulation.
	Improved (?) Ambush sound driver compatibility.
V0.14   Added Psychic 5 support. Fixed reset bug in Ninja Kid 2.
V0.12   NinjaKid II support. Ambush sound bugfix.
V0.11   Sound support for Ambush emulation.
V0.10   First release.

         

THANKS TO

Simone Zanella for JFF home page
Till Oldemeyer-I would have never spotted that Youkai Douchuuki was Shadowland!
The Guru for providing unemulated romsets
Adam Seychell for DOS32 fab DOS Xtender (what's his e-mail?)
Tran for PMode dos Xtender
Cabbe for dumping Getstar and NinjaKun 2 romsets
Arcade Roms from Japan for dumping most of the games JFF emulates
People who dumped Ambush, Higemaru, Nova 2001 and Vastar
Gareth Hall for dumping the full Psychic 5 romset 
Ricardo Fdez Vega for (re)dumping Mutant Night
Ishmair for Z80 emulator
Anton Belenki for drawing the smart Just For Fun Icon
Rob van der Drift for sending me jff batch file
Anyone wrote me giving feedback

JFF has now got an official home page:
http://www.retroplay.com/Mecenate/jff

Ambush, Vastar etc. fans can contact me at my e-mail address:

Rob.	Roberto Ventura jdoe@galactica.it


P.S.    Any feedback on sound (i.e. proper SB detection and all that) is
        appreciated!

P.P.S   Weird games I'm looking for:
                                Boggy 84		??? 1984
                                Ninja Kid/Ninja Kun	UPL 1984
				Portraits		Olympia 1984
                                Rougien			??? 1983?
                                Wyvern Fq               Taito 1986

