raz0red / wiirtual-boy

Wiirtual Boy is a port of the Mednafen Virtual Boy emulator to the Wii. (No longer maintained, a much improved version of the Wii Virtual Boy emulator is part of the wii-mednafen project)

---

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

wiirtual-boy's Issues

Battery save support (or .sav files)

What steps will reproduce the problem?
1. The easiest way to catch this problem is to play Virtual Boy Wario Land. 
Complete the first level (by finding the key and go up the elevator).
2. Go up again, and you'll be in a room that tallies up coins and treasure. 
Most importantly the game is saved here.
3. To be safe, go up again to start the second level. Exit the game and/or 
emulator.

What is the expected output? What do you see instead?
In the case of Wario Land, progress should've been saved after completing the 
first level. There should be a 1 in one of the save blocks, but all three 
blocks are blank as if it's a brand new save.

What version of the product are you using? On what operating system?
0.1

Please provide any additional information below.
Don't know if this will help, but when using Mednafen 0.9 WIP on the PC (the 
one that added VB support and the one I assume is the basis for this emulator), 
the save file, with wario.vb as the ROM name, appears in the sav folder as:

wario.fb4dc9f4ebd506702eb49e99a62bd803.sav

Original issue reported on code.google.com by [email protected] on 30 Jun 2011 at 2:57

v810_cpu.cpp is missing from master

I've been able to compile the 0.1 tag but the latest release appears to be missing v810_cpu.cpp in mednafen/src/hw_cpu/v810/v810_cpu.cpp. It looks like it was deleted in b870baf#diff-c56a2038a157dad9d4a46eb73f03ab63

Do you happen to have the latest version that could be added to the git repo?

Multilanguage support

Can it be implemented multilanguage support like the one that exists in some 
other emulator (like vbgagx)?
Can you do it?

I can translate your emulator to Portuguese from Portugal.

Original issue reported on code.google.com by [email protected] on 25 Jun 2011 at 11:15

Need Wii Channel

Well I Look in some websites but need one

Original issue reported on code.google.com by [email protected] on 2 Aug 2013 at 9:06