summaryrefslogtreecommitdiffstatshomepage
path: root/docs/source/usingmame/commonissues.rst
blob: 77615bd19bbc865f8282135d2552ebe29c3d2e66 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
Common Issues and Questions (FAQ)
=================================

**Disclaimer: The following information is not legal advice and was not written by a lawyer.**


1. :ref:`rapid-coins`
2. :ref:`broken-package`
3. :ref:`faster-if-X`
4. :ref:`NeoGeo-broken`
5. :ref:`Sega-SGMDC`
6. :ref:`Missing-ROMs`
7. :ref:`ROM-Verify`
8. :ref:`Parent-Sets`
9. :ref:`Legal-ROMs`
10. :ref:`ROMs-Grey`
11. :ref:`Abandonware`
12. :ref:`Old-Sets`
13. :ref:`eBay-cabs`
14. :ref:`ROM-DVDs`
15. :ref:`DMCA-exemption`
16. :ref:`24-hours`
17. :ref:`commercial-use`
18. :ref:`Ultracade`
19. :ref:`Blackscreen-DirectX`
20. :ref:`ControllerIssues`
21. :ref:`ExternalOPL`
22. :ref:`Autofire`
23. :ref:`gsync-freesync`


.. _rapid-coins:

Why does my game show an error screen if I insert coins rapidly?
----------------------------------------------------------------

This is not a bug in MAME. On original arcade hardware, you simply could not insert coins as fast as you can mashing the button. The only ways you could get credit feeding at that kind of pace was if the coin mech hardware was defective or if you were physically trying to cheat the coin mech.

In either case, the game would display an error for the operator to look into the situation to prevent cheating them out of their hard-earned cash. Keep a slow, coin-insert-ish pace and you'll not trigger this.


.. _broken-package:

Why is my non-official MAME package (e.g. EmuCR build) broken? Why is my official update broken?
------------------------------------------------------------------------------------------------

Many MAME features, such as software lists, HLSL or BGFX shaders, Lua plugins
and UI translations, use external files.  Updates to these features often
require the external files to be updated along with MAME.  Unfortunately, builds
provided by third parties may only include the main MAME executable, or may
include outdated external files.  Using an updated MAME executable with outdated
external files causes issues with features reliant on the external files.
Despite repeated requests that they distribute MAME complete with matching
external files, some of these third parties persist in distributing incomplete
or broken MAME updates.

As we have no control over how third parties distribute MAME, all we really can
do is recommend against obtaining MAME from sites like EmuCR.  We cannot provide
any support for packages we didn’t build ourselves.  You can completely avoid
these issues by compiling MAME yourself, or using an official package we
provide.

You may also encounter this problem if you do not update the contents of the
hlsl, bgfs or plugins folders when updating your MAME installation with a new
official build.


.. _faster-if-X:

Why does MAME support console games and dumb terminals? Wouldn't it be faster if MAME had just the arcade games? Wouldn't it take less RAM? Wouldn't MAME be faster if you just X?
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

This is a common misconception. The actual size of the MAME file doesn't affect the speed of it; only the parts that are actively being used are in memory at any given time.

In truth, the additional supported devices are a good thing for MAME as they allow us to stress test sections of the various CPU cores and other parts of the emulation that don't normally see heavy utilization. While a computer and an arcade machine may use the exact same CPU, how they use that CPU can differ pretty dramatically.

No part of MAME is a second-class citizen to any other part. Video poker machines are just as important to document and preserve as arcade games.

There's still room for improvements in MAME's speed, but chances are that if you're not already a skilled programmer any ideas you have will have already been covered. Don't let that discourage you-- MAME is open source, and improvements are always welcome.


.. _NeoGeo-broken:

Why do my Neo Geo ROMs no longer work? How do I get the Humble Bundle Neo Geo sets working?
-------------------------------------------------------------------------------------------

Recently the Neo Geo BIOS was updated to add a new version of the Universe BIOS. This was done between 0.171 and 0.172, and results in an error trying to load Neo Geo games with an un-updated **neogeo.zip** set.

This also affects the Humble Bundle set: the games themselves are correct and up to date as of MAME 0.173 (and most likely will remain so) though you'll have to pull the ROM set .ZIP files out of the package somehow yourself. However, the Neo Geo BIOS set (**neogeo.zip**) included in the Humble Bundle set is incomplete as of the 0.172 release of MAME.

We suggest you contact the provider of your sets (Humble Bundle and DotEmu) and ask them to update their content to the newest revision. If enough people ask nicely, maybe they'll update the package.


.. _Sega-SGMDC:

How can I use the Sega Genesis & Mega Drive Classics collection from Steam with MAME?
-------------------------------------------------------------------------------------

As of the April 2016 update to the program, the ROM images included in the set are now 100% compatible with MAME and other Genesis/Mega Drive emulators. The ROMs are contained in the **steamapps\\Sega Classics\\uncompressed ROMs** folder as a series of *.68K* and *.SGD* images that can be loaded directly into MAME. PDF manuals for the games can be found in **steamapps\\Sega Classics\\manuals** as well.


.. _Missing-ROMs:

Why does MAME report "missing files" even if I have the ROMs?
-------------------------------------------------------------

There can be several reasons for this:

* It is not unusual for the ROMs to change for a game between releases of MAME. Why would this happen? Oftentimes, better or more complete ROM dumps are made, or errors are found in the way the ROMs were previously defined. Early versions of MAME were not as meticulous about this issue, but more recent MAME builds are. Additionally, there can be more features of a game emulated in a later release of MAME than an earlier release, requiring more ROM code to run.
* You may find that some games require CHD files. A CHD file is a compressed representation of a game's hard disk, CD-ROM, or laserdisc, and is generally not included as part of a game's ROMs. However, in most cases, these files are required to run the game, and MAME will complain if they cannot be found.
* Some games such as Neo-Geo, Playchoice-10, Convertible Video System, Deco Cassette, MegaTech, MegaPlay, ST-V Titan, and others need their BIOS ROMs in addition to the game ROMs. The BIOS ROMs often contain ROM code that is used for booting the machine, menu processor code on multi-game systems, and code common to all games on a system. BIOS ROMS must be named correctly and left zipped inside your ROMs folder.
* Older versions of MAME needed decryption tables in order for MAME to emulate Capcom Play System 2 (a.k.a. CPS2) games. These are created by team CPS2Shock.
* Some games in MAME are considered "Clones" of another game. This is often the case when the game in question is simply an alternate version of the same game. Common alternate versions of games include versions with text in other languages, versions with different copyright dates, later versions or updates, bootlegs, etc. "Cloned" games often overlap some of the ROM code as the original or "parent" version of the game. To see if you have any "clones" type "**MAME -listclones**". To run a "cloned game" you simply need to place its parent ROM file in your ROMs folder (leave it zipped).


.. _ROM-Verify:

How can I be sure I have the right ROMs?
----------------------------------------

MAME checks to be sure you have the right ROMs before emulation begins. If you see any error messages, your ROMs are not those tested to work properly with MAME. You will need to obtain a correct set of ROMs through legal methods.

If you have several games and you wish to verify that they are compatible with the current version of MAME, you can use the *-verifyroms* parameter. For example:

**mame -verifyroms robby**
...checks your ROMs for the game *Robby Roto* and displays the results on the screen.

**mame -verifyroms \* >verify.txt**
...checks the validity of ALL the ROMs in your ROMS directory, and writes the results to a textfile called *verify.txt*.


.. _Parent-Sets:

Why is it that some games have the US version as the main set, some have Japanese, and some are the World?
-----------------------------------------------------------------------------------------------------------

While this rule isn't always true, there is typically a method to how sets are arranged. The usual priority is to go with the **World** set if it's available, **US** if no World English set exists, and **Japanese** or other origin region if no World or US English set.

Exceptions arise where the US or World sets have significant censorship/changes from the original version. For instance, Gals Panic (set **galsnew**) uses the US version as parent because it has additional features compared to the world export version (set **galsnewa**). These features are optional censorship, an additional control layout option (stick with no button use), and English-language voice clips.

Another exception comes for games where it was licensed to a third party for export release. Pac-Man, for instance, was published by Midway in the US though it was created by Namco. As a result, the parent set is the Japanese **puckman** set, which retains the Namco copyright.

Lastly, a developer adding a new set can choose to use whatever naming and parent scheme they wish and are not restricted to the above rules. Most follow these guidelines, however.


.. _Legal-ROMs:

How do I legally obtain ROMs or disk images to run on MAME?
-----------------------------------------------------------

You have several options:

* You can obtain a license to them by purchasing one via a distributor or vendor who has proper authority to do so.
* You can download one of the ROM sets that have been released for free to the public for non-commerical use.
* You can purchase an actual arcade PCB, read the ROMs or disks yourself, and let MAME use that data.

Beyond these options, you are on your own.


.. _ROMs-Grey:

Isn't copying ROMs a legal gray area?
-------------------------------------

No, it's not. You are not permitted to make copies of software without the copyright owner's permission. This is a black & white issue.


.. _Abandonware:

Can't game ROMs be considered abandonware?
------------------------------------------

No. Even the companies that went under had their assets purchased by somebody, and that person is the copyright owner.


.. _Old-Sets:

I had ROMs that worked with an old version of MAME and now they don't. What happened?
-------------------------------------------------------------------------------------

As time passes, MAME is perfecting the emulation of older games, even when the results aren't immediately obvious to the user. Often times the better emulation requires more data from the original game to operate. Sometimes the data was overlooked, sometimes it simply wasn't feasible to get at it (for instance, chip "decapping" is a technique that only became affordable very recently for people not working in high-end laboratories). In other cases it's much simpler: more sets of a game were dumped and it was decided to change which sets were which version.


.. _eBay-cabs:

What about those arcade cabinets on eBay that come with all the ROMs?
---------------------------------------------------------------------

If the seller does not have a proper license to include the ROMs with his system, he is not allowed to legally include any ROMs with his system. If he has purchased a license to the ROMs in your name from a distributor or vendor with legitimate licenses, then he is okay to include them with the cabinet. After signing an agreement, cabinet owners that include legitimate licensed ROMs may be permitted to include a version of MAME that runs those ROMs and nothing more.


.. _ROM-DVDs:

What about those guys who burn DVDs of ROMs for the price of the media?
-----------------------------------------------------------------------

What they are doing is just as illegal as selling the ROMs outright. As long as somebody owns the copyright, making illegal copies is illegal, period. If someone went on the internet and started a business of selling cheap copies of the latest U2 album for the price of media, do you think they would get away with it?

Even worse, a lot of these folks like to claim that they are helping the project. In fact, they only create more problems for the MAME team. We are not associated with these people in any way regardless of how "official" they may attempt to appear. You are only helping criminals make a profit through selling software they have no right to sell. **Anybody using the MAME name and/or logo to sell such products is also in violation of the MAME trademark.**


.. _DMCA-exemption:

But isn't there a special DMCA exemption that makes ROM copying legal?
----------------------------------------------------------------------

No, you have misread the exemptions. The exemption allows people to reverse engineer the copy protection or encryption in computer programs that are obsolete. The exemption simply means that figuring out how these obsolete programs worked is not illegal according to the DMCA. It does not have any effect on the legality of violating the copyright on computer programs, which is what you are doing if you make copies of ROMs.


.. _24-hours:

But isn't it OK to download and "try" ROMs for 24 hours?
--------------------------------------------------------

This is an urban legend that was made up by people who put ROMs up for download on their sites, in order to justify the fact that they were breaking the law. There is nothing like this in any copyright law.


.. _commercial-use:

If I buy a cabinet with legitimate ROMs, can I set it up in a public place to make money?
-----------------------------------------------------------------------------------------

Probably not. ROMs are typically only licensed for personal, non-commercial purposes.


.. _Ultracade:

But I've seen Ultracade and Global VR Classics cabinets out in public places? Why can they do it?
-------------------------------------------------------------------------------------------------

Ultracade had two separate products. The Ultracade product is a commercial machine with commercial licenses to the games. These machines were designed to be put on location and make money, like traditional arcade machines. Their other product is the Arcade Legends series. These are home machines with non- commercial licenses for the games, and can only be legally operated in a private environment. Since their buyout by Global VR they only offer the Global VR Classics cabinet, which is equivalent to the earlier Ultracade product.


.. _Blackscreen-DirectX:

HELP! I'm getting a black screen or an error message in regards to DirectX on Windows!
--------------------------------------------------------------------------------------

You probably have missing or damaged DirectX runtimes. You can download the latest DirectX setup tool from Microsoft at https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=35

Additional troubleshooting information can be found on Microsoft's website at https://support.microsoft.com/en-us/kb/179113


.. _ControllerIssues:

I have a controller that doesn't want to work with the standard Microsoft Windows version of MAME, what can I do?
-----------------------------------------------------------------------------------------------------------------

By default, MAME on Microsoft Windows tries to do raw reads of the joystick(s), mouse/mice, and keyboard(s). This works with most devices and provides the most stable results. However, some devices need special drivers to translate their output and these drivers may not work with raw input.

One thing you can try is setting the keyboardprovider, mouseprovider, or joystickprovider setting (depending on which kind of device your input device acts as) from rawinput to one of the other options such as dinput or win32. See :ref:`osd-commandline-options` for details on supported providers.


.. _ExternalOPL:

What happened to the MAME support for external OPL2-carrying soundcards?
------------------------------------------------------------------------

MAME added support in version 0.23 for the use of a soundcard's onboard OPL2 (Yamaha YM3812 chip) instead of emulating the OPL2. This feature was never supported on the official Windows version of MAME and was dropped entirely as of MAME 0.60, because the OPL2 emulation in MAME had become advanced enough to be a better solution in almost all cases as of that time; now it's superior to using a sound card's YM3812 in all cases, especially as modern cards lack a YM3812.

Unofficial builds of MAME may have supported it for varying amounts of time as well.


.. _Autofire:

What happened to the MAME support for autofire?
-----------------------------------------------

A Lua plugin with providing enhanced autofire support was added in MAME 0.210,
and the old built-in autofire functionality was removed in MAME 0.216.  This
new plugin has more functionality than the built-in autofire feature in older
version of MAME; for example, you can configure a alternate buttons for
different for autofire rates.

You can enable and configure the new autofire system with the following steps:

* Start MAME with no system selected.
* Choose **Configure Options** at the bottom (use **Tab** to move focus, or
  double-click the menu item).
* Choose **Plugins** near the bottom of the Settings menu.
* Turn **Autofire plugin** on (use **Left**/**Right** or click the arrows to
  change options).

The setting will be automatically saved for future use.

Once you’re running a system of your choice, bring up the MAME menu (using the
**Tab** key by default), select **Plugin Options***, and then select
**Autofire**.  From there you can select an existing autofire button to change

The **Input** is the button on the emulated system that you want to use autofire
for.  This may be set to any player button – typically you’ll it to
*P1 Button 1* for games like Galaga, Alcon, and the like.  The **Hotkey** is the
button you press to use the autofire effect.  This can be any combination MAME
supports as a digital input.

**On frames** and **Off frames*** are how long to leave the button pressed and
released in terms of the system frame rate.  Some systems do not read the inputs
fast enough for 1 and 1 to be usable.  You may need to try 2 and 2 (e.g. Alcon)
or other combinations.  Try fine-tuning these to your taste.

The autofire configuration for each system will be saved in a ``systemname.cfg``
file (e.g. ``alcon.cfg``) inside the **autofire** folder in your plugin data
folder.  Each system will have its own configuration.

Note that if you set the autofire button to an input button that’s also assigned
to one of MAME’s inputs for the running system, you may get unexpected results.
Using Gradius as an example:

* If you set button 1 on your controller to fire, then set an autofire hotkey to
  button 1 as well, holding the button down to shoot will not trigger the
  autofire effect because the button never gets released, since you’re holding
  the non-autofire button 1.  This will also happen if you set a different
  button as autofire (say, button 3 in this case), and hold button 1 down while
  holding button 3 down.
* If you set button 3 on your controller to autofire and set button 3 to be
  powerup as well, you will trigger the powerup action every time you grab a
  powerup because the powerup button is also being held down along with the
  autofire button.

It is suggested you choose buttons for autofire hotkeys that are not in use for
anything else in the current system.


.. _gsync-freesync:

Does MAME support G-Sync or FreeSync? How do I configure MAME to use them?
--------------------------------------------------------------------------

MAME supports both G-Sync and FreeSync right out of the box for Windows and Linux, however macOS does not support G-Sync or FreeSync.

* Make sure your monitor is capable of at least 120Hz G-Sync/FreeSync. If your monitor is only capable of 60Hz in G-Sync/FreeSync modes, you will hit problems with drivers such as *Pac-Man* that run at 60.60606Hz and may hit problems with others that are very close to but not quite 60Hz.
* If playing MAME windowed or using the BGFX video system, you'll need to make sure that you have G-Sync/FreeSync turned on for windowed applications as well as full screen in your video driver. 
* Be sure to leave triple buffering turned off.
* Turning VSync on is suggested in general with G-Sync and FreeSync.
* Low Latency Mode will not affect MAME performance with G-Sync/FreeSync.

The effects of G-Sync and FreeSync will be most noticeable in drivers that run at refresh rates that are very different from normal PC refresh rates. For instance, the first three *Mortal Kombat* titles run at 54.706841Hz.