Name: mame2003-plus-libretro
Owner: libretro
Description: Updated 2018 version of MAME (0.78) for libretro. with added game support plus many fixes and improvements
Created: 2018-01-06 20:56:53.0
Updated: 2018-05-24 15:44:08.0
Pushed: 2018-05-24 21:11:37.0
Size: 40020
Language: C
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
mame2003-plus is built on the same codebase as MAME 0.78, meaning that 95% or more of MAME 0.78 romsets will work as-is in mame2003-plus, where they immediately benefit from its bugfixes and other improvements. In order to play the new games and games which received ROM updates in mame2003-plus, you will need to find or build the correct romsets.
mame2003-plus has the ability to generate an XML “DAT” file directly from the MAME Menu. When mame_keyboard input is enabled, you can enter the MAME menu by pressing the Tab key. With any input mode, you can also access the MAME menu by turning it on as a core option.
What is a romset? Arcade games are packaged as zip files, most of which are composed of more than one individual 'ROM' files. That is why some resources refer to an individual arcade game as a ROM (like people use to describe a zipped game cartridge ROM) while other resources refer to an individual game as a ROM set, ROMset, or romset.
DAT files describe the exact ROM contents that the emultaor needs including filenames, file sizes, and checksums to verify contents are not incorrect or corrupt. mame2003-plus has the ability to generate an XML “DAT” file from the MAME Menu. When mame_keyboard input is enabled, you can enter the MAME menu by pressing the Tab key. With any input mode, you can also access the MAME menu by turning it on as a core option.
A complete MAME 0.78 romset collection and a complete MAME 0.139 romset collection together include nearly all ROMs needed to rebuild a complete collection of mame2003-plus romsets. It is also be possible to build a complete mame2003-plus collection from the most recent MAME collection plus the MAME “Rollback” collection.
Refer to Validating, Rebuilding, and Filtering ROM Collections for details on how to configure ClrMamePro to use your sources as “rebuild” folders.
We recommend the “Full Non-Merged” format, where each romset zip files includes all the files needed to run each game, including any ROMs from 'parent' ROM sets and BIOS sets. To configure ClrMamePro to validate or rebuild a Full Non-Merged collection, use “Non-Merged” mode and disable “Separate BIOS Sets” from the “Advanced” menu in both ClrMamePro's Rebuild and Scanner menus.
ClrMamePro remains the most popular tool for rebuilding MAME romsets, at least for now. That said, ClrMamePro is focused on supporting more recent MAME versions so there are at least two things to know if you are using ClrMamePro to generate a mame2003-plus set:
Settings -> Compressor -> CHDMan tab and change Req. CHD Version to 3.Disable Separate BIOS Sets then ClrMamePro will report the BIOS romset files as missing even though you told the program you don't want them. mame2003-plus incorporates 15 different kinds of BIOS romsets, so it is normal to see a ClrMamePro message like this after a clean and complete scan: You are missing 15 of 4831 known mame2003-plus.xml sets (+ BIOS sets)mame2003-plus uses exactly the same MAME 0.78 CHDs as mame2003.
Generally mame2003-plus uses the same samples as mame2003 however there are some exceptions. It should also be mentioned that the new CD soundtrack samples are not circulated as part of any common packs.
Sample sourcing docs are a work in progress.
The modern layout sets mame2003-plus to the same input configration as Final Burn Alpha (FBA). This layout is the fight stick & pad layout popularized by Street Fighter IV and assumes an 8+ button controller.
The SNES layout strives to map arcade games to match their Super Nintendo / Super Famicom ports when possible. When there is no SNES port as a reference, the SNES layout aims to set sensible defaults with that controller layout in mind. The SNES layout only needs a 6+ button controller by default and is not intended for 8+ button fight sticks.
The MAME Classic input mode uses mainline MAME's default Xbox 360 controller layout. This layout is not a good match for 6-button fighters, but may suit other games.
mame_keyboard sets the core to process keyboard input directly through the legacy “MAME” keyboard interface. Use this input mode only if your input device is seen as a keyboard, including some arcade control panel hardware.
In mame2003-plus, the MAME menu can be accessed via “retropad” users by activating it in the core options. If your input mode is set to allow input to the mame_keyboard interface, you can also enter the menu by pressing the Tab key.
Some MAME games require data from an internal hard drive, CD-ROM, laserdisk, or other media in order to be emulated – those forms of media are packaged as CHD files. CHD files should be copied to subfolders within the folder where the MAME ROM zips have been installed. e.g.:
retro content dir/blitz/blitz.chd
Some games require an additional zip file with recorded sounds or music in order for audio to work correctly. Audio 'sample' files should be placed in subdirectories within /libretro system dir/mame2003-plus/ e.g.:
retro system dir/mame2003-plus/samples/
Cheat and history metadata files should be moved from github's /libretro/mame2003-plus-libretro/tree/master/metadata and placed within /libretro system dir/mame2003-plus/ e.g.:
retro system dir/mame2003-plus/cheat.dat
retro system dir/mame2003-plus/history.dat
Backdrop artwork zip files should be placed in a sub-directory within the system folder:
retro system dir/mame2003-plus/artwork
User-generated content is placed in subdirectories within /libretro savefile dir/mame2003-plus/:
retro savefile dir/mame2003-plus/cfg/
retro savefile dir/mame2003-plus/diff/
retro savefile dir/mame2003-plus/hi/
retro savefile dir/mame2003-plus/memcard/
retro savefile dir/mame2003-plus/nvram/
The first value listed for the core option represents the default. “Restart” indicates that the core must be restarted in order for changes to that option to take effect.
0|1|2|3|4|5retropad|mame_keyboard|simultaneousmodern|SNES|MAME classicmouse|pointer|disabled - Switch between mouse (e.g. hardware mouse, trackball, etc), pointer (touchpad, touchscreen, lightgun, etc), or disabled. Defaults to pointer in iOS.enabled|disableddisabled|enabled1.0|0.2|0.3|0.4|0.5|0.6|0.7|0.8|0.9|1.1|1.2|1.3|1.4|1.5|1.6|1.7|1.8|1.9|2.01.2|0.5|0.6|0.7|0.8|0.9|1.1|1.2|1.3|1.4|1.5|1.6|1.7|1.8|1.9|2.0disabled|enableddefault|asia|asia-aes|debug|europe|europe_a|japan|japan_a|japan_b|taiwan|us|us_a|uni-bios.10|uni-bios.11|uni-bios.13|uni-bios.20disabled|enabled - Some dial/spinner hardware are actually one device with one axis for each player. This supports that setup, by invisibly breaking down the normal mouse x/y into two separate inputs.disabled|enabled - Player 1 uses Joysticks 1 & 2, Player 2 uses Joysticks 3 & 4enabled|disabled - Invisibly remap the retropad's right analog stick to serve as buttonsdisabled|enabled - Enable if rotating display for vertically oriented games (Pac-Man, Galaga, etc). Requires video_allow_rotate = "false" cfg setting in RetroArch.1|2|3|4|5|6disabled|enabledenabled|disabled1|2|3|4|520|0|10|20|30|40|50|60|70|80|90|100,1.5|0.5|1|2|2.5|3disabled|enabled48000|8000|11025|22050|44100 - Change this manually only for specific reasons. The audio sample rate has far-reaching consequences.enabled|disabled - Speedhack for the Midway sound hardware used in Mortal Kombat 2, 3 and others. Improves performance in these games.disabled|enabledlibretro cores like mame2003-plus are designed to run on many different combinations of hardware, operating system, and content. It is not possible for a volunteer-based open source project to test all possible combinations.
The answer to this dilemma involves “logs”, which open source software use to record essential information about your system and its function that other users and volunteers need in order to help troubleshoot problems and improve compatibility.
Often log files are lengthy which make them difficult to read when they're pasted directly into a post on the forums or github. If your log file is more than six or seven lines long, you will be asked to post a link to it instead.
One free and straightforward system for posting and sharing logs is Github Gist. You can paste the contents of a log file, or the log file itself, into the Gist website. After you log has been added to the Gist, press the Create Public Gist button to create a shareable link.
Please refer to the doc Generating RetroArch Logs for details on using RetroArch GUI and commandline options to generate logs.
Use RetroPie's Runcommand system to instruct RetroArch to direct the mame2003-plus log to the file /dev/shm/runcommand.log. You will then need to consult the RetroPie docs in order to access that file to paste into a Gist.
Placeholder