This page describes on how to add your own games to the gamepack.

BlueMSX-wii needs a directory structure on your SD-card. Games are stored under SD:/MSX/Games/

In this folder, there should be a dirlist.xml OR gamelist.xml, only one of these files may be present.

  • The contents of dirlist.xml

as an example, I will take the contents of the dirlist in the gamepack which is installed with the application

<DirectoryList>
  <Item Name="MSX1 Demos" Directory="MSX1Demos"/>
  <Item Name="MSX2 Demos" Directory="MSX2Demos"/>
  <Item Name="Remakes" Directory="Remakes"/>
  <Item Name="MSXDev '08" Directory="MSXDev08"/>
  <Item Name="MSX Machines" Directory="Machines"/>
</DirectoryList>

The "Name" items specify the name as shown in the emulator, the Directory is the directory on the SD-card. Please keep in mind that the filesystem on the wii is case sensitive, and thus these need to be specified correctly.

Each directory can have other dirlist.xml files.

  • The contents of gamelist.xml

<GameList>
  <Game Title="01 Deep Dungeon">
    <CommandLine>/machineMSX /rom1 msxdev08.zip /rom1zip 01-DDUNGEON.ROM</CommandLine>
    <ScreenShot>01-DDUNGEON-1.png</ScreenShot>
    <ScreenShot>01-DDUNGEON-2.png</ScreenShot>
  </Game>
  <Game Title="02 I Need Speed">
  <CommandLine>/machine MSX /rom1 msxdev08.zip /rom1zip 02-ineedspeed.rom</CommandLine>
    <Settings KeyboardJoystick="true"/>
    <ScreenShot>02-ineedspeed-1.png</ScreenShot>
    <ScreenShot>02-ineedspeed-2.png</ScreenShot>
  </Game>
</GameList>

A game element should always specify the Title, which is the name that is shown in the emulator.

  • Commandline

The CommandLine specifies settings to start the emulator, it basically specifies the machine, disks, roms and cassettes.
It is possible to specify the following:
/machine MSX
/machine MSX2
/machine MSX2+
/machine "MSX2 - No Moonsound" (default)
/machine MSXturboR
These machines are the most commonly used machines, the MSX and MSX2 are european, MSX2+ is japanese
It is possible to supply any machine available in the SD:/MSX/Machines/ folder.
NOTE1: Filenames with spaces need to be double quoted, otherwise the XML file is invalid
NOTE2: Default machine is without moonsound because it adds noticable loading time. If a game supports moonsound, use /machine MSX2.

To load roms:
/rom1 file.zip or file. (rom, ri, mx1, mx2, col, sg, sc)
/rom1zip file.rom (necessary when you have multiple rom files in your zip, makes it possible to disk-change using a hotkey (default key = F11))
/romtype1 name (most of the romtypes are autodetected, if it is not working you need to specify the romtype, see list of romtypes below)
/rom2
/rom2zip
/romtype2

To load disks:
/diskA file.zip or file. (dsk, di1, di2, 360, 720, Sf7)
/diskAzip (necessary when you have multiple rom files in your zip, makes it possible to disk-change using a hotkey (default key = F11))
/diskB
/diskBzip

To load cassettes:
/cas file.zip or file.cas
/caszip

To make things extra clear, an example:
<CommandLine>/machine MSX2 /diskA Magnar.zip /diskAzip Magnar-1.dsk</CommandLine>

  • Settings

The Settings element can only have the attribute KeyboardJoystick="true", to map WiiMote 1 as keyboard control and WiiMote 2 as joystick 1. More about this mapping can be found in the guide "Customizing controller buttons"

  • KeyMap

Not shown, but also possible is a KeyMap element, to customize the controller buttons, read the guide "Customizing controller buttons" for more information.

  • Screenshot

The Screenshot elements specify which screenshots are shown when the game is selected in the emulator. The maximum number of screenshots specified is 2. Screenshots can be generated via the home-menu, when running the games.
For these screenshots, there must be a folder named "Screenshots" (don't forget the capital).

  • List of available romtypes:

Megaroms:
"ASCII16"
"ASCII16SRAM2"
"ASCII8"
"ASCII8SRAM8"
"KoeiSRAM8"
"KoeiSRAM32"
"Konami"
"KonamiSCC"
"Manbow2"
"MegaFlashRomScc"
"Halnote"
"HarryFox"
"Playball"
"HolyQuran"
"CrossBlaim"
"Zemina80in1"
"Zemina90in1"
"Zemina126in1"
"Wizardry"
"GameMaster2"
"SuperLodeRunner"
"R-Type"
"Majutsushi"
"Synthesizer"
"KeyboardMaster"
"GenericKonami"
"SuperPierrot"
"WordPro"
"Normal"
"MatraInk"
"NettouYakyuu"

System roms:
"Bunsetsu"
"CasPatch"
"Coleco"
"MegaCart"
"SG1000"
"SC3000"
"SG1000Castle"
"SegaBasic"
"FMPAC"
"FMPAK"
"DiskPatch"
"Jisyo"
"Kanji1"
"Kanji12"
"MB8877A"
"SVI738FDC"
"TC8566AF"
"TC8566AFTR"
"WD2793"
"Microsol"
"MoonSound"
"SunriseIDE"
"BeerIDE"
"GIDE"
"GoudaSCSI"
"NMS1210"
"fsa1fm2"
"FSA1FM2"
"Panasonic8"
"PanasonicDram"
"PanasonicWx16"
"Panasonic16"
"Panasonic32"
"A1FMModem"
"fsa1fm1"
"FSA1FM1"
"Standard16K"
"SVI328CART"
"SVI80COL"
"SVI727"
"SVI738FDC"
"MSX-AUDIO"
"MSX-MUSIC"
"National"
"CX5M-MUSIC"
"VMX80"
"HBI-V1"
"SFG-01"
"SFG-05"
"NET"
"SF-7000IPL"
"FMDAS"
"Obsonet"
"Dumas"
"NoWind"

SG-1000 roms:
"sg1000castle"

Romtypes unsupported by media database:
"0x4000"
"0xC000"
"auto"
"basic"
"mirrored"
"forteII"
"msxdos2"
"konami5"
"konami4"
"ascii8"
"halnote"
"konamisynth"
"kbdmaster"
"majutsushi"
"ascii16"
"gamemaster2"
"ascii8sram"
"koei"
"ascii16sram"
"konami4nf"
"ascii16nf"
"snatcher"
"sdsnatcher"
"sccmirrored"
"sccexpanded"
"scc"
"sccplus"
"scc-i"
"scc+"
"pac"
"fmpac"
"fmpak"
"rtype"
"crossblaim"
"harryfox"
"loderunner"
"korean80"
"korean90"
"korean126"
"holyquran"
"coleco"
"sg1000"
"castle"