A Virtual Boy emulator for the 3DS
Clone or download
mrdanielps Remove libkhax.
Adds support for 9.2+ consoles, as long as they're exploitable.
Latest commit 5334057 Feb 2, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
include Properly implement (most) floating-point instructions Aug 16, 2016
jni Initial sound support Jan 17, 2016
resources Update makerom and fix CIA build Oct 11, 2015
source Remove libkhax. Feb 2, 2017
tools Update tools May 19, 2016
.gitmodules Remove libkhax. Feb 2, 2017
Makefile Remove libkhax. Feb 2, 2017
Makefile.linux Improve arm-linux makefile May 14, 2016
README.md Remove libkhax. Feb 2, 2017
icon.png Fix icon transparency Jun 12, 2015

README.md

r3Ddragon

A WIP Virtual Boy emulator for the 3DS based on Reality Boy / Red Dragon. You can see the current progress here and a video of it working here.

There's an experimental dynarec implemented but it still needs optimizing.

###Usage

You can place place ROMs in /vb/.

If it doesn't exist, rd_config.ini will be created. Some relevant options you can change are:

  • maxcycles: A lower value will improve compatibility, but it will run slower.
  • frmskip: Number of frames to skip before drawing.
  • debug: If set to 1, prints debug info.
  • sound: Enables sound.
  • dynarec: If set to 0, tries to load the dynarec cache from a file instead of recompiling.

The 3dsx will only work on exploitable system versions (<=11.2) after running fasthax.

###FAQs

Why would you make a Virtual Boy emulator? Nobody asked for it.

The 3DS is the perfect system to faithfully emulate the Virtual Boy. They have similar screen resolutions, the 3D effect is better and it's actually portable.

OK, but wasn't the Virtual Boy, like, the worst console ever?

There were many reasons why it was commercial failure. That doesn't mean the console is bad, or the games aren't worth playing. It's definitely received way more hate than it deserved.

Plus, it has a nice homebrew scene with gems such as Hyper Fighting, Snatcher and many more.

Do I need a new 3DS to run this?

Unfortunately, yes. The old 3DS is too slow to run it at a playable speed. That might change in the future, but it's unlikely.

Where can I download it?

You can find the latest release here.

###Building

Once you have ctrulib installed, you can choose between four different make targets:

  • make release adds -O3 to CFLAGS. It's meant to be run on an actual 3DS and will output basic debug info to stdout only if enabled in rd_config.ini.
  • make testing adds -O3 to CFLAGS. It's meant to be run on an emulator (citra or 3dmoo). It will output basic debug info to the terminal.
  • make debug adds -g -O0 to CFLAGS. It builds without optimizations so it can be debugged with gdb.
  • make slowdebug adds -g -O0 to CFLAGS. It will output a lot of debug information, which will slow emulation down but might be helpful to debug game-specific issues.

For easier debugging, you can build it for arm-linux (tested on a Raspberry Pi) with make -f Makefile.linux or for android using ndk-build.

###License

Some of the code is distributed under the MIT License (check source files for that) but, since this is a port of Reality Boy, here is (part of) the original readme:

This Reality Boy emulator is copyright (C) David Tucker 1997-2008, all rights
reserved.   You may use this code as long as you make no money from the use of
this code and you acknowledge the original author (Me).  I reserve the right to
dictate who can use this code and how (Just so you don't do something stupid
with it).
Most Importantly, this code is swap ware.  If you use It send along your new
program (with code) or some other interesting tidbits you wrote, that I might be
interested in.
This code is in beta, there are bugs!  I am not responsible for any damage
done to your computer, reputation, ego, dog, or family life due to the use of
this code.  All source is provided as is, I make no guaranties, and am not
responsible for anything you do with the code (legal or otherwise).
Virtual Boy is a trademark of Nintendo, and V810 is a trademark of NEC.  I am
in no way affiliated with either party and all information contained hear was
found freely through public domain sources.

Acknowledgments:
----------------

Frostgiant, Parasyte, and DogP (and the rest of people that have contributed
to the VB sceen in the last five years) - Their work on Red_Dragon has been a
real inspiration. Its amazing how far they have gone with so little to start
with.

Bob VanderClay - most of the original code is based off
of his VB disassembler.

Ben Haynor - Provided me with a much better understanding of
the VB internals.

Joseph LoCicero, Dave Shadoff - I stole the jump table ideas from their tg16
disassembler, thanks guys.

Neill Corlett - took many ideas (and some code)
from his Starscream CPU core

Kevin Banks - for donating a very nice pair of Frenzle 3D
viewers, and being an all around great guy.

Megan Tucker - For putting up with my tinkering all night, and resisting the
urge to toss all my video games out the window.

v810 is a trademark of NEC co.
Virtual Boy is a trade mark of Nintendo
Reality Boy is in no way affiliated with either of these parties

###Credits

  • Everyone mentioned in the license. Without Reality Boy and Red Dragon it wouldn't have been possible.
  • smealum and contributors - ctrulib.
  • Vappy, Team Fail, HtheB, hippy dave and kane159 on GBAtemp - early testing.
  • benhoyt - inih.
  • Myria - libkhax
  • thunderstruck - CIA banner sound (taken from Fishbone).
  • nop90 - Reality Boy backports and fixes.
  • danielps - 3DS port and V810 dynarec.