We're using cookies to ensure you get the best experience on our website. More info

Whether you’re a veteran Virtual Boy homebrew developer or are just getting started, here you’ll find all the resources you will ever need on your endevours.

Getting started

If you want to get into software development for the Nintendo Virtual Boy, the following chapters will hopefully give you a good overview over the tools and resources, and get you started quickly.

To get to grips with the Virtual Boy hardware, we strongly encourage you to have a look at the best Virtual Boy hardware documentation there is, the VB Sacred Tech Scroll, and its chapter about the Virtual Image Processor (VIP) in particular.

Even if very technical documents like the above may look a bit intimidating at first, don’t worry – the Virtual Boy is actually a pretty simple system compared to many other consoles! Plus you won’t need a too deep understanding about the VB’s inner working, especially when working with higher level tools like VUEngine Studio, but it certainly helps to know at least the basics of how the VIP works.

The Right Tools for the Job

The first question you’ll have to ask yourself is which language you want to write your program in. With the available tools, the choices are ASM or C. Unless you’re a low-level pro, prefer a good challenge or are simply a masochist, the answer will be C for the vast majority of people.

The next choice is that of the library or engine to use. Ever since the homebrew community started using patched copies of GCC, the GNU C Compiler, to compile their code, libgccvb has been the de facto standard library, used by almost every Virtual Boy homebrew project ever made. It is a leightweight collection of functions that provides some basic functionality to interact with the hardware.

If you need something more powerful, the other major option is VUEngine, a versatile, object oriented Nintendo Virtual Boy game engine. It certainly has a much more steep learning curve to it, but once you get the hang of it, it will empower you to create amazing Virtual Boy homebrew with ease, while the engine abstracts away, and takes care of, any and all hardware management tasks. There’s various extensive open source demos available to build upon and learn from, such as a platformer, or a multiplayer game demo, as well as a rich ecosystem of plugins.

No matter which of the two you choose, the recommended tool is VBDE (Virtual Boy Development Environment). A complete Virtual Boy development environment for Windows. Only download, unzip and start working, no installation, no hassle. It comes in the form of an editor with buttons for compiling, running compiled ROMs on an emulator or flashing them to a FlashBoy.

VBDE not only comes with all the tools you need for VB homebrew development, it also contains a lot of example code for both libgccvb and VUEngine which can be used as a starting base for new projects. We recommend messing around with one of the barebone demos to get started.

For testing ROMs right on your computer, the recommended emulator is Mednafen (bundled with VBDE). For playing on hardware, you’ll need a flash cart such as HyperFlash32 or FlashBoy (used, since it’s no longer being sold).

(Note that VBDE has since been superceded by VUEngine Studio (“VES”), a dedicated IDE similar to Visual Studio Code, and is considered dead. However, VES has not been publically released yet, so VBDE is still the way to go in mid-2021.)

Additional resources

Check out the tools section for additional tools. More documentation can be found here. For some inspiration, you can browse our extensive homebrew database to check out all the projects by other authors.

If you need help, our competent and friendly community will be happy to borrow some brain juice. Feel free to seek for advice in our Development Forum or, if you prefer a more direct way of getting in touch, our Discord server.

Quick Links
Latest Dev Forum posts
Virtual Boy Hardware Schematics Nov 19, 2021 • 14:00 Development • 3L_S4N70
VB Decade Case Oct 29, 2021 • 06:42 Development • ianthegamer
A newer GCC compiler. Sep 21, 2021 • 02:10 Development • ElmerPCFX
[Release] HyperFasher CLI – The developer support application Aug 29, 2021 • 10:10 Development • thunderstruck
Polygo Block restoration hack in the works Aug 20, 2021 • 21:02 Development • Robert Molander
VSU Sandbox Aug 08, 2021 • 04:19 Development • gdces1984
Link Behavior Jul 28, 2021 • 18:06 Development • dasi
Mandelbrot zoomer in 2k Jul 26, 2021 • 05:40 Development • Splain
VB link cable dimensions Jul 19, 2021 • 17:04 Development • Hedgetrimmer
Hamburgers En Route To Switzerland Jul 01, 2021 • 17:22 Development • KGRAMR
Load 10 more +20 +50 +100