Raine (MC680x0 based arcade emulator) v0.11 (c)1998 [J3d!] ========================================================== What is this? ------------- This is my humble attempt to emulate a few 680x0 arcade games. I've been learning C and 80x86 asm as I go (one of my main reasons for doing this). For now, the focus is on the Taito 680x0 based systems (most of Taito's games from 1987-1995). Sound is missing in most games still, but don't be mad, Raine didn't cost you anything... For 68000 emulation, Raine uses the Starscream engine, by Neill Corlett. For 68020 emulation, Raine uses the UAE 68020 engine, by Bernd Schmidt. For Z80 emulation, Raine uses Marat Fayzullin's engine (for now). Requirements ------------ Estimated requirements for this to be of any use: * Pentium Class Processor * 16Mb+ of ram * Win95/DOS * Gfx card, VESA2+ support preferred * Compatible arcade romsets If you only have a 486, it should be ok for the less demanding games. Here is a snippet of an email I got from Victor Epitropou: "You probably haven't checked Raine on anything below a Pentium...so you'll probably be very glad to know that the games you have provided with [Idle 68000 skipping] run VERY WELL on my 486DX/50 with 8 MB RAM! (And NO windows 95!). No kidding! You can safely write this down in the raine.txt file next time..." It was very nice to hear that, although Raine never gets tested on a 486 it sounds like it runs well. Installing roms --------------- Before playing any game, you need to find the correct romset. When you find this, unzip it to the correct sudirectory (eg. c:\raine\wrestlef). These sub-dirs should exist if you unzipped raine correctly... Zip Support ----------- You can place pkzipped copies of the romsets in the ziproms subdir (eg. c:\raine\ziproms) Raine will then access the zip to load the roms, saving a lot of diskspace. For this to work, you *must* have pkunzip somewhere in your dos path (eg. in c:\windows\command). You can put pkunzip in the same dir as raine if you want, that should be fine too. Warning: If you use Zipmagic please disable it if you wish to use the zipped roms support. Command Line Usage ------------------ USE: Raine -g [Game] -v [VidMode] -l -n ŝ Supported Games: 0 ArmedF (Armed Formation) 1 BonzeAdv (Bonze's Adventure) 2 Cadash (Cadash) 3 DoubleD3 (Double Dragon 3) 4 EAction2 (Elevator Action 2) 5 FinalB (Final Blow) 6 MasterW (Master of Weapons) 7 MegaB (Mega Blast) 8 Gaiden (Ninja Gaiden) 9 NinjaK (Ninja Kids) 10 NinjaW (Ninja Warriors) 11 OThunder (Operation Thunderbolt) 12 OpWolf (Operation Wolf) 13 OpWolfbl (Operation Wolf (Bootleg)) 14 PBobble2 (Puzzle Bobble 2) 15 RainbowE (Rainbow Islands (Extra)) 16 Rainbow (Rainbow Islands (Original))17 Rastan (Rastan) 18 SnowBros (Snow Bros) 19 SpaceGun (Space Gun) 20 Ssi (Super Space Invaders) 21 TerraC (Terra Cresta) 22 TerraF (Terra Force) 23 Toki (Toki) 24 TwinQix (Twin Qix) 25 WrestleF (WrestleFest) 26 ZeroZone (Zero Zone) ŝ Supported VideoModes (default=Autodetect): 0 - 320x240x8bpp (VESA2L) 1 - 640x480x8bpp (VESA2L) 2 - 320x240x8bpp (MODEX) 3 - 400x300x8bpp (VESA2L) -l - Limit Engine speed (for fast PCs) -n - No GUI (for frontends) Other options are available only from the GUI/config file for now. Example: raine -g wrestlef -v 0 (this will attempt to run WrestleFest in a 320x240 screen). ** If you get VESA2 errors, you need to get Scitech Display Doctor from ** www.scitechsoft.com. Don't expect a reply if you mail me asking about ** this. Use the gui for a larger selection of screen modes, including non ** VESA. GUI Usage --------- Just type raine and the gui should pop up. From here you can choose: Play Game: Play whatever game is currently loaded. Change Game: Change the currently loaded game. Change Keys: Redefine the keys for the current game. Screen Mode: Change the screenmode to use. Supports a huge number of modes now (same modes as Snes9x DOS). Dipswitches: Change Dipswitch settings for the current game. About Raine: Small message. Quit Raine: Return to the real world. Generic Controls ---------------- The following functions are available for all games: 0 - Save Screen Snapshot (named raine???.pcx) F2 - Save Game State F4 - Load Game State F11 - Toggle FPS Text PgUp - Increase Frame Skip (when FrameSkip=Manual) PgDn - Decrease Frame Skip (when FrameSkip=Manual) ESC - Return to GUI/DOS F3 System --------- For the Taito F3-System games: F5 - Toggle BG0 Layer F6 - Toggle BG1 Layer F7 - Toggle BG2 Layer F8 - Toggle BG3 Layer F9 - Toggle Sprite Layer F10 - Toggle FG0 Layer (Other layers are always on). For Twin Qix, when the background is green, press F8 to disable it. This is due to transparencies (which aren't implemented). For Puzzle Bobble 2, press F10 for similar reasons (transparenies). F3 System is 32-bit and very powerful, the emulation is just started! Game Information ---------------- Dir Name | Playable | Full Name | Company | Year | System | Dumper | Information ---------+----------+----------------------------+------------+------+--------+---------+--------------------------------- ArmedF | Yes | Armed Formation | Nichibutsu | 1988 | | AraCorn | BonzeAdv | Mostly | Bonze's Adventure | Taito | 198x | | malcor | c-chip protection Cadash | Yes | Cadash | Taito | 1989 | | malcor | DoubleD3 | Yes | Double Dragon 3 | Technos | 1990 | Tech1 | ShinobiZ| Eaction2 | Yes | Elevator Action 2 | Taito | 1994 | F3-Sys | PowerJaw| playable, but gfx need work FinalB | Yes | Final Blow | Taito | 1988 | F2-Sys | AraCorn | MasterW | Partially| Master of Weapons | Taito | 19xx | B-Sys | ? | very glitchy/bitchy sprites MegaB | Yes | Mega Blast | Taito | 1989 | F2-Sys | malcor | Gaiden | Yes | Ninja Gaiden | Tecmo | 1988 | | ? | NinjaK | Yes | Ninja Kids | Taito | 1990 | F2-Sys | AraCorn | occasional sprite glitch NinjaW | Yes | Ninja Warriors | Taito | 1987 | Dual | malcor | OThunder | Yes | Operation Thunderbolt | Taito | 1988 | | malcor | OpWolf | Yes | Operation Wolf | Taito | 1987 | | NAZ! | OpWolfBl | Yes | Operation Wolf (Bootleg) | Bear | 1987 | | ShinobiZ| bootleg with c-chip dumped; playable PBobble2 | Yes | Puzzle Bobble 2 | Taito | 1995 | F3-Sys | AraCorn | playable, but gfx need work RainbowE | Partially| Rainbow Islands (Extra) | Taito | 1988 | | AraCorn | c-chip protection Rainbow | Partially| Rainbow Islands (Original) | Taito | 1987 | | G.Hall | c-chip protection Rastan | Yes | Rastan | Taito | 1987 | | ? | SnowBros | Yes | SnowBros | Romstar | 1990 | | ? | SpaceGun | Yes | Space Gun | Taito | 1990 | Dual | malcor | Ssi | Yes | Super Space Invaders | Taito | 1991 | F2-Sys | AraCorn | TerraC | Yes | Terra Cresta | Nichibutsu | 1985 | | J-Rom | sprite colours wrong, rest is fine TerraF | Yes | Terra Force | Nichibutsu | 1987 | | J-Rom? | Toki | Yes | Toki | Datsu | 1990 | | D.Winter| bootleg, orig by Fabtek TwinQix | Yes | Twin Qix | Taito | 1995 | F3-Sys | PowerJaw| playable, but gfx need work WrestleF | Yes | WrestleFest | Technos | 1991 | Tech1 | AraCorn | ZeroZone | Yes | Zero Zone | Comad | 1993 | | AraCorn | Systems ------- System | Main CPUs | Sound CPUs | Info -------+-----------+------------+----------------------------- Tech1 | 68000 | Z80 | Technos System; name unknown B-Sys | 68000 | Z80 | Taito B System F2-Sys | 68000 | Z80 | Taito F2 System Dual | 68000 x 2 | (Z80) | Dual 68000 Systems (some have no Z80) F3-Sys | 68020 | 68000 | Taito F3 System Version History --------------- v0.11a: - Much faster zooming routines (Operation Thunderbolt/Space Gun). - Idle 68000 skipping in virtually all games (gives speed increase). - Removed UAE 68000 engine (all 68000 games are Starscream'ed now). - Inserted UAE 68020 engine (Taito F3-System). - Inserted Marat Z80 engine (For Op Wolf bootleg c-chip, I'll use a faster one soon). - Early Sound (adpcm samples only) for WrestleFest, Double Dragon 3, Zero Zone. - Mouse support (Op Wolf, Op Thunderbolt, Space Gun). - Joystick support (hopefully it works...). - Dipswitch support for some games (early, but seems ok). - Simple Save/Load support (F2/F4), Toggle FPS (F11). - Auto frame skipping, scanlines hack, less ugly gui. - Compiled with Allegro WIP beta, this adds vesa3 and vbe/af drivers for screen selection. - Added Following games: . Space Gun (dumped by malcor; playable; Dual 68000) . Ninja Warriors (dumped by malcor; playable; Dual 68000) . Double Dragon 3 (dumped by Thierry Lescott; playable) . Operation Wolf (dumped by NAZ!; playable) . Operation Wolf bootleg (dumped by Thierry Lescott; bootleg; playable) . Elevator Action 2 (dumped by 'PowerJaw'; playable but messy) . Twin Qix (dumped by 'PowerJaw'; playable but messy) . Puzzle Bobble 2 (dumped by araCORN; playable but messy) - Other various cleanups/optimizations not worth mentioning (all games are faster)... v0.10: - Added a little gui for Game Select/Key Select/Screen Select etc... - Zipped roms support. - Added detection and skipping for idle 68000 cycles in: WrestleFest, Rainbow Islands and Rastan (all have speed increase). - Added Following games: . Bonze Adventure (c-chip, so not playable) . Cadash (playable) . Final Blow (playable) . Master of Weapons (messy sprites) . Mega Blast (playable) . Ninja Kids (playable but messy sprites) . Ninja Gaiden (playable) . Operation Thunderbolt (playable) . Super Space Invaders'91 (playable) . Zero Zone (playable) - Improvements to the following games: . Armed Formation: Added second BG layer, fixed sprites, colours, Player2 controls mapped. . Snow Bros: New Starscream fixes monster movement problem, full asm for screen redraw by Cedrick Collomb. . Terra Force: Fixed sprites, scrolling, colours. . Toki: Fixed Screen Size. . WrestleFest: Fixed Timing problem, which in turn fixes stuff like Match Select screen. - Data East games taken out (see xdragon) - Bionic Commando taken out (see slutte!) - Superman taken out (corrupt rom...) v0.09-v0.06: - Old versions... Help ---- If you can help with: YM2151/YM2610/C-Chip info or any Taito (esp. F2/F3-System) romsets, please contact me! Most wanted romsets are Liquid Kids and Bubble Bobble 3... Thanks for reading! Thanks ------ Special thanks to everyone who gave such positive feedback after the first preview and everyone who has helped me especially (in no order/incomplete): * Bryan McPhail * Cedrick Collomb * AraCorn & Org * Mike Coates * Neill Corlett * Freeplay * Gareth Hall * J-Rom * Magnus Danielsson * Conjurer * Riddler * Mário Silva * DarkForce * zsKnight * Malcor * DaemoN * David Winter * NAZ! * Nicolas Hamel * FreakShow * Beta Testers Thanks everyone to mailed me with info, support, romsets (esp. araCORN for the Taito romsets!). Misc ---- The following were used in this experiment: Djgpp (gcc v2.8) by DJ Delorie StarScream 68000 Engine v0.24 by Neill Corlett UAE 68020 Engine by Bernd Schmidt Marat Fayzullin's Z80 Engine Allegro v3.0+WIP by Shawn Hargreaves Nasm v0.96 IRA (Amiga) UltraEdit32 v5.10a by Ian D Mead SearchR2 beta by me The 6x8 font is Xen6.font (Amiga). Contact ------- Programmer: Richard Bush [J3d!] rbush@geocities.com (anything technical, romsets, donations?!). Support: Mario Silva (Scifi) mrsilva@mail.telepac.pt (anything else, he does the the www site and faq now, plus a lot of coordination with beta testers). Official Site: http://raine.retrogames.com (new releases appear here first) Related Sites ------------- Retrogames http://www.retrogames.com (roms are available at this site!) .................................. Emuviews http://www.emuviews.com (roms are available at this site!) .................................. Dave's Videogame Classics http://www.davesclassics.com (roms are available at this site!) .................................. Arcade Rom Heaven http://www.guruchoc.threadnet.com (roms are available at this site!) ..................................