XFME Desktop for Windows - known issues in this release
=======================================================

Please do not report these again (unless you find more about them); everything else is worth reporting.

Installation and Windows
* The program is not code-signed: Windows SmartScreen warns the first time (see README.txt).
* Windows 10 before version 1903: file and folder names outside your PC's own language (for example Greek or
  Japanese names on an English PC) do not open. Everything else works.

Games and systems
* Not every MFME system is emulated yet. A game whose system XFME does not have says so ("its system ... is not
  supported by this version of XFME").
* Electrocoin games that rely on the ISS security device (the issA / issC casino issues and the Super Bar X / Big 7
  3000, 3200 and similar series) are not supported in this release: the device's real behaviour is not known, and
  XFME does not substitute an invented one. They may start, but their play and returns are not the real machine's.
* A game whose ROM files are missing still starts (as far as it can) and lists the missing files. XFME never
  downloads ROMs.
* Cabinet sound effects (coin drop, reel, button, payout sounds) need MFME's DefaultSounds folder, which is not
  included: Library menu > "Cabinet sound effects: find my MFME folder..." copies it from your MFME 20.1 installation
  (or copy the folder beside XFME.exe yourself; README.txt, Installing step 3). Without it the effects are silent even
  with their boxes ticked. MFME's layout font MFME.ttf is included; layouts that use the Lithograph fonts
  need those fonts.
* Sound levels have changed: MPS2, Inder, Scorpion 2, System 5, M1 Video and Phoenix play at about half 1.1's
  level, IGT S2000 lower too, and MPU3 tones are higher than in 1.1 (they were 36 % flat). Machines with the SAA1099
  chip (some MPU4 Video and System 5 Video games) play its noise an octave lower than MFME 20.1, as the chip's data
  sheet gives it. None of this has been checked by ear against a real machine yet.
* Some layouts carry settings that stop a game: for example a "no hopper fitted" setting on a game whose program pays
  from the machine's hopper. The game then shows its own pay-unit error at a collect or at switch-on. Please report the
  game and layout.

* Secrets Of The Golden Nile (Project): its display is a graphic LCD, which an MFME layout cannot carry, so with the
  .fml layouts it stays blank (as in MFME 20.1). The XFME layouts in Secrets_Of_The_Golden_Nile_XFME.zip show it.
* Carry On (PCP, Sp.Ace): its reels are driven by PCP's own reel controller, whose program must be in the game's
  folder ("pcp reel mcu fcr 1 _space_.bin", any file name: XFME finds it by its contents). Without it the game runs
  but the reels do not move, and XFME lists the file as missing.
* Kings & Queens (BWB, MPU4): its program sets the sound card to 16 kHz (15925 Hz) before every sample and XFME plays
  them at that rate; the 32 kHz setting seen earlier is only its switch-on value and one click sound. Not checked by ear.

First start of a game (fresh RAM)
* The first start of some systems (Adder 5, Scorpion 5, MPU5 ...) takes up to about two minutes - the machine's own
  power-on checks and the pairing of its coin / note / hopper units, run at high speed. Coins put in before the game is
  ready are not taken. Later starts resume from the quick-start snapshot.
* Some games need a set-up step on their first start, as on a new machine:
  - Scorpion 4 club games with an empty hopper: a refill (Refill key) first.
  - Some MPU6 games (Terminator, Reels of Gold, Star Wars, Alien) show DEVICE CHANGED until they have been set up once.
  - Astra Pluto 6 games: at RAMCLEAR REQ hold the player's (and the top box's) PUSH BUTTON for about 10 seconds, then
    START at the date.
  - Fairgames Pluto 5 games showing RAM CLEAR ERROR: their RAM-clear key / switch (see the game's notes).
  - Empire Haunted House / Apache Gold (ALARM 04 until one Reset); Ace System 1 games (one restart).
* MPU6: the clock a game sets (or its engineer's "set time") is now kept beside the RAM (<game>.msp).
* Games with a video card on Pluto 5 / Pluto 6 (Project Coin poker, the Gamesoft games such as Wild Golden Poker): the
  first start runs the game's own loading from its card or EPROMs (Wild Golden Poker: about 40-60 seconds of machine
  time, shown at high speed under XFME's "starting up" picture). From 1.2 later starts resume from the quick-start
  snapshot (before 1.2 a game with a video card booted in full every time).

Particular games
* 28 Plays Later (Scorpion 5): in the nudge gamble, press and hold a Hold button for a moment; a very quick click can
  be missed there.
* Super Spoof (MPU3): COLLECT pays the bank once the credit has been played off (or when the bank reaches its limit), as
  on the machine. Layouts without a money table show no money in / out in the meter panel.
* Bonus Talker: coins put in while it shows "EC 1" at switch-on are not counted (the game's own behaviour).
* Cluedo Prime Suspect (QPS, Scorpion 5) stops on MECH NOTE ERR 15 after its first start: its .gam has DIL switch 8 of
  bank 1 off while a note acceptor is fitted. Set `DIP 1 10000001` in the .gam (or switch 8 on in Configuration).
* Funny Money (Maygay / Impulse): a coin put in while the machine has its coins locked out (credit at its limit)
  stops it on INTERNAL ERR 92 - the layout's coin button is not tied to the lockout. Play the credit down before
  adding coins; a corrected layout exists.
* Rainbows End, Warlord, Nifty Nudge (ACE): a win waits at CLIMB NOW / Gamble until COLLECT (or Gamble) is pressed -
  hold COLLECT for about a second; START alone does nothing there. The games' own behaviour.
* Pig Wizard (Betcom, Pluto 6, bring-up layout): the first press of a START button chooses its stake (the display
  names it), the second press plays - the game's own behaviour.
* Uncle Sam (Guam, Scorpion 4 + Adder 4 video, new in 0.1.1): its 9-alike bonus has not been seen in testing.
* Gamesoft Pluto 6 video games (Creepy Cash, Mermaids Treasure, Monkey Business, Wild Golden Poker; new in 0.1.1):
  paying out (hopper), the Hi-Lo gamble and notes have not been checked yet, and the meter panel's IN / OUT stay at 0.
* JPM Impact German sets (Samurai, Indiana Jones (German), Jokers Gold (German), Schloss Drachenstein, Star Wars
  (German)) start in their own set-up menu ("NEUE EINSTELLUNG") on a first start: press the button on switch 40 until
  the menu has gone round once, then the button on switch 41 (Indiana Jones) or 47 (the others) to store it.
  (Fixed in 0.1.2: these and the Dutch Cash Breaker, Excellence and Pharaoh no longer stop after switch-on.)
* Super Adders & Ladders (Barcrest, MPU3) Dx03: shows a reel alarm (every digit "4") at switch-on, as in MFME 20.1:
  its layout marks reel 1's opto as inverted, which its other two reels and the C01 / Dx01 / Dx02 layouts do not (a
  layout error). Play the C01, Dx01 or Dx02 version.
* The Guvnor (Maygay M1A/B) C02: its layout sets the reels half a symbol off the win line (the same in MFME 20.1). The
  C01 and Dx01 versions line up.
* More Money (VFS, MPU3): it waits at " 20" from switch-on until coins go in, and its lamps go dark there (the
  program stops driving them, and the lamp drive switches off as on MFME 20.1's board).
* MPU3 games: the reels now start where the game last left them (MFME 20.1 does the same), not at a fixed place.
* JPM Impact: the lamps fade in and out over a few scans and the display dims and brightens when the program asks
  (Stardust's attract text is dimmer at times), as MFME 20.1's board does. Please report it if a real Impact looks
  different.
* JPM Impact reel sound: MFME's DefaultSounds has no reel (Stepper) sound for the Impact, so its reels are silent, as
  in MFME 20.1. Both of the Impact's hoppers play the "Hopper 2" sounds, as in MFME 20.1.
* Maygay M1A/B: the 2-digit display shows "00" from switch-on on every set (MFME 20.1's board does the same).
* Homer's Meltdown Dx01 and The Simpsons Dx01 / Dx02 / Dx03 (Maygay M1A/B, the it_job.bin hybrids) do not start:
  their it_job.bin is not a complete program (it has text where the start address belongs). Cash Lines C01 runs
  but shows nothing in its first 20 seconds.
* Donkey Kong (Maygay M1A/B): at the end of a game the program itself asks for the same sound twice, and XFME plays it
  twice.
* Bugs Money (Pluto 5): COIN IN credits the machine (its display and START lamp show it) but the IN meter at the top
  of the window stays at 0.

Project Coin video poker (Heber Pluto 5 + Calypso 16 video card, new in 0.1.1)
* Playable (they start, take coins, deal and draw): Joker Poker 362 v79 and 437, Double Joker Poker 498 and 499, Golden
  Poker 469, Magic Poker 539, Poker Plus 457, Big Deal Poker 813, Chase the Ace 567, Find the Lady 580 and 589.
* Paying out: the credit must be 0 before COLLECT pays, and each press pays one batch (up to 50p from the 10p hopper, or
  up to GBP3 from the GBP1 hopper) - press COLLECT again for the rest.
* After a win, DEAL starts the hi-lo gamble and COLLECT banks the win.
* Chase the Ace and Find the Lady show MEM RESET ALM 42 the first time they start: one restart (the RAM is kept) clears it.
* The jackpot setting (Configuration, or the .gam's Jackpot line) these sets need: Double Joker Poker 498 Jackpot 8; Chase
  the Ace and Find the Lady Jackpot 9.
* Not playable: Chase the Ace 576 (its graphics EPROMs are not in the dump); Joker Poker 362 v57 (it needs the
  Pluto 5 VGA card, not emulated); 21 Players Choice 405 and Joker Poker 441 Sitdown (no video EPROMs in the dump).
* Poker Plus 457: touch a card to hold or release it. On a brand-new RAM the very first touch is ignored, as on the
  real cabinet.

Video boards new in 0.1.1 (none has been played by hand yet - each was checked by short scripted runs)
* JPM System 5 Video - Monopoly V3, V4, V4H, Classic V5, Deluxe V6 (and the Protocol sets): played by touch; coins credit.
* JPM Give us a Break / Ten Up (21st and 3rd editions, Ten Up Compendium 17): they load from their floppy disk and reach
  their games.
* BFM Scorpion 2 video + Adder 2 - Pyramid, Golden Crown, Paradice, Pokio, Quintoon (UK and Dutch), Slots (Dutch and
  Belgian): they start to attract and their game screens; Pyramid has been coined and started. The Adder 2's EEPROM
  (X24C08) is not yet kept between sessions.
* Zenitone Deal 'Em (MPU4): coins credit and the Hi-Lo plays.
* JPM Impact Video - Cluedo, Coronation Street Quiz Game, Hangman, Scrabble, Treasure Quest, Trivial Pursuit: all reach
  attract; Treasure Quest has been played with its buttons and Trivial Pursuit by touch. The TMS34010 graphics CPU is not
  in XFME's debugger.
* Flashback (ACE video) plays (coins, spins) - on Spellbound's classic layout, or the cabinet layout posted for it.
* Buster (Marian video) takes coins, spins, holds and pays; it takes no notice of the first coin after switch-on. Its
  switch numbers are taken from Coppa Lot, as its own are not known.
* Quintoon (Dutch sets) is on free play with all its coinage DIP switches off, so coins add nothing: set DIP 1 to
  00111000, as the posted layouts' .gam files do.
* No lamp outputs are known for these games: their layouts' buttons are printed lit.

Boards new in 0.1.2 (each checked by scripted runs and a few XFME Desktop runs; not yet played by hand at length)
* Maygay M2 - Guinness Book Of Records, Risk, London Underground, Big Break and their Protocol versions: they start,
  take coins (10p / 20p / 50p / GBP1) and start a game; A / B / C choose the stake, the category and the answer.
* Maygay M2 volume: the games play at their own volume setting, whose default is low (Guinness and Big Break about
  23 dB, Risk 35 dB, London Underground 41 dB below the sound board's full level); XFME adds a fixed amplifier gain,
  as the cabinet's own amplifier is not known, but Risk and London Underground stay quiet. To set a game's volume:
  REFILL KEY on, Reset, wait about 10 seconds for SET SOUND VOLUME, then A louder / C quieter, REFILL KEY off. The
  sound has not been compared with a real machine.
* Maygay M2 Protocol versions (the info screen says "PROGRAM TYPE - Protocol"): their .gam needs the line
  "Protocol 1"; without it they stop on ERROR 7.1 - COMMS ERROR, as a machine with no data unit does.
* Maygay M2 Aladdin (all four sets) stops on "ERROR: BANK 6 FAILED!!!": the ROMs for sockets U6 / U12 are in no
  known dump. Not an emulation fault.
* Maygay M2 lamps: only the A / B / C button lamps (and Guinness's letter and trail lamps) are known; the layouts
  are plain screen layouts with no cabinet artwork.
* Reflex Gaming B3 video (Pluto 6) - Thunderbirds B3 v1.60 (Data and Protocol), Golden Nile V1.3 B3 Protocol, Cash
  Ahoy V1.6 B3 Protocol: they start on both screens, take coins and play. Double Yer Luck B3: it starts and takes
  coins; a game has not been played in testing yet.
* Reflex B3 first start: the game loads itself from its card, about 100 seconds of machine time, run at high speed.
  After that the game resumes from its quick-start snapshot.
* Double Yer Luck B3: its total bet starts at GBP4 (the game's own setting as far as is known).
* Reflex B3: coins make no sound (not known whether the real cabinet's do); the ticket printer is not emulated.
* Fill Yer Fruits, Magnificent 7 and Fruit Frenzy (Reflex's own card video) are a different board from the Heber
  Pluto 6 and are not supported in this release.

Linked machines (top box + several machines)
* Linked sets have been checked by scripted runs (Bullion Bars 2-4 players and Genie Community in XFME Desktop's own
  windows, offscreen); please report how they behave when you play them.
* Pluto 6 games (Astra, Betcom, Heber): notes go in with XFME Desktop's NOTE IN (a GBP20) and the touch front end's
  GBP20, which light only while the game takes notes. The Astra players refuse notes until their hopper has been
  refilled (REFILL key, then START, then coins) - the games' own rule.
* Genie Community (Betcom): two and three machines link and stay linked (checked headless, in attract); games over the
  community have not been played.
* Party Time Deluxe GBP25 (DAD's Three Player layouts): the players do not link (BAD TERM ID) - their layouts lack
  the terminal-ID setting (header tag 127 = 1); corrected layouts exist.
* A machine whose host PC cannot keep up runs the whole set slower rather than losing the link.

Saving
* XFME keeps its own Game Manager lists and settings (README.txt "XFME and MFME 20.1 on the same PC"). Coming from
  RC2 or an earlier build: the list RC2 kept with no main folder is carried over; a list an earlier build kept INSIDE
  a games folder is not used any more - import it once (Library menu > Import a Game Manager list); the file itself
  is left as it is. Settings an earlier build took over from MFME automatically are not taken any more (use Import
  MFME 20.1 settings if wanted). The imports are in the XFME Desktop library menu.
* Removing the last game from the Game Manager is now kept (MFME left it in the list).
* The RAM and the quick-start snapshot are saved when a game closes, when XFME closes, when Windows goes to sleep or
  shuts down, and once a minute while playing. If XFME is killed (Task Manager) up to a minute of play is lost.
* The .gam's statistics and reel positions are written when the game closes (as MFME does), not during play.
* After updating, the quick-start snapshots of games whose saved machine changed are not used once: from 0.1.1, every
  system (0.1.2 changed the saved machine of all of them); from 0.1.0, the Pluto 5 games; from builds before 0.1.0,
  also MPU4 Video, JPM Impact, Pluto 6, and the Scorpion 4 / Scorpion 5 / Adder 5 / MPU5 / MPU6 games with ccTalk coin
  units among them. Those games start normally from their RAM once and save a new snapshot. The old file is kept,
  renamed .unused.
* A game or layout made for a newer XFME says so when it is opened ("it needs XFME 0.1.3 or later"); XFME 0.1.0 could
  not say so - there such a layout simply does not appear.
* Old ".sta" / ".v20.sta" files from earlier XFME builds are ignored and left where they are.

XFME Desktop window
* XFME Desktop does not show MFME's status bar; messages MFME shows there are not visible.
* A linked set with a system that cannot run in one process yet runs one process per machine: each machine the top
  box starts opens in an XFME Desktop window of its own, where its Instance line puts it. The same for a game started
  by hand with -slave or -i (the options a top box gives its machines); with -i naming no running top box the program
  closes once the game is loaded. (Extras > Linked Sets in One Process has gone: a set runs in one process whenever it
  can.)
* A top box whose set runs in one process: -x/-y and -w/-h on its command line place only the XFME Desktop window
  (where Esc brings it back), and -mode is not applied to the set; the set opens in the mode its top box's .gam gives
  (else the Preferences' Load Mode), where its .gam puts the machines.
* Some Game Manager functions (filters, find, export, RAM backup) are not in the XFME Desktop library.
* Edit mode and mute have no indicator in XFME Desktop.
* Below about 1800 pixels of window width the plate naming the running game gives way to the meters, so in a window
  that is not maximised on a 1920-wide screen the running game's name shows only in the library.
* The cabinet view (a layout inside a photographed cabinet) has no cabinet photographs in this build.

Command line
* See COMMAND_LINE.txt "Differences from MFME 20.1".
