WiirtualBoy v0.1 release README

Ported by raz0red and Arikado

[http://www.twitchasylum.com] [http://arikadosblog.blogspot.com/]

Overview

WiirtualBoy is a Wii port of the Mednafen Virtual Boy Emulator [http://mednafen.sourceforge.net/].

Installation

To install WiirtualBoy, simply extract the zip file directly to your SD card or USB device (retain the hierarchical structure exactly).

Cartridge images must be placed in the roms directory (/wiivb/roms).

Known Issues

• Colors are not 100% accurate in 3D display modes (2D modes are accurate).
• Sound may not be 100% accurate
• Due to the current emulation speed, several games require frame skipping to run at full speed (see cartridge compatibility).
• Frame skipping may cause graphical corruption. Some games do not run at full speed as adding frame skipping causes too much corruption (see cartridge compatibility).

Cartridge Database

WiirtualBoy ships with a database that contains recommended settings for most commercial cartridges. These settings cover control mappings, display settings including frame skipping, etc.

To view/edit the settings applied for a particular cartridge perform the following steps:

• Load the cartridge (via the "Load cartridge" menu item)
• Return to the WiirtualBoy menu
• Select the "Cartridge settings (current cartridge)" menu item
• Examine the "Control" and "Display" settings for the cartridge

Cartridge Compatibility

The WiirtualBoy Cartridge Compatibility page lists each game that has been tested along with its associated hash values (one for the full file, one that excludes the header information).

[http://www.wiibrew.org/wiki/WiirtualBoy/Cartridge_Compatibility]

Enable the "Debug mode" option within the "Advanced" menu to view the hash (excluding header information) when a cartridge is playing.

Controls

The following section contains the "default" control mappings for WiirtualBoy.

It is important to note that if the cartridge that is being loaded exists in the Cartridge Database it may contain non-default mappings.

WiirtualBoy menu:

Wiimote:

  Left/Right  : Scroll (if sideways orientation)
  Up/Down     : Scroll (if upright orientation)
  A/2         : Select 
  B/1         : Back
  Home        : Exit to Homebrew Channel
  Power       : Power off

Classic controller/Pro:

  Up/Down     : Scroll
  A           : Select 
  B           : Back
  Home        : Exit to Homebrew Channel

Nunchuk controller:

  Up/Down     : Scroll
  C           : Select 
  Z           : Back

GameCube controller:

  Up/Down     : Scroll
  A           : Select 
  B           : Back
  Z           : Exit to Homebrew Channel

In-game (Defaults):

Wiimote:

  D-pad          : Left control pad
  2              : A button
  1              : B button
  A              : R button
  B              : L button
  +              : Start
  -              : Select
  Home           : Display WiirtualBoy menu (see above)

Wiimote + Nunchuk:

  D-pad          : Right control pad
  Analog         : Left control pad
  A              : A button
  B              : R button
  C              : B button
  Z              : L button
  +              : Start
  -              : Select      
  Home           : Display WiirtualBoy menu (see above)

Classic controller/Pro:

  D-pad          : Left control pad
  Left analog    : Left control pad
  Right analog   : Right control pad
  A              : A button
  B              : B button
  R/zR           : R button
  L/zL           : L button
  +              : Start
  -              : Select
  Home           : Display WiirtualBoy menu (see above)

GameCube controller:

  D-pad          : Left control pad
  Left analog    : Left control pad
  Right analog   : Right control pad
  A              : A button
  B              : B button
  R              : R button
  L              : L button
  Start          : Start
  X/Y            : Select
  Z              : Display WiirtualBoy menu (see above)

WiirtualBoy crashes, code dumps, etc.

If you are having issues with WiirtualBoy, please let us know about it via one of the following locations:

[http://www.wiibrew.org/wiki/Talk:WiirtualBoy] [http://www.twitchasylum.com/forum/viewtopic.php?t=1253]

Special Thanks

• Tantric : Menu example code and SDL enhancements
• Mednafen team : Providing an incredible emulator along with valuable insights and suggestions during the port.

Change Log

06/23/11 (0.1)

• Initial public release
  • Improved sound quality
  • Left and right sound channels are now correct
  • Several minor bug fixes
  • Minor performance improvements

06/13/11 (0.0)

• Pre-release