home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / www / martinc / emulators / binary / amame020.lzx / AMame_Release / readme.txt < prev    next >
Text File  |  2004-10-28  |  38KB  |  1,128 lines
  1.  
  2.                                 M A M E
  3.  
  4.                     Multiple Arcade Machine Emulator
  5.  
  6.                   by Nicola Salmoria (MC6489@mclink.it)
  7.                  and Mirko Buffoni (mix@lim.dsi.unimi.it)
  8.  
  9. Important note:  from now on I, Mirko, am the coordinator of project MAME.
  10. I created a new account address for those of you who intend to contribute to
  11. MAME with drivers, or bug fixes.  The address is  "mame@lim.dsi.unimi.it".
  12. If you have personal mails (requests or other) send them to my standard
  13. e-mail address.  Thank you for collaboration.
  14.  
  15. Please note that many people helped with this project, either directly or
  16. by making source code available which I examined to write the drivers. I am
  17. not trying to appropriate merit which isn't mine. See the acknowledgemnts
  18. section for a list of contributors.
  19.  
  20.  
  21. Here is a quick list of ther currently supported games; read on for details.
  22. The list doesn't include variants of the same game.
  23.  
  24.  
  25. ==============================================================================
  26. |                             |        |Accurate|        |Hi score| Directory|
  27. | Game Name                   |Playable| colors | Sound  |  save  |   Name   |
  28. ==============================================================================
  29. | 1942                        |  Yes   |  Yes   |  Yes   |  Yes   | 1942     |
  30. |-----------------------------|--------|--------|--------|--------|----------|
  31. | Amidar                      |  Yes   | Close  |  Yes   |   No   | amidar   |
  32. |-----------------------------|--------|--------|--------|--------|----------|
  33. | Arabian                     |  Yes   |   No   |  Yes   |   No   | arabian  |
  34. |-----------------------------|--------|--------|--------|--------|----------|
  35. | Bagman                      |  Yes   |   No   | Music  |   No   | bagman   |
  36. |-----------------------------|--------|--------|--------|--------|----------|
  37. | Bomb Jack                   |  Yes   |  Yes   |  Yes   |  Yes   | bombjack |
  38. |-----------------------------|--------|--------|--------|--------|----------|
  39. | Burger Time                 |  Yes   |  Yes   |  Yes   |  Yes   | btime    |
  40. |-----------------------------|--------|--------|--------|--------|----------|
  41. | Carnival                    |  Yes   | Maybe  |   No   |   No   | carnival |
  42. |-----------------------------|--------|--------|--------|--------|----------|
  43. | Centipede                   |  Yes   |   No   |  Yes   |  Yes   | centiped |
  44. |-----------------------------|--------|--------|--------|--------|----------|
  45. | Congo Bongo                 |  Yes   |   No   |   No   |  Yes   | congo    |
  46. |-----------------------------|--------|--------|--------|--------|----------|
  47. | Crazy Climber               |  Yes   |  Yes   |  Yes   |  Yes   | cclimber |
  48. |-----------------------------|--------|--------|--------|--------|----------|
  49. | Crazy Kong                  |  Yes   |  Yes   |  Yes   |  Yes   | ckong    |
  50. |-----------------------------|--------|--------|--------|--------|----------|
  51. | Crush Roller                |  Yes   |  Yes   |  Yes   |  Yes   | crush    |
  52. |-----------------------------|--------|--------|--------|--------|----------|
  53. | Donkey Kong                 |  Yes   | Close  | Yes(1) |  Yes   | dkong    |
  54. |-----------------------------|--------|--------|--------|--------|----------|
  55. | Donkey Kong Jr.             |  Yes   | Close  |   No   |  Yes   | dkongjr  |
  56. |-----------------------------|--------|--------|--------|--------|----------|
  57. | Donkey Kong 3               |  Yes   |   No   |   No   |  Yes   | dkong3   |
  58. |-----------------------------|--------|--------|--------|--------|----------|
  59. | Elevator Action - Bootleg   |  Yes   |   No   |   No   |  n/a   | elevator |
  60. |-----------------------------|--------|--------|--------|--------|----------|
  61. | Elevator Action - Original  |   No   |   No   |   No   |   No   | elevatob |
  62. |-----------------------------|--------|--------|--------|--------|----------|
  63. | Fantasy                     |   No   |   No   |   No   |   No   | fantasy  |
  64. |-----------------------------|--------|--------|--------|--------|----------|
  65. | Frogger                     |  Yes   | Close  |  Yes   |   No   | frogger  |
  66. |-----------------------------|--------|--------|--------|--------|----------|
  67. | Galaxian                    |  Yes   |  Yes   | Limited|  Yes   | galaxian |
  68. |-----------------------------|--------|--------|--------|--------|----------|
  69. | Gorf                        |   No   |   No   |   No   |  n/a   | gorf     |
  70. |-----------------------------|--------|--------|--------|--------|----------|
  71. | Green Beret                 |  Yes   |  Yes   |  Yes   |  Yes   | gberet   |
  72. |-----------------------------|--------|--------|--------|--------|----------|
  73. | Gyruss                      |  Yes   | Close  | Yes(1) |  Yes   | gyruss   |
  74. |-----------------------------|--------|--------|--------|--------|----------|
  75. | "Japanese Irem game"        |  Yes   |  Yes   | Limited|   No   | japirem  |
  76. |-----------------------------|--------|--------|--------|--------|----------|
  77. | Jump Bug                    |  Yes   |   No   |  Yes   |   No   | jumpbug  |
  78. |-----------------------------|--------|--------|--------|--------|----------|
  79. | Jungle King                 |  Yes   |   No   |   No   |   No   | junglek  |
  80. |-----------------------------|--------|--------|--------|--------|----------|
  81. | Krull                       |  Yes   |  Yes   |   No   |  n/a   | krull    |
  82. |-----------------------------|--------|--------|--------|--------|----------|
  83. | Lady Bug                    |  Yes   |  Yes   |  Yes   |  Yes   | ladybug  |
  84. |-----------------------------|--------|--------|--------|--------|----------|
  85. | Lost Tomb                   |   No   |   No   |  Yes   |  n/a   | losttomb |
  86. |-----------------------------|--------|--------|--------|--------|----------|
  87. | Mario Bros.                 |  Yes   | Close  |   No   |  Yes   | mario    |
  88. |-----------------------------|--------|--------|--------|--------|----------|
  89. | Mad Planets                 |  Yes   |  Yes?  |   No   |   No   | mplanets |
  90. |-----------------------------|--------|--------|--------|--------|----------|
  91. | Millipede                   |  Yes   |   No   |   No   |  Yes   | milliped |
  92. |-----------------------------|--------|--------|--------|--------|----------|
  93. | Moon Cresta                 |  Yes   |  Yes   | Limited|  Yes   | mooncrst |
  94. |-----------------------------|--------|--------|--------|--------|----------|
  95. | Moon Patrol                 |  Yes   |   No   |   No   |   No   | mpatrol  |
  96. |-----------------------------|--------|--------|--------|--------|----------|
  97. | Moon Quasar                 |  Yes   |  Yes   | Limited|  Yes   | moonqsr  |
  98. |-----------------------------|--------|--------|--------|--------|----------|
  99. | Mouse Trap                  |Partial.|   No   |   No   |   No   | mtrap    |
  100. |-----------------------------|--------|--------|--------|--------|----------|
  101. | Mr. Do!                     |  Yes   |  Yes   |  Yes   |  Yes   | mrdo     |
  102. |-----------------------------|--------|--------|--------|--------|----------|
  103. | Mr. Do's Castle             |   No   |   No   |   No   |  n/a   | docastle |
  104. |-----------------------------|--------|--------|--------|--------|----------|
  105. | Ms Pac Man (bootleg)        |  Yes   |  Yes   |  Yes   |  Yes   | mspacman |
  106. |-----------------------------|--------|--------|--------|--------|----------|
  107. | Nibbler                     |  Yes   |   No   |   No   |  Yes   | nibbler  |
  108. |-----------------------------|--------|--------|--------|--------|----------|
  109. | Pac Man                     |  Yes   |  Yes   |  Yes   |  Yes   | pacman   |
  110. |-----------------------------|--------|--------|--------|--------|----------|
  111. | Pengo                       |  Yes   |  Yes   |  Yes   |  Yes   | pengo    |
  112. |-----------------------------|--------|--------|--------|--------|----------|
  113. | Pepper II                   |Partial.|   No   |   No   |   No   | pepper2  |
  114. |-----------------------------|--------|--------|--------|--------|----------|
  115. | Phoenix                     |  Yes   | Close  | Yes(1) |   No   | phoenix  |
  116. |-----------------------------|--------|--------|--------|--------|----------|
  117. | Pisces                      |  Yes   |  Yes   | Limited|   No   | pisces   |
  118. |-----------------------------|--------|--------|--------|--------|----------|
  119. | Pleiads                     |  Yes   |   No   | Limited|   No   | pleiads  |
  120. |-----------------------------|--------|--------|--------|--------|----------|
  121. | Pooyan                      |  Yes   |   No   |  Yes   |  Yes   | pooyan   |
  122. |-----------------------------|--------|--------|--------|--------|----------|
  123. | Popeye - Bootleg            |  Yes   |  Yes   |  Yes   |  Yes   | popeyebl |
  124. |-----------------------------|--------|--------|--------|--------|----------|
  125. | Q*Bert                      |  Yes   |  Yes   | Yes(1) |   No   | qbert    |
  126. |-----------------------------|--------|--------|--------|--------|----------|
  127. | Rally X                     |  Yes   |   No   |Partial.|   No   | rallyx   |
  128. |-----------------------------|--------|--------|--------|--------|----------|
  129. | Scramble                    |  Yes   |  Yes   |  Yes   |   No   | scramble |
  130. |-----------------------------|--------|--------|--------|--------|----------|
  131. | Seicross                    |   No   |   No   |  Yes   |  n/a   | seicross |
  132. |-----------------------------|--------|--------|--------|--------|----------|
  133. | Space Invaders              |  Yes   |  Yes   | Yes(1) |  Yes   | invaders |
  134. |-----------------------------|--------|--------|--------|--------|----------|
  135. | Space Panic                 |  Yes   | Close  |   No   |  Yes   | panic    |
  136. |-----------------------------|--------|--------|--------|--------|----------|
  137. | Super Cobra                 |  Yes   |   No   |  Yes   |   No   | scobra   |
  138. |-----------------------------|--------|--------|--------|--------|----------|
  139. | The Adventures of Robby Roto|   No   |   No   |   No   |  n/a   | robby    |
  140. |-----------------------------|--------|--------|--------|--------|----------|
  141. | The End                     |  Yes   |   No   |  Yes   |   No   | theend   |
  142. |-----------------------------|--------|--------|--------|--------|----------|
  143. | Time Pilot                  |  Yes   | Close  |  Yes   |  Yes   | timeplt  |
  144. |-----------------------------|--------|--------|--------|--------|----------|
  145. | Turtles                     |  Yes   | Close  |  Yes   |   No   | turtles  |
  146. |-----------------------------|--------|--------|--------|--------|----------|
  147. | Vanguard                    |  Yes   |   No   |   No   |   No   | vanguard |
  148. |-----------------------------|--------|--------|--------|--------|----------|
  149. | Venture                     |Partial.|   No   |   No   |   No   | venture  |
  150. |-----------------------------|--------|--------|--------|--------|----------|
  151. | War of the Bugs             |  Yes   |   No   | Limited|   No   | warofbug |
  152. |-----------------------------|--------|--------|--------|--------|----------|
  153. | Warp Warp                   |  Yes   |   No   |   No   |  n/a   | warpwarp |
  154. |-----------------------------|--------|--------|--------|--------|----------|
  155. | Wizard of Wor               |  Yes   | Maybe  |   No   |   No   | wow      |
  156. |-----------------------------|--------|--------|--------|--------|----------|
  157. | Zaxxon                      |  Yes   | Close  |   No   |  Yes   | zaxxon   |
  158. |-----------------------------|--------|--------|--------|--------|----------|
  159.  
  160. (1) Need samples provided separately
  161.  
  162.  
  163.  
  164. 1942 ("1942")
  165. =============
  166. Arrows  Move around
  167. CTRL    Fire
  168. ALT     Air Routing
  169.  
  170.  
  171.  
  172. Amidar ("amidar")
  173. =================
  174. Arrows  Move around
  175. CTRL    Jump
  176.  
  177. Clones supported:
  178.   Japanese version ("amidarjp"). This version has a worse attract mode and
  179.                                  does not display the number of jumps left.
  180. Known issues:
  181. - What do the dip switches do?
  182.  
  183.  
  184.  
  185. Arabian ("arabian")
  186. ===================
  187. Arrows  Move around
  188. CTRL    Kick
  189. F1      Enter test mode
  190.  
  191.  
  192.  
  193. Bagman ("bagman")
  194. =================
  195. Arrows  Move around
  196. CTRL    Action
  197.  
  198.  
  199.  
  200. Bomb Jack ("bombjack")
  201. ======================
  202. Arrows  Move around
  203. CTRL    Jump
  204.  
  205. Press fire to skip the ROM/RAM test at the beginning.
  206.  
  207. In the dip switch menu, DIFFICULTY 1 refers to the speed of the mechanical
  208. bird, while DIFFICULTY 2 to the number and speed of enemies.
  209. SPECIAL refers to how often the (E) and (S) coins appear.
  210.  
  211. Known issues:
  212. - Colors are accurate, but not entirely: the original machine uses 12 bits
  213.   (4 bits per pen), while I currently use only 8 bits (3 bits for red and
  214.   green, 2 bits for blue).
  215. - There is a bit in the sprite attributes which I don't know what means:
  216.   it seems to be set only when the (B) materializes.
  217. - The INITIAL HIGH SCORE setting doesn't only set that, it does something
  218.   else as well - but I don't know what.
  219.  
  220.  
  221.  
  222. Burger Time ("btime")
  223. =====================
  224. Arrows  Move around
  225. CTRL    Pepper
  226. F1      \  Various tests.
  227. F2      |  Use F1 to cycle through tests while in test mode.
  228. F1+F2   /
  229.  
  230. Clones supported:
  231.   different ROM set, without Midway copyright and different demo ("btimea")
  232.  
  233. Known issues:
  234. - The way I turn sprites off is not correct.
  235.  
  236.  
  237.  
  238. Carnival ("carnival")
  239. =====================
  240. Arrows  Move around
  241. CTRL    Fire
  242.  
  243.  
  244.  
  245. Centipede ("centiped")
  246. ======================
  247. Arrows  Move around
  248. CTRL    Fire
  249.  
  250. Known issues:
  251. - What is the clock speed of the original machine? I'm currently using 1Mhz,
  252.   I don't know if the game runs correctly.
  253. - The game awards you 18 credits on startup
  254. - Palette is not supported
  255.  
  256.  
  257.  
  258. Congo Bongo ("congo")
  259. =====================
  260. Runs on the same hardware as Zaxxon.
  261.  
  262. Arrows  Move around
  263. CTRL    Jump
  264.  
  265.  
  266.  
  267. Crazy Climber ("cclimber")
  268. ==========================
  269. E,S,D,F Left joystick
  270. I,J,K,L Right joystick
  271. F1      Skip level
  272.  
  273. Clones supported:
  274.   Japanese version ("ccjap")
  275.   bootleg version ("ccboot")
  276.  
  277.  
  278.  
  279. Crazy Kong ("ckong")
  280. ====================
  281. This Donkey Kong clone runs on the same hardware as Crazy Climber, most
  282. notable differencies being a larger character set and the display rotated
  283. 90 degrees.
  284.  
  285. Arrows  Move around
  286. CTRL    Jump
  287.  
  288. Clones supported:
  289.   version running on Scramble hardware ("ckongs")
  290.  
  291. Known issues:
  292. - Some problems with sound
  293.  
  294.  
  295.  
  296. Crush Roller ("crush")
  297. ======================
  298. Crush Roller is a hacked version of Make Trax, modified to run on a
  299. Pac Man board.
  300.  
  301. Arrows  Move around
  302. F1      Skip level
  303.  
  304.  
  305.  
  306. Donkey Kong ("dkong")
  307. =====================
  308. Arrows  Move around
  309. CTRL    Jump
  310.  
  311.  
  312.  
  313. Donkey Kong Jr. ("dkongjr")
  314. ===========================
  315. Runs on hardware similar to Donkey Kong
  316.  
  317. Arrows  Move around
  318. CTRL    Jump
  319.  
  320.  
  321.  
  322. Donkey Kong 3 ("dkong3")
  323. ========================
  324. Runs on hardware similar to Donkey Kong
  325.  
  326. Arrows  Move around
  327. CTRL    Fire
  328. F1      Test (keep it pressed - very nice, try it!)
  329.  
  330.  
  331.  
  332. Elevator Action ("elevator")
  333. ============================
  334. Should run on hardware similar to Jungle King.
  335.  
  336. Known issues:
  337. - Collision detect not yet implemented.
  338.  
  339.  
  340.  
  341. Elevator Action - Bootleg ("elevatob")
  342. ======================================
  343. Arrows  Move around
  344. CTRL    Fire
  345.  
  346. Known issues:
  347. - Collision detect not yet implemented.
  348.  
  349.  
  350.  
  351. Fantasy ("fantasy")
  352. ===================
  353. Runs on the same hardware as Nibbler.
  354.  
  355. Not playable yet!
  356.  
  357.  
  358.  
  359. Frogger ("frogger")
  360. ===================
  361. Arrows  Move around
  362.  
  363. Clones supported:
  364.   alternate version, smaller, with different help, but still (C) Sega 1981
  365.      ("frogsega")
  366.   bootleg version, which runs on a modified Scramble board ("froggers")
  367.  
  368.  
  369.  
  370. Galaxian ("galaxian")
  371. =====================
  372. Original version with Namco copyright
  373.  
  374. Arrows  Move around
  375. CTRL    Fire
  376. F2      Test mode
  377.  
  378.   original with Midway copyright ("galmidw")
  379.   and several bootlegs:
  380.   one with Namco copyright ("galnamco")
  381.   Super Galaxian ("superg")
  382.   Galaxian Part X ("galapx")
  383.   Galaxian Part 1 ("galap1")
  384.   Galaxian Part 4 ("galap4")
  385.   Galaxian Turbo ("galturbo")
  386.  
  387. Known issues:
  388. - Only one sound channel is emulated, and I'm not sure it's correct.
  389. - The star background is probably not entirely accurate.
  390.  
  391.  
  392.  
  393. Gorf ("gorf")
  394. =============
  395. This game runs on the same hardware as Wizard of Wor, but doesn't work yet.
  396. It boots, shows some text on the screen and that's all.
  397.  
  398.  
  399.  
  400. Green Beret ("gberet")
  401. ======================
  402. Arrows  Move around
  403. CTRL    Knife
  404. ALT     Fire
  405.  
  406. Clones supported:
  407.   US version, called Rush'n Attack ("rushatck")
  408.  
  409. Known issues:
  410. - The music starts with what seems a correct pitch, but changes after you die
  411.   for the first time or finishe the first level. Weird.
  412.  
  413.  
  414.  
  415. Gyruss ("gyruss")
  416. ======================
  417. Arrows  Move around
  418. CTRL    Fire
  419.  
  420. Known issues:
  421. - Some of the components of spaceship do wraparound the top of the screen
  422.   for a while.  Dunno if the original machine does.
  423.  
  424.  
  425.  
  426. "Japanese Irem game" ("japirem")
  427. ================================
  428. This runs on a modified Galaxian board.
  429.  
  430. Arrows  Move around
  431. CTRL    Fire
  432.  
  433. Clones supported:
  434.   Uniwars ("uniwars")
  435.  
  436. Known issues:
  437. - Only one sound channel is emulated, and I'm not sure it's correct.
  438. - The star background is probably not entirely accurate.
  439. - What does dip switch 6 do?
  440.  
  441.  
  442.  
  443. Jump Bug ("jumpbug")
  444. ====================
  445. Arrows  Move around
  446. CTRL    Fire
  447. ALT     Jump
  448.  
  449. Clones supported:
  450.   "Sega" version ("jbugsega")
  451.  
  452. Known issues:
  453. - The original version has now a decode_opcode, but controls appear to be
  454.   reversed compared to the booleg version.  Haven't checked this yet.
  455. - Graphics are wrong - the game has multiple character banks, not emulated yet.
  456.  
  457.  
  458.  
  459. Jungle King ("junglek")
  460. =======================
  461. Arrows  Move around
  462. CTRL    Jump
  463.  
  464. Known issues:
  465. - I haven't the gfx bank selector switch, therefore the background graphics
  466.   are not selected appropriately. Use C and V to change the gfx set.
  467.  
  468.  
  469.  
  470. Krull ("krull")
  471. ========================
  472. Runs on the same hardware as Q*Bert
  473.  
  474. Arrows  Move around
  475. CTRL    Fire
  476. A,W,D,S Firing joystick (Left, Up, Right, Down)
  477. G       Select
  478.  
  479.  
  480. Lady Bug ("ladybug")
  481. ====================
  482. Arrows  Move around
  483. F1      Skip level
  484.  
  485.  
  486.  
  487. Lost Tomb ("losttomb")
  488. ======================
  489. This runs on a Super Cobra hardware.
  490.  
  491. Known issues:
  492. - Not playable. Crashes during demo. Graphics are garbled. I think the ROMs
  493.   are corrupted.
  494.  
  495.  
  496.  
  497. Mad Planets ("mplanets")
  498. ========================
  499. Runs on the same hardware as Q*Bert
  500.  
  501. Arrows  Move around
  502. CTRL    Fire
  503.  
  504. Known issues:
  505. - The dialer (used to rotate the ship) is not supported.
  506.  
  507.  
  508.  
  509. Mario Bros. ("mario")
  510. =====================
  511. Runs on hardware similar to Donkey Kong
  512.  
  513. Arrows  Move around player 1
  514. CTRL    Jump player 1
  515. Z,X     Move around player 2
  516. SPACE   Jump player 2
  517. F1      Test (keep it pressed - very nice, try it!)
  518.  
  519.  
  520.  
  521. Millipede ("milliped")
  522. ======================
  523. As you can imagine, this runs on the same hardware as Centipede.
  524.  
  525. Arrows  Move around
  526. CTRL    Fire
  527.  
  528. Known issues:
  529. - What is the clock speed of the original machine? I'm currently using 1Mhz,
  530.   I don't know if the game runs correctly.
  531. - High scores don't seem to work.
  532. - Palette is not supported
  533.  
  534.  
  535.  
  536. Moon Cresta ("mooncrst")
  537. ========================
  538. This runs on a hardware very similar to Galaxian.
  539. The ROMs are encrypted. Nichibutsu copyright.
  540.  
  541. Arrows  Move around
  542. CTRL    Fire
  543.  
  544. Clones supported:
  545.   Unencrypted version ("mooncrsb")
  546.   bootleg version called Fantazia ("fantazia")
  547.  
  548. Known issues:
  549. - Only one sound channel is emulated, and I'm not sure it's correct.
  550. - The star background is probably not entirely accurate.
  551. - What do the dip switches do?
  552.  
  553.  
  554.  
  555. Moon Patrol ("mpatrol")
  556. =======================
  557. Arrows  Move around
  558. CTRL    Fire
  559. ALT     Jump
  560. F2+F3   Test mode (press and release, then be patient. After the RAM/ROM
  561.                    tests, press 2 for an additional menu of options, then
  562.                    left/right to choose the option, and 1 to select it)
  563.  
  564. Clones supported:
  565.   bootleg version, called Moon Ranger ("mranger")
  566.  
  567. Known issues:
  568. - No background graphics. I don't know where to place them... can anyone
  569.   provide a screen snapshot?
  570.  
  571.  
  572.  
  573. Moon Quasar ("moonqsr")
  574. =======================
  575. This runs on a modified Moon Cresta board.
  576.  
  577. Arrows  Move around
  578. CTRL    Fire
  579.  
  580. Known issues:
  581. - Only one sound channel is emulated, and I'm not sure it's correct.
  582. - The star background is probably not entirely accurate.
  583.  
  584.  
  585.  
  586. Mouse Trap ("mtrap")
  587. ====================
  588. Runs on the same hardware as Venture.
  589.  
  590. Arrows  Move around
  591. CTRL    Fire
  592. 3+F3    Test mode
  593.  
  594. Known issues:
  595. - Collision detection doesn't work.
  596.  
  597.  
  598.  
  599. Mr. Do! ("mrdo")
  600. ================
  601. Arrows  Move around
  602. CTRL    Fire
  603. F1      Skip level
  604. CTRL+F3 Test mode
  605.  
  606. Clones supported:
  607.   Version with additional Taito copyright ("mrdot")
  608.   Mr. Lo! ("mrlo")
  609.  
  610.  
  611.  
  612. Mr. Do's Castle ("docastle")
  613. ============================
  614. Not working yet!
  615.  
  616.  
  617.  
  618. Ms Pac Man ("mspacman")
  619. =======================
  620. Arrows  Move around
  621. F1      Skip level
  622. F2      Test mode
  623. CTRL    Speed up cheat
  624.  
  625.  
  626.  
  627. Nibbler ("nibbler")
  628. ===================
  629. Arrows  Move around
  630. F1      Skip level
  631.  
  632. Known issues:
  633. - What is the clock speed of the original machine? I'm currently using 1Mhz
  634. - Some input bits seem to be used as debug controls - quite interesting, but
  635.   I haven't investigated yet.
  636.  
  637.  
  638.  
  639. Pac Man ("pacman")
  640. ==================
  641. Arrows  Move around
  642. F1      Skip level
  643. F2      Test mode
  644. CTRL    Speed up cheat
  645.  
  646. Clones supported:
  647.   Pac Man modification ("pacmod")
  648.   Namco Pac Man ("namcopac")
  649.   Hangly Man ("hangly")
  650.   Puck Man ("puckman")
  651.   Piranha ("piranha")
  652.  
  653.  
  654.  
  655. Pengo ("pengo")
  656. ===============
  657. Arrows  Move around
  658. CTRL    Push
  659. F1      Skip level
  660. F2      Test mode
  661.  
  662. Clones supported:
  663.   Penta ("penta")
  664.  
  665.  
  666.  
  667. Pepper II ("pepper2")
  668. =====================
  669. Runs on hardware similar to Venture.
  670.  
  671. Arrows  Move around
  672. CTRL    Dog button
  673. Z       Yellow button
  674. X       Red button
  675. C       Blue button
  676. 3+F3    Test mode
  677.  
  678. Known issues:
  679. - Collision detection doesn't work - use 7 and 8 to simulate it.
  680.  
  681.  
  682.  
  683. Phoenix ("phoenix")
  684. ===================
  685. Arrows  Move around
  686. CTRL    Fire
  687. ALT     Barrier
  688.  
  689.  
  690.  
  691. Pisces ("pisces")
  692. =================
  693. This runs on a modified Galaxian board.
  694.  
  695. Arrows  Move around
  696. CTRL    Fire
  697.  
  698. Known issues:
  699. - Only one sound channel is emulated, and I'm not sure it's correct.
  700. - The star background is probably not entirely accurate.
  701. - What do the dip switches do?
  702.  
  703.  
  704.  
  705. Pleiads ("pleiads")
  706. ===================
  707. This runs on the same hardware as Phoenix.
  708.  
  709. Arrows  Move around
  710. CTRL    Fire
  711. ALT     Teleport
  712.  
  713.  
  714.  
  715. Pooyan ("pooyan")
  716. =================
  717. Runs on hardware similar to Time Pilot.
  718.  
  719. Arrows  Move around
  720. CTRL    Fire
  721.  
  722. Known issues:
  723. - The characters seem to use 16 color codes, however the color code for many
  724.   characters has bit 4 set. I don't know what it's for.
  725.  
  726.  
  727.  
  728. Popeye - bootleg ("popeyebl")
  729. =============================
  730.  
  731. Arrows  Move around
  732. CTRL    Fire
  733. Q,W,E   Fire
  734.  
  735.  
  736.  
  737. Q*Bert ("qbert")
  738. ================
  739. Arrows  Move around
  740. To enter your name in the high score list, use 1 or 2.
  741.  
  742. Clones supported:
  743.   Japanese version ("qbertjp")
  744.  
  745.  
  746.  
  747. Rally X ("rallyx")
  748. ==================
  749. Arrows  Move around
  750. CTRL    Smoke
  751. F2      Test
  752.  
  753. Known issues:
  754. - Sprites are not turned off appropriately.
  755. - Cars are not displayed on the radar screen.
  756. - I don't know if I reproduced the layout of the screen coreectly.
  757.  
  758.  
  759.  
  760. Scramble ("scramble")
  761. =====================
  762. The video hardware is very similar to Galaxian, main differences being that
  763. bullets are not vertical lines and the star background doesn't scroll.
  764.  
  765. Arrows  Move around
  766. CTRL    Fire
  767. ALT     Bomb
  768.  
  769. Clones supported:
  770.   Battle of Atlantis ("atlantis") [I don't know what most of the dip switches
  771.                                    do, and you get a massive 14 credits per
  772.                                    coin - now that's what I call good value
  773.                                    for money! ;-)]
  774.  
  775. Known issues:
  776. - The star background is probably not entirely accurate. Also, maybe it should
  777.   be clipped at the top and bottom of the screen?
  778.  
  779.  
  780.  
  781. Seicross ("seicross")
  782. =====================
  783. Runs on almost the same hardware as Crazy Climber, but not exactly the same.
  784.  
  785. Not playable.
  786.  
  787.  
  788.  
  789. Space Invaders ("invaders")
  790. ===========================
  791. Arrows  Move around
  792. CTRL    Fire
  793.  
  794. Clones supported (some of these have wrong colors, and the dip switch menu
  795.       doesn't work):
  796.   Super Earth Invasion ("earthinv")
  797.   Space Attack II ("spaceatt")
  798.   Space Invaders Deluxe ("invdelux") (doesn't work yet)
  799.   Galaxy Wars ("galxwars")
  800.   Lunar Rescur ("lrescue")
  801.   Destination Earth ("desterth")
  802.  
  803. Known issues:
  804. - The color stripes are not placed correctly
  805.  
  806.  
  807.  
  808. Space Panic ("panic")
  809. =====================
  810. Arrows  Move around
  811. CTRL    Fire1
  812. ALT     Fire2
  813.  
  814.  
  815.  
  816. Super Cobra ("scobra")
  817. ======================
  818. Runs on the same hardware as Scramble.
  819. This is the version with Stern copyright.
  820.  
  821. Arrows  Move around
  822. CTRL    Fire
  823. ALT     Bomb
  824.  
  825. Clones supported:
  826.   Konami copyright ("scobrak")
  827.   bootleg version ("scobrab")
  828.  
  829. Known issues:
  830. - The star background is probably not entirely accurate. Also, maybe it should
  831.   be clipped at the top and bottom of the screen?
  832.  
  833.  
  834.  
  835. The Adventures of Robby Roto ("robby")
  836. ======================================
  837. This game runs on the same hardware as Wizard of Wor, but doesn't work yet. I
  838. still haven to check the loading address of the ROMs.
  839.  
  840.  
  841.  
  842. The End ("theend")
  843. ==================
  844. This runs on a Scramble hardware.
  845.  
  846. Arrows  Move around
  847. CTRL    Fire
  848.  
  849. Known issues:
  850. - The star background is probably not entirely accurate. Also, maybe it should
  851.   be clipped at the top and bottom of the screen?
  852.  
  853.  
  854.  
  855. Time Pilot ("timeplt")
  856. ======================
  857. Arrows  Move around
  858. CTRL    Fire
  859.  
  860. Clones supported:
  861.   bootleg version ("spaceplt")
  862.  
  863. Known issues:
  864. - The ROM copyright message and the dipswitch menu are unreadable. Time Pilot
  865.   doesn't have consecutive letters in the graphics ROms, I'll have to modify
  866.   my text routines to handle that.
  867. - This game uses double-width sprites for the clouds, but I haven't yet figured
  868.   out they are selected. The code is currently a hack - just double the sprites
  869.   which I know are used for clouds...
  870. - The memory mapped read port at c000 puzzles me...
  871.  
  872.  
  873.  
  874. Turtles ("turtles")
  875. ===================
  876. This runs on the same hardware as Amidar
  877.  
  878. Arrows  Move around
  879. CTRL    Bomb
  880.  
  881. Known issues:
  882. - What do the dip switches do? I'm obviously missing something, becasue the
  883.   game plays in unlimited lives mode.
  884.  
  885.  
  886.  
  887. Vanguard ("vanguard")
  888. =====================
  889. Runs on hardware similar to Nibbler.
  890.  
  891. Arrows  Move around
  892. S,D,E,F Fire
  893.  
  894.  
  895.  
  896. Venture ("venture")
  897. ===================
  898. Arrows  Move around
  899. CTRL    Fire
  900. 3+F3    Test mode
  901. On startup, keep 1 or 2 pressed to proceed
  902.  
  903. Known issues:
  904. - Collision detection doesn't work - use 7 and 8 to simulate it.
  905.  
  906.  
  907.  
  908. Wizard of Wor ("wow")
  909. =====================
  910. Arrows  Move around
  911. CTRL    Fire
  912. F2      Test mode (keep it pressed)
  913. The original machine had a special joystick which could be moved either
  914. partially or fully in a direction. Pushing it slightly would turn around the
  915. player without moking it move. The emulator assumes that you are always
  916. pushing the joystick fully, to simulate the "half press" you can press Alt.
  917.  
  918. Known issues:
  919. - No background stars, no fade in/fade out.
  920.  
  921.  
  922.  
  923. War of the Bugs ("warofbug")
  924. ============================
  925. This runs on the same hardware as Galaxian.
  926.  
  927. Arrows  Move around
  928. CTRL    Fire
  929.  
  930. Known issues:
  931. - Only one sound channel is emulated, and I'm not sure it's correct.
  932. - The star background is probably not entirely accurate.
  933. - What do the dip switches do?
  934.  
  935.  
  936.  
  937. Zaxxon ("zaxxon")
  938. ===================
  939. Arrows  Move around
  940. CTRL    Fire
  941.  
  942.  
  943.  
  944.  
  945. Acknowledgements
  946. ----------------
  947.  
  948. First of all, thanks to Allard van der Bas (avdbas@wi.leidenuniv.nl) for
  949. starting the Arcade Emulation Programming Repository at
  950. http://valhalla.ph.tn.tudelft.nl/emul8
  951. Without the Repository, I would never have even tried to write an emulator.
  952.  
  953. If you find out something useful, submit it to avdbas@wi.leidenuniv.nl,
  954. so it will be made available to everybody on the Repository page.
  955.  
  956. Z80Em Portable Zilog Z80 Emulator Copyright (C) Marcel de Kogel 1996,1997
  957.    Note: the version used in MAME is slightly modified. You can find the
  958.    original version at http://www.komkon.org/~dekogel/misc.html.
  959. M6502 Emulator Copyright (C) Marat Fayzullin, Alex Krasivsky 1996
  960.    Note: the version used in MAME is slightly modified. You can find the
  961.    original version at http://freeflight.com/fms/.
  962. I86 emulator by David Hedley, modified by Fabrice Frances (frances@ensica.fr)
  963. Allegro library by Shawn Hargreaves, 1994/96
  964. SEAL Synthetic Audio Library API Interface Copyright (C) 1995, 1996
  965.    Carlos Hasan. All Rights Reserved.
  966. Video modes created using Tweak 1.6b by Robert Schmidt, who also wrote
  967.    TwkUser.c. Thanks to Chuck Cochems for the help in making them more
  968.    compatible.
  969. 224x288 noscanlines and both 288x224 video modes provided by Valerio Verrando
  970.   (v.verrando@mclink.it)
  971. AY-3-8910 emulation by Ville Hallik (ville@physic.ut.ee) and Michael Cuddy
  972.   (mcuddy@FensEnde.com).
  973. POKEY emulator by Ron Fries (rfries@tcmail.frco.com).
  974. UNIX port by Allard van der Bas (avdbas@wi.leidenuniv.nl) and Dick de Ridder
  975.   (dick@ph.tn.tudelft.nl).
  976.  
  977. Phoenix driver provided by Brad Oliver (bradman@primenet.com), Mirko
  978.    Buffoni (mix@lim.dsi.unimi.it) and Richard Davies (R.Davies@dcs.hull.ac.uk)
  979. Gyruss, Mario Bros., Zaxxon, Bomb Jack, Burger Time and Donkey Kong 3 drivers
  980.    provided by Mirko Buffoni (mix@lim.dsi.unimi.it)
  981. Bomb Jack sound driver by Jarek Burczynski (pbk01@ikp.atm.com.pl).
  982. Arabian driver provided by Jarek Burczynski (pbk01@ikp.atm.com.pl).
  983. Congo Bongo driver provided by Ville Laitinen (ville@sms.fi).
  984. Millipede driver provided by Ivan Mackintosh (ivan@rcp.co.uk).
  985. Donkey Kong sound emulation by Ron Fries (rfries@tcmail.frco.com).
  986. Vanguard driver by Brad Oliver and Mirko Buffoni, based on code by Brian
  987.    Levine.
  988. Carnival driver completed by Mike Coates and Richard Davies.
  989. Warp warp driver completed by Chris Hardy (chrish@kcbbs.gen.nz).
  990. Popeye driver provided by Marc LaFontaine and Nicola Salmoria.
  991. Jump Bug driver by Richard Davies (R.Davies@dcs.hull.ac.uk) and Brad Oliver
  992.    (bradman@primenet.com).
  993. Venture, Mouse Trap and Pepper II drivers by Marc Lafontaine
  994.    (marclaf@sympatico.ca).
  995. Q*Bert, Mad Planets, Reactor and Krull drivers by Fabrice Frances
  996.    (frances@ensica.fr)
  997. Space Panic driver by Mike Coates (mike@dissfulfils.co.uk)
  998.  
  999.  
  1000. Very special thanks to Sergio Munoz for the precious information about the
  1001.    Pengo sound hardware and colors.
  1002. Thanks to Paul Swan for the information on the Lady Bug sound hardware and
  1003.    Mr.Do! and Green Beret colors.
  1004. Big thanks to Gary Walton (garyw@excels-w.demon.co.uk) for too many things
  1005.    to mention them all.
  1006. Thanks to Simon Walls (wallss@ecid.cig.mot.com) for the color information
  1007.    on many games.
  1008. Information about the Crazy Climber machine hardware (including palette)
  1009.    and ROM encryption scheme provided by Lionel Theunissen
  1010.    (lionelth@ozemail.com.au).
  1011. Thanks to Andy Milne (andy@canetics.com) for the information on the Crazy
  1012.    Climber sound roms.
  1013. Crazy Kong emulation set up by Ville Laitinen (ville@sms.fi).
  1014. Very special thanks to Michael Cuddy for the extensive information on
  1015.    Gyruss hardware (You'r right, it's a bear of a game!).
  1016. Gyruss samples are a courtesy of Michel Cuddy (mcuddy@fensende.com)
  1017. Special thanks to Brad Thomas (bradt@nol.net) and Gary Shepherdson for the
  1018.    extensive information on Donkey Kong and Donkey Kong Jr.
  1019. Info on Bagman, Galaxian, Moon Cresta and many other games taken from Arcade
  1020.    Emulator by Robert Anschuetz.
  1021. Pooyan information provided by Michael Cuddy and Allard van der Bas
  1022. Thanks to Mirko Buffoni for the Amidar and Frogger colors.
  1023. Thanks to Brad Thomas, Jakob Frendsen and Conny Melin for the info on Bomb
  1024.    Jack.
  1025. Thanks to Mike@Dissfulfils.co.uk for the information on the Moon Quasar
  1026.    encryption scheme.
  1027. Space Invaders information gathered from the Space Invaders Emulator by
  1028.    Michael Strutt (mstrutt@pixie.co.za)
  1029. Thanks to Paul Leaman (paull@phonelink.com) for exaustive documentation on
  1030.    1942 arcade board, and for providing us the correct color proms.
  1031. Many thanks to Jim Hernandez for the information on Wizard of Wor hardware.
  1032. Thanks to Mike Coates (mike@dissfulfils.co.uk) for Carnival ROM placement
  1033.    indications and gfx info.
  1034. Colors for Donkey Kong, Donkey Kong Jr. and Mario Bros. derived from Kong
  1035.    emulator by Gary Shepherdson.
  1036. Colors for Amidar, Frogger and Zaxxon derived from SPARCADE by Dave Spicer.
  1037. Thanks to Brad Oliver, Marc Vergoossen (marc.vergoossen@pi.net) and Richard
  1038.    Davies (R.Davies@dcs.hull.ac.uk) for help with Donky Kong Jr. colors.
  1039. Thanks to Marc Vergoossen and Marc Lafontaine (marclaf@sympatico.ca) for
  1040.    Zaxxon colors.
  1041. Thanks to Marc Lafontaine for Congo Bongo colors and Popeye bootleg.
  1042. Centipede information taken from Centipede emulator by Ivan Mackintosh, MageX
  1043.    0.3 by Edward Massey and memory map by Pete Rittwage.
  1044. Info on Burger Time taken from Replay 0.01a by Kevin Brisley (kevin@isgtec.com)
  1045. Thanks to Chris Hardy (chrish@kcbbs.gen.nz) for info on Moon Patrol.
  1046. Thanks to Dave W. (hbbuse08@csun.edu) for all his help.
  1047. Thanks to Doug Jefferys (djeffery@multipath.com) for Crazy Kong color
  1048.    information.
  1049. Thanks to Philip Chapman (Philip_Chapman@qsp.co.uk) for useful feedback on
  1050.    Bomb Jack.
  1051. Thanks to Mike Cuddy for Pooyan and Time pilot colors.
  1052. Thanks to Thomas Meyer for Moon Patrol screenshots.
  1053. Many thanks to Steve Scavone (krunch@intac.com) for his invaluable help with
  1054.    Wizard of Wor and related games.
  1055. -vesascan and -vesaskip implemented by Bernd Wiebelt
  1056.    (bernardo@studi.mathematik.hu-berlin.de)
  1057. Thanks to Stefano Mozzi (piu1608@cdc8g5.cdc.polimi.it) for Mario Bros. colors.
  1058. Thanks to Matthew Hillmer (mhillmer@pop.isd.net) for Donkey Kong 3 colors.
  1059. Thanks to Tormod Tjaberg (tormod@sn.no) and Michael Strutts for Space Invaders
  1060.    sound.
  1061. Thanks to Shaun Stephenson (shaun@marino13.demon.co.uk) for Phoenix samples.
  1062.  
  1063.  
  1064. Usage
  1065. -----
  1066.  
  1067. MAME [name of the game to run] [options]
  1068.  
  1069. for example
  1070.  
  1071. MAME mspacman -nosound   will run Ms Pac Man without sound
  1072.  
  1073. options:
  1074. -noscanlines  use alternate video mode (not availble in all games). Use this
  1075.               if the default mode doesn't work with your monitor/video card.
  1076. -vesa         use standard 640x480x256 VESA mode instead of custom video mode.
  1077.               Use this as a last resort if -noscanlines doesn't solve your
  1078.               video problems.
  1079. -vesascan     use a VESA 800x600 screen to simulate scanlines. This is much
  1080.               slower than the other video modes. Use this if you want
  1081.               scanlines and the default video mode doesn't work.
  1082. -vesaskip n   similar to -vesascan, but use a 640x480 screen instead of
  1083.               800x600. Since most games use a screen taller than 240 lines,
  1084.               it won't fit in the screen - n sets the initial number of lines
  1085.               to skip at the top of the screen. You can adjust the position
  1086.               while the game is running using the PGUP and PGDOWN keys.
  1087. -vgafreq n    where n can be 0 (default) 1, 2 or 3.
  1088.               use different frequencies for the custom video modes. This
  1089.               could reduce flicker, especially in the 224x288noscanlines
  1090.               mode. WARNING: THE FREQUENCIES USED MIGHT BE WAY OUTSIDE OF
  1091.               YOUR MONITOR RANGE, AND COULD EVEN DAMAGE IT. USE THESE OPTIONS
  1092.               AT YOUR OWN RISK.
  1093. -vsync        syncronize video display with the video beam instead of using
  1094.               the timer. This works best with -noscanlines and the -vesaxxx
  1095.               modes. Use F11 to check your actual frame rate - it should be
  1096.               around 60. If it is lower, try to increase it with -vgafreq (if
  1097.               you are using a tqeked video mode) or use your video board
  1098.               utilities to set the VESA refresh rate to 60 Hz.
  1099.               Note that when this option is turned on, speed will NOT
  1100.               downgrade nicely if your system is not fast enough.
  1101. -soundcard n  select sound card (if this is not specified, you will be asked
  1102.               interactively)
  1103. -nojoy        don't poll joystick
  1104. -log          create a log of illegal memory accesses in ERROR.LOG
  1105. -list         display a list of currently supported games
  1106. -frameskip n  skip frames to speed up the emulation. For example, if the game
  1107.               normally runs at 60 fps, "-skipframe 1" will make it run at 30
  1108.               fps, and "-skipframe 2" at 20 fps. Use F11 to check the fps your
  1109.               computer is actually displaying. If the game is too slow,
  1110.               increase the frameskip value. Note that this setting can also
  1111.               affect audio quality (some games sound better, others sound
  1112.               worse).
  1113.  
  1114.  
  1115. The following keys work in all emulators:
  1116.  
  1117. 3       Insert coin
  1118. 1       Start 1 player game
  1119. 2       Start 2 players game
  1120. Tab     Change dip switch settings
  1121. P       Pause
  1122. F3      Reset
  1123. F4      Show the game graphics. Use cursor keys to change set/color, F4 to exit.
  1124. F10     Toggle speed throttling
  1125. F11     Toggle fps counter
  1126. F12     Save a screen snapshot
  1127. ESC     Exit emulator
  1128.