JROK's Arcade Simulator (JAS)  - MAPPY
=======================================

Greetings, welcome to the full release v1.00 of JAS, this program
is designed to simulate the functioning of the Namco Mappy arcade game.

This simulator is intended as an educational tool by owners of
the original game.

It should not be sold or charged for IN ANY WAY SHAPE OR FORM.
This program is freeware.

This program should not be distributed along with the ROMs.


Contents
========

- Features
- The Simulator & Development History
- Setup
- Saving & Loading Options
- Controls
- Simulator's Home Web-site
- Thanks & Credits
- Release History



Features
========

- 100% emulation of the original game
- 100% acurate colors
- 100% acurate sound emulation
- User definable playing keys
- Save & Restore Game Images
- Fast assembler based
- Windows friendly ( run's under Win'95 & NT )
- Multiple Soundcard Support



The Simulator & Development History
-----------------------------------

The simulator first started after I saw the pathetic winslows'95
version of Mappy released as a demo by Namco. It was pathetic,
even running on a fast machine the game was slow.... So it was
time to write a 'real' simulator. This simulator formed the base
for the Dig Dug 2 version.

The simulator is a mix of 'C' and assembler, the 6809E simulation
engine is 100% assembler. The surrounding support routines, i.e.
screen interface, menu etc. is all written in 'C'.

I coded the simulator over the months of May and June, the first
release being at the San Diego arcade party on June 28th. There's
even a picture of the emulator running mappy !

Both CPU's of the original board are simulated along with the
8 channel sound. All the ROMs from the original game are required
as the simulator contains NO code or data from the original game.
All graphics, colors and waveforms are converted to a usable form
'on-the-fly' within the simulator.

The following file names ARE required form the ROMS


ROM                 Size        Function                Board  Location
----------------------------------------------------------------------


MAPPY1   BIN         8,192      Game CPU Program ROM    CPU    1B 
MAPPY2   BIN         8,192      Game CPU Program ROM    CPU    1C 
MAPPY3   BIN         8,192      Game CPU Program ROM    CPU    1D 

MAPPY4   BIN         8,192      Sound CPU Program ROM   CPU    1K
MAPPY-3M BIN           256

MAPPY5   BIN         4,096      Character set ROM       VID    3B
MAPPY6   BIN         8,192      Sprite ROM 0            VID    3M
MAPPY7   BIN         8,192      Sprite ROM 1            VID    3N

MAPPY-5B BIN            32      Master color ROM        VID    5B
MAPPY-4C BIN           256      Sprite color ROM        VID    4C
MAPPY-5K BIN           256      Character color ROM     VID    5K



Controls
--------

Keys are user definable in the game, however there are some
control keys.


F10 - turns test mode on/off ( game starts in test mode F10 to exit )
Test Mode:

        left/rigjt - scroll screen
        fire one   - play tune

        F1-F3 adjust dip-switch settings as follows

        F1  - Rank Select ( higher = harder )
        F2  - Number of lives
        F3  - Bonus life options


In-Play mode:

1 - One player Start
2 - Two player Start
3 - add credit

F10 - starts test mode ( resets game )


Note: Reset clears dip-switch settings




Save Settings 
-------------

This option will save the current configuration details to the
file MAPPY.CFG these are

        - Joystick Calibration Details
        - Dip Switch Settings
        - Keyboard Controls


Save/Load Game Image
--------------------

This will save or load a complete dump of the game and current CPU state.
You can then reload this at a future time. 

File names for the 6 images are - MAP-DAT1.SAV to MAP-DAT6.SAV

You can save games in 'mid-play' and reload. Dip Switch settings
are also recorded in the .SAV files.








Thanks & Credits
----------------

Dave Spicer, 6809 help and general help.
Lee Taylor for testing & input.
Brian Peek for the save/load game image idea.
Kim Voegele testing & input.
And everyone/anyone else who's helped.



Simulator's Home Web-site
-------------------------

http://www.cyberpass.net/~jrok

Note: YOU CANNOT GET THE ROMS FROM THIS SITE !


Sites which are known to contain ROM images are:

http://www.vu.union.edu/~peekb/arcade/
ftp://ftp.tant.com




Release History
---------------

v0.01  - June 28th - San Diego arcade party special release
v1.00  - July 16th - Fully featured 100% release

