R3Ddragon 3DS: Difference between revisions

r3Ddragon
r3Ddragon
General
Author	mrdanielps
Type	Handheld
Version	0.87
License	Mixed
Last Updated	2017/02/03
Links
	Download
	Website
	Source

Latest revision as of 06:00, 6 Mayıs 2024

r3Ddragon is a WIP Virtual Boy emulator for the N3DS based on Reality Boy/Red Dragon. There's an experimental dynarec implemented but it still needs optimizing.

You can see the current progress here.

Installation

Available in 3DSX and CIA formats.

CIA - Install the .cia with the CIA manager of your choice.
3DSX - Use the .3dsx provided with the Homebrew Launcher.

You can place the ROMs in /vb/.

User guide

You can download VB homebrew games from Planet Virtual Boy.

ROM compatibility list can be found here (outdated).

Configuration

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.

FAQ

Q. 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.

Q. 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.

Q. 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.

Screenshots

Media

r3Ddragon - new 3DS improvements (Virtual Boy emulator) (danielps)

Known issues

Low compatibility.
Glitchy graphics on some commercial games.
Frame limiting is broken when frameskip is enabled.
Some menu options aren't implemented.
To change ROMs you have to exit first (touchscreen->File->Exit).

Changelog

v0.87

Removed libhax. Homebrew launcher users will have to run a kernel exploit (like fasthax) first.
Added settings for frameskip, maxcycles, sound and debug output.
Implemented floating point instructions.

Credits

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 a much better understanding of the VB internals.
Joseph LoCicero, Dave Shadoff - 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.

Thanks to:

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.

External links

@@ Line 1: / Line 1: @@
-{{Infobox-3DS-Homebrews
+{{Infobox 3DS Homebrews
-| title = r3Ddragon
+|title=r3Ddragon
-| image = https://dlhb.gamebrew.org/3dshomebrew/r3Ddragon-01.jpg|250px
+|image=R3ddragon2.png
-| type = Handheld
+|description=A Virtual Boy emulator for the N3DS.
-| version=v0.87
+|author=mrdanielps
-| lastupdated = 2017/02/03
+|lastupdated=2017/02/03
-| licence = Mixed
+|type=Handheld
-| author = mrdanielps
+|version=0.87
-| website = https://github.com/mrdanielps/r3Ddragon
+|license=Mixed
-| download = https://dlhb.gamebrew.org/3dshomebrew/r3Ddragon-v0.87-3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/r3ddragon.7z
-| source =  https://github.com/mrdanielps/r3Ddragon
+|website=https://gbatemp.net/threads/wip-r3ddragon-virtual-boy-emulator.397411
+|source=https://github.com/mrdanielps/r3Ddragon
 }}
-<youtube>xJ9323yaQJY</youtube>
+r3Ddragon is a WIP Virtual Boy emulator for the N3DS based on Reality Boy/Red Dragon. There's an experimental dynarec implemented but it still needs optimizing.
-=r3Ddragon=
-A WIP Virtual Boy emulator for the 3DS based on Reality Boy / Red Dragon. You can see the current progress
-[here](https://github.com/mrdanielps/r3Ddragon/wiki/Current-progress) and a video of it working
+You can see the current progress [https://github.com/mrdanielps/r3Ddragon/wiki/Current-progress here].
-There's an experimental dynarec implemented but it still needs optimizing.
+==Installation==
+Available in 3DSX and CIA formats.
+* CIA - Install the .cia with the CIA manager of your choice.
+* 3DSX - Use the .3dsx provided with the Homebrew Launcher.
-==Usage==
+You can place the ROMs in /vb/.
-You can place place ROMs in /vb/.
+==User guide==
+You can download VB homebrew games from [https://www.virtual-boy.com/homebrew Planet Virtual Boy].
-If it doesn't exist, `rd_config.ini` will be created. Some relevant options you can change are:
+ROM compatibility list can be found [https://github.com/mrdanielps/r3Ddragon/wiki/ROM-Compatibility here] (outdated).
-* _maxcycles_: A lower value will improve compatibility, but it will run slower.
+===Configuration===
-* _frmskip_: Number of frames to skip before drawing.
+If it doesn't exist, rd_config.ini will be created. Some relevant options you can change are:
-* _debug_: If set to 1, prints debug info.
+* maxcycles - A lower value will improve compatibility, but it will run slower.
-* _sound_: Enables sound.
+* frmskip - Number of frames to skip before drawing.
-* _dynarec_: If set to 0, tries to load the dynarec cache from a file instead of recompiling.
+* 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](https://github.com/nedwill/fasthax/releases).
+===FAQ===
+'''Q. Why would you make a Virtual Boy emulator? Nobody asked for it.'''
-==FAQs==
+The 3DS is the perfect system to faithfully emulate the Virtual Boy.
-> Why would you make a Virtual Boy emulator? Nobody asked for it.
+They have similar screen resolutions, the 3D effect is better and it's actually portable.
-The 3DS is the perfect system to faithfully emulate the Virtual Boy. They have similar screen resolutions, the
+'''Q. OK, but wasn't the Virtual Boy, like, the worst console ever?'''
-D 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.
-There were many reasons why it was commercial failure. That doesn't mean the console is bad, or the games
+It's definitely received way more hate than it deserved.
-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?
+'''Q. 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,
+Unfortunately, yes. The old 3DS is too slow to run it at a playable speed.
-but it's unlikely.
-> Where can I download it?
+That might change in the future, but it's unlikely.
-You can find the latest release [here](https://github.com/mrdanielps/r3Ddragon/releases).
+==Screenshots==
+https://dlhb.gamebrew.org/3dshomebrews/r3ddragon3.png
+https://dlhb.gamebrew.org/3dshomebrews/r3ddragon4.png
-==Building==
+https://dlhb.gamebrew.org/3dshomebrews/r3ddragon5.png
+https://dlhb.gamebrew.org/3dshomebrews/r3ddragon6.png
-Once you have [ctrulib installed](http://3dbrew.org/wiki/Setting_up_Development_Environment), you can choose
+https://dlhb.gamebrew.org/3dshomebrews/r3ddragon7.png
-between four different make targets:
+https://dlhb.gamebrew.org/3dshomebrews/r3ddragon8.png
-* **`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`.
+==Media==
-* **`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.
+'''r3Ddragon - new 3DS improvements (Virtual Boy emulator)''' ([https://www.youtube.com/watch?v=xJ9323yaQJY danielps]) <br>
-* **`make debug`** adds `-g -O0` to CFLAGS. It builds without optimizations so it can be debugged with gdb.
+<youtube>xJ9323yaQJY</youtube>
-* **`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`.
+==Known issues==
+* Low compatibility.
+* Glitchy graphics on some commercial games.
+* Frame limiting is broken when frameskip is enabled.
+* Some menu options aren't implemented.
+* To change ROMs you have to exit first (touchscreen->File->Exit).
-== License==
+==Changelog==
+'''v0.87'''
-Some of the code is distributed under the MIT License (check source files for that) but, since
+* Removed libhax. Homebrew launcher users will have to run a kernel exploit (like fasthax) first.
-this is a port of Reality Boy, here is (part of) the original readme:
+* Added settings for frameskip, maxcycles, sound and debug output.
+* Implemented floating point instructions.
-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==
+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 a much better understanding of the VB internals.
+* Joseph LoCicero, Dave Shadoff - 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.
+Thanks to:
 * Everyone mentioned in the license. Without Reality Boy and Red Dragon it wouldn't have been possible.
 * smealum and contributors - ctrulib.
@@ Line 131: / Line 105: @@
 * danielps - 3DS port and V810 dynarec.
-==Changelog:==
+==External links==
-* Removed libhax. Homebrew launcher users will have to run a kernel exploit (like fasthax) first.
+* GitHub - https://github.com/mrdanielps/r3Ddragon
-* Added settings for frameskip, maxcycles, sound and debug output.
+* GBAtemp - https://gbatemp.net/threads/wip-r3ddragon-virtual-boy-emulator.397411
-* Implemented floating point instructions.
+* GBAtemp - https://gbatemp.net/threads/red-dragon-3ds-nintendo-virtual-boy-emulator-port.374558
-===Known Issues:===
-* Low compatibility.
-* Glitchy graphics on some commercial games.
-* Frame limiting is broken when frameskip is enabled.
-* Some menu options aren't implemented.
-* To change ROMs you have to exit first (touchscreen->File->Exit).