# MiSTer_Arcade_Database

The MiSTer_Arcade_Database repo contains files and list about the different arcade core MRAs that are available for MiSTer. The purpose of this database is to be used with the [Arcade Organizer script](https://github.com/theypsilon/_arcade-organizer "Arcade Organizer script") that [theyepsilon](https://github.com/theypsilon/_arcade-organizer "theyepsilon") has created. This is a continuation of what [Porkshop Express](https://twitter.com/misteraddons "Porkshop Express") created and maitained (the repo is now gone).

Anything missing?
Create an issue ticket.

Auto-Generated json DB file at: 
https://github.com/Toryalai1/MiSTer_ArcadeDatabase/tree/db

## How to generate your own MAD Database:

1. Create your own public repository on GitHub
2. Place the contents of this zip (https://github.com/theypsilon/MAD_Database_MiSTer/archive/refs/heads/main.zip) on your new public repository as-is
3. Make sure that there is a .github hidden folder there, if there isn't go back to Step 2, cause something was not copied correctly.
4. Substitute the contents of the mad folder with files of your own. The folder structure inside mad does not matter, it will just look for files with the .mad extension.
5. Commit and push the changes.
6. After 5 mins, your new repository will generate a new branch named db by itself, this is an automatic task. It will contain the zipped json that we need in the [Arcade Organizer](https://github.com/theypsilon/_arcade-organizer/).

## MAD Schema

MAD files are XML files that have to be validated against [this schema](mad_schema.xsd).

An example of a valid MAD file would be the following:

```xml
<?xml version="1.0" ?>
<misterarcadedescription>

	<setname>ddonpach</setname>
	<name>DoDonPachi (JP)</name>
	<region>Japan</region>
	<alternative>yes</alternative>
	<parent_title>DonPachi</parent_title>
	<platform>CAVE 68000</platform>
	<series>DonPachi</series>
	<homebrew>no</homebrew>
	<bootleg>no</bootleg>
	<year>1997</year>
	<manufacturer>CAVE</manufacturer>
	<category>Shooter - Vertical</category>
	<best_of>theypsilon Top Shmups|1</best_of>

	<rotation>vertical (ccw)</rotation>
	<flip>yes</flip>
	<resolution>15kHz</resolution>

	<players>2 (simultaneous)</players>
	<move_inputs>8-way</move_inputs>
	<special_controls></special_controls>
	<num_buttons>3</num_buttons>

</misterarcadedescription>
```
```