Skip to content

Free games for graphing calculators: NumWorks, TI-Nspire CX, Casio fx-CG50 and soon TI-84 Plus CE. Balatro, Celeste, Hollow Knight, Minecraft and more.

Retro-Go: README, how to play, credits and pictures

Mason363c9fccd0d3a86
diff --git a/README.md b/README.md
index 67eeae81..4caac319 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,16 @@ These are too big to fit next to NumPlay, so each one is its own app. Install it
</tr>
</table>
+## Your own Game Boy and NES games
+
+<table>
+ <tr>
+ <td align="center" width="33%"><a href="games/retrogo/README.md"><img src="docs/media/thumb_retrogo.png" width="200" alt="Retro-Go"><br><b>Retro-Go</b></a><br><sub>Game Boy, Game Boy Color and NES games, with Retro-Go's menus and save slots</sub></td>
+ </tr>
+</table>
+
+Retro-Go plays the Game Boy, Game Boy Color and NES games you choose: games you own, or free ones like homebrew games. It isn't in NumPlay.nwa: you get it, with your games inside, from NumPlay's customizer website.
+
## How to install
You need your calculator, its USB cable, and a computer with **Google Chrome** or **Microsoft Edge**. It takes about 2 minutes.
@@ -176,6 +186,7 @@ Filmed on my own calculator, no emulator.
- [x] The Powder Toy (NumPowder)
- [x] Block Blast
- [x] Undertale: the whole Underground, from the Ruins to New Home and the neutral ending
+- [x] [Retro-Go](https://github.com/ducalex/retro-go) for Game Boy, Game Boy Color and NES: upload your own ROMs on the website and get a .nwa app that plays them
- [ ] The Binding of Isaac
- [ ] Plants vs. Zombies
- [ ] Doom
@@ -190,7 +201,6 @@ Filmed on my own calculator, no emulator.
- [ ] The Nether and the End in NumBlocks
- [ ] Full Minecraft 1.18.2 as a standalone app
- [ ] A customizer website: pick the games you want in your launcher, with Enlarged Extra Apps support to fit several big games, or big and small ones together
-- [ ] [Retro-Go](https://github.com/ducalex/retro-go) for Game Boy, NES and more: upload your own ROMs on the website and get a .nwa app that plays them
## Credits
@@ -212,6 +222,7 @@ NumPlay is a fan project, made out of love for these games and for the NumWorks
- **Buckshot Roulette** by Mike Klubnika inspired NumPlay's Buckshot Roulette, whose scenes are rendered from the game through the Open Buckshot Roulette project (1503Dev). Fonts: Fake Receipt by Ray Larabie and Dot Matrix by Dionaea.
- The **Doodle Champion Island Games** (2021) inspired Champion Island, which uses the doodle's own pictures, maps and texts from the [Google-Doodle-Champion-Island](https://github.com/potherca-blog/Google-Doodle-Champion-Island) archive by potherca-blog, and the **PixelMplus** font by Itou Hiroki ([license](LICENSES/PixelMplus.txt)).
- **[Portal Returns](https://www.cemetech.net/downloads/files/1313/x1313)** by MateoConLechuga for the TI-84 Plus CE, with sprites by CKH4 and Portal Prelude chambers ported by Unicorn from BuilderBoy's original.
+- **[Retro-Go](https://github.com/ducalex/retro-go)** by ducalex inspired NumPlay's Retro-Go, whose launcher, menus and frame skipping are written again for NumPlay with no code copied from it. Its emulators are **[gnuboy](https://github.com/rofl0r/gnuboy)** by Laguna and Gilgamesh (GNU GPL v2 or later) for the Game Boy and **nofrendo** by Matthew Conte (GNU LGPL v2, used under the GPL) for the NES. Its tests use Blargg's test ROMs, Matt Currie's dmg-acid2 and cgb-acid2 and kevtris's nestest. Not affiliated with them.
- The **Nunito** and **Rammetto One** fonts, under the SIL Open Font License ([LICENSES](LICENSES)).
- The **Fusion Pixel** font by TakWolf (with glyphs from **Ark Pixel**), under the SIL Open Font License ([license](LICENSES/OFL-1.1-Fusion-Pixel.txt)), for the Chinese letters.
- **[Upsilon](https://github.com/UpsilonNumworks/Upsilon)**, the custom software NumPlay-Upsilon.nwa runs on.
@@ -224,7 +235,7 @@ NumPlay is a fan project, made out of love for these games and for the NumWorks
NumPlay is licensed under the [GNU General Public License v3.0](LICENSE). Copyright (c) 2026 Mason Chen. Code and fonts from others keep their own licenses: the `UNLICENSE` files in the games' folders and the [LICENSES](LICENSES) folder. The names, artwork and music of the games NumPlay is inspired by belong to their makers and are not covered by it.
-<sub>Unofficial fan games, not affiliated with NumWorks, RobTop Games (Geometry Dash), Hipster Whale (Crossy Road), the makers of Drive Mad, LocalThunk or Playstack (Balatro), Mike Klubnika or Critical Reflex (Buckshot Roulette), Hungry Studio (Block Blast!), Mojang or Microsoft (Minecraft), Maddy Makes Games (Celeste), Team Cherry (Hollow Knight), Toby Fox (Undertale), Florian van Strien (The Final Earth 2), The Powder Toy's developers (The Powder Toy), MateoConLechuga (Portal Returns), Valve (Portal), .GEARS (Flappy Bird), Bandai Namco (Pac-Man), Hasbro (Connect Four), Google (Snake, Solitaire, Block Breaker, Chrome Dino, Doodle Champion Island Games), STUDIO4°C or Microsoft (Minesweeper). Tetris is a trademark of The Tetris Company, Chrome of Google LLC, Minecraft of Mojang Synergies AB, Pac-Man of Bandai Namco and Connect Four of Hasbro.</sub>
+<sub>Unofficial fan games, not affiliated with NumWorks, RobTop Games (Geometry Dash), Hipster Whale (Crossy Road), the makers of Drive Mad, LocalThunk or Playstack (Balatro), Mike Klubnika or Critical Reflex (Buckshot Roulette), Hungry Studio (Block Blast!), Mojang or Microsoft (Minecraft), Maddy Makes Games (Celeste), Team Cherry (Hollow Knight), Toby Fox (Undertale), Florian van Strien (The Final Earth 2), The Powder Toy's developers (The Powder Toy), MateoConLechuga (Portal Returns), Valve (Portal), .GEARS (Flappy Bird), Bandai Namco (Pac-Man), Hasbro (Connect Four), Google (Snake, Solitaire, Block Breaker, Chrome Dino, Doodle Champion Island Games), STUDIO4°C or Microsoft (Minesweeper), ducalex (Retro-Go), Nintendo (Game Boy, NES). Tetris is a trademark of The Tetris Company, Chrome of Google LLC, Minecraft of Mojang Synergies AB, Pac-Man of Bandai Namco, Connect Four of Hasbro, and Game Boy, Game Boy Color and NES of Nintendo.</sub>
## Gallery
@@ -274,4 +285,7 @@ NumPlay is licensed under the [GNU General Public License v3.0](LICENSE). Copyri
<td align="center"><img src="docs/media/gallery/championisland.gif" width="100%" alt="Champion Island: climbing, artistic swimming and the marathon"><br><a href="games/championisland/README.md"><b>Champion Island</b></a></td>
<td align="center"><img src="docs/media/gallery/undertale.gif" width="100%" alt="Undertale: Flowey's friendliness pellets, Toriel's tile puzzle and her fire"><br><a href="games/undertale/README.md"><b>Undertale</b></a></td>
</tr>
+ <tr>
+ <td align="center"><img src="docs/media/gallery/retrogo.gif" width="100%" alt="Retro-Go: from the Game Boy tab to the NES list, then Thwaite, a homebrew game, starts and fireworks stop the missiles"><br><a href="games/retrogo/README.md"><b>Retro-Go</b></a></td>
+ </tr>
</table>
diff --git a/docs/media/gallery/retrogo.gif b/docs/media/gallery/retrogo.gif
new file mode 100644
index 00000000..65518c2b
Binary files /dev/null and b/docs/media/gallery/retrogo.gif differ
diff --git a/docs/media/thumb_retrogo.png b/docs/media/thumb_retrogo.png
new file mode 100644
index 00000000..f9215432
Binary files /dev/null and b/docs/media/thumb_retrogo.png differ
diff --git a/docs/play.md b/docs/play.md
index fe008a94..628a3b76 100644
--- a/docs/play.md
+++ b/docs/play.md
@@ -468,3 +468,20 @@ Google's brick breaker: seven bricks across in blue, red, yellow and green, wall
11 backgrounds and 5 add-ons: a clock, a stopwatch, a timer, a counter and your own text (press **Alpha** for letters). Everything is kept for next time.
<br clear="right">
+
+## Retro-Go
+
+<img src="../games/retrogo/docs/game.png" width="320" align="right" alt="Retro-Go: Thwaite, an NES homebrew game">
+
+| Key | What it does |
+| --- | --- |
+| **Arrows** | Choose a system, then a game. In a game: the D-pad |
+| **OK** | Open it. In a game: **A** |
+| **Back** | Back to the systems. In a game: **B** |
+| **shift** / **EXE** | In a game: **Select** / **Start** |
+| **Backspace** | Retro-Go's menu: save, load, reset, options |
+| **Home** | Save and quit |
+
+Game Boy, Game Boy Color and NES games you pick on NumPlay's customizer website. Open a game for New game, or Resume game from one of its 4 save slots. In a game, Backspace opens Retro-Go's menu: Save & Continue, Save & Quit, Load game, Reset and Options, where the picture can be 1x, Fit or Full screen. The cartridges' own saves are kept as well.
+
+<br clear="right">
diff --git a/games/retrogo/Makefile b/games/retrogo/Makefile
index afc5055e..09c86b32 100644
--- a/games/retrogo/Makefile
+++ b/games/retrogo/Makefile
@@ -1,6 +1,7 @@
# Retro-Go: Game Boy, Game Boy Color and NES games on the calculator.
# make build output/retrogo.nwa (RetroGo.nwa), its ROM table from ROMS (none: empty)
-# make ROMS="a.gb b.nes" the same with those games in it, to try them
+# make ROMS="a.gb b.nes" the same with those games in it, to try them (or ROMS_LIST=file:
+# one a line, for names with spaces)
# make check link the app like the calculator does (output/retrogo.bin)
# make test the emulators and the ROM table on this computer
#
@@ -68,7 +69,7 @@ $(BUILD_DIR)/xfont.o: ../../launcher/src/xfont.c ../../launcher/src/np_xfont.h $
# the file as it is when it wouldn't change, so nothing is linked again for nothing.
$(BUILD_DIR)/roms.o: FORCE
@mkdir -p $(BUILD_DIR)
- $(Q) $(PY) ../../tools/romtable.py -o $@ $(ROMS)
+ $(Q) $(PY) ../../tools/romtable.py -o $@ $(ROMS) $(if $(ROMS_LIST),--list $(ROMS_LIST))
$(BUILD_DIR)/retrogo-full.nwa: $(CORE_O) $(APP_O) $(BUILD_DIR)/gfx.o $(BUILD_DIR)/font_data.o $(BUILD_DIR)/xfont.o \
$(BUILD_DIR)/icon.o $(BUILD_DIR)/roms.o src/roms.ld
diff --git a/games/retrogo/README.md b/games/retrogo/README.md
new file mode 100644
index 00000000..ffb22fe8
--- /dev/null
+++ b/games/retrogo/README.md
@@ -0,0 +1,61 @@
+# Retro-Go
+
+Play your own Game Boy, Game Boy Color and NES games on the NumWorks calculator. Retro-Go is the launcher and emulators of handhelds like the ODROID-GO, whose screen is the calculator's size; this is its look and its menus, made for the keypad.
+
+<img src="docs/shot.png" width="320" alt="Retro-Go's list of NES games, with Thwaite chosen">
+
+You pick the games on NumPlay's customizer website: it puts them inside your NumPlay (or inside Retro-Go on its own), and they stay in the calculator's memory for apps. Only games you own or that are free to share, like the homebrew games in the pictures here.
+
+- **Retro-Go's launcher:** a tab for each system with its own colours, the game list, and for each game Resume game, New game, Delete save and Properties.
+- **Game Boy and Game Boy Color** with gnuboy, the emulator Retro-Go started from: the cartridges with MBC1, MBC2, MBC3 (with its clock), MBC5, HuC1 and HuC3 bank controllers, up to 32 KB of cartridge RAM.
+- **NES** with nofrendo, Retro-Go's NES emulator at its start: 34 mappers, among them NROM, MMC1, UNROM, CNROM, MMC3, MMC5, AxROM, MMC2, Namco 163 and the Konami VRC chips.
+- **Full speed** on every calculator: as Retro-Go does, a frame is drawn, then at least one is skipped, more when the calculator can't keep up, so the game always runs at its own speed.
+- **Retro-Go's menu** in a game: Save & Continue, Save & Quit, Load game, Reset, Options, Controls, About and Quit.
+- **4 save slots** for each game, and the cartridges' own battery saves, kept a few seconds after the game writes them. Home saves and quits.
+- **Options:** the picture at 1x, Fit or Full screen, the speed from 0.5x to 2.5x, the Game Boy's DMG, Pocket, Light, GBC or SGB colours, the NES's Nofrendo or NTSC colours, its overscan, side cropping and sprite limit, the Game Boy's clock.
+
+<table>
+ <tr>
+ <td align="center"><img src="docs/tabs.png" width="320" alt="Retro-Go's NES tab: a red background with a controller"><br><sub>The NES tab</sub></td>
+ <td align="center"><img src="docs/game.png" width="320" alt="Thwaite, an NES homebrew game, in Fit mode"><br><sub>Thwaite, an NES homebrew game, in Fit</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><img src="docs/menu.png" width="320" alt="Retro-Go's menu over the game"><br><sub>Retro-Go's menu</sub></td>
+ <td align="center"><img src="docs/options.png" width="320" alt="Retro-Go's options: scaling, speed and the emulator's options"><br><sub>Options</sub></td>
+ </tr>
+</table>
+
+## Controls
+
+| Key | In the launcher | In a game |
+| --- | --- | --- |
+| Arrows | Choose a system, then a game | The D-pad |
+| OK | Open the system, then the game | A |
+| Back | Back to the systems | B |
+| shift | | Select |
+| EXE | Like OK | Start |
+| Backspace | Options, Controls, About | Retro-Go's menu |
+| Home | Quit | Save and quit |
+
+In 1x on the Game Boy, the keys are written on the side of the screen. The first time you play, Retro-Go shows them, and Controls in its menu shows them again.
+
+## Good to know
+
+- No sound: the calculator has no speaker.
+- The calculator has about 42 KB for every app's saves. A Game Boy or NES state takes 2 to 10 KB, a Game Boy Color one up to 30 KB, so keep the slots you need and delete the others in the launcher (Delete save).
+- The calculator has no clock for apps: a Game Boy game's clock runs while you play, and you can set it in Options, RTC config.
+- Cartridges with more than 32 KB of RAM (a few Game Boy Color games) and NES mappers nofrendo doesn't have say so instead of starting.
+- Master System and Game Gear, which Retro-Go also plays, are not here yet: the emulator Retro-Go uses for them has a Z80 core that may not be shared freely.
+
+## Credits
+
+[Retro-Go](https://github.com/ducalex/retro-go) is **ducalex**'s. Its code is under the GPL version 2 only, which can't be mixed with NumPlay's GPL version 3, so none of it is copied here: the launcher, the menus, the options and the frame skipping are written again from how Retro-Go looks and works, and its pictures are drawn again in its style. Not affiliated with Retro-Go.
+
+- **[gnuboy](https://github.com/rofl0r/gnuboy)** by Laguna and Gilgamesh and gnuboy's contributors (GPL-2.0-or-later, [COPYING](src/gb/COPYING)), from rofl0r's tree, emulates the Game Boy. Its picture is drawn by new code here: gnuboy's keeps 256 KB of decoded tiles, more than the calculator has.
+- **nofrendo** by Matthew Conte and nofrendo's contributors (version 2 of the GNU Library GPL, [COPYING.LGPL](src/nes/COPYING.LGPL), used under the GPL as its section 3 allows) emulates the NES. Its 2.0 release is the one used here.
+- The tests run [Blargg's test ROMs](https://github.com/retrio/gb-test-roms), [dmg-acid2 and cgb-acid2](https://github.com/mattcurrie) by Matt Currie and [nestest](https://github.com/christopherpow/nes-test-roms) by kevtris, which aren't in NumPlay. The pictures show [Thwaite](https://github.com/pinobatch/thwaite-nes), [Concentration Room](https://github.com/pinobatch/croom-nes), [Libbet and the Magic Floor](https://github.com/pinobatch/libbet) and the [240p Test Suite](https://github.com/pinobatch/240p-test-mini) by Damian Yerrick and others, and [µCity](https://github.com/AntonioND/ucity) by Antonio Niño Díaz, all free homebrew games.
+- Game Boy, Game Boy Color and NES are trademarks of Nintendo. Not affiliated with Nintendo.
+
+Made by Mason Chen as part of NumPlay. It comes from the customizer website with your games in it, inside [NumPlay](https://github.com/Mason363/NumPlay) or on its own.
+
+Build: `make ROMS="game.gb game.nes"` makes `output/retrogo.nwa` with those games in it, and `make test` checks the emulators and the saves on your computer (see `tests/`).
diff --git a/games/retrogo/docs/game.png b/games/retrogo/docs/game.png
new file mode 100644
index 00000000..cc23f1cb
Binary files /dev/null and b/games/retrogo/docs/game.png differ
diff --git a/games/retrogo/docs/menu.png b/games/retrogo/docs/menu.png
new file mode 100644
index 00000000..972ad073
Binary files /dev/null and b/games/retrogo/docs/menu.png differ
diff --git a/games/retrogo/docs/options.png b/games/retrogo/docs/options.png
new file mode 100644
index 00000000..331b374a
Binary files /dev/null and b/games/retrogo/docs/options.png differ
diff --git a/games/retrogo/docs/shot.png b/games/retrogo/docs/shot.png
index d81ec2ba..a0cbbaf2 100644
Binary files a/games/retrogo/docs/shot.png and b/games/retrogo/docs/shot.png differ
diff --git a/games/retrogo/docs/tabs.png b/games/retrogo/docs/tabs.png
new file mode 100644
index 00000000..c65c5e03
Binary files /dev/null and b/games/retrogo/docs/tabs.png differ
diff --git a/games/retrogo/docs/welcome.png b/games/retrogo/docs/welcome.png
new file mode 100644
index 00000000..8c35a8c3
Binary files /dev/null and b/games/retrogo/docs/welcome.png differ
diff --git a/tools/romtable.py b/tools/romtable.py
index cd05f6e5..89c267ad 100644
--- a/tools/romtable.py
+++ b/tools/romtable.py
@@ -20,6 +20,7 @@ All numbers are little-endian. To be the same byte for byte as the website's for
usage:
romtable.py -o roms.o [ROM...] an ARM object for the calculator (the default)
+ romtable.py -o roms.o --list FILE the ROMs named in FILE, one a line (names with spaces)
romtable.py --c roms.c [ROM...] the same table as C, for the simulator and tests
romtable.py --bin roms.bin [ROM...] just the table's bytes"""
import argparse
@@ -102,10 +103,13 @@ def main():
ap.add_argument("-o", dest="obj", help="ARM object to write")
ap.add_argument("--c", dest="csrc", help="C source to write")
ap.add_argument("--bin", dest="bin", help="raw table to write")
+ ap.add_argument("--list", help="a file naming more ROMs, one a line (for names with spaces)")
ap.add_argument("roms", nargs="*")
a = ap.parse_args()
if not (a.obj or a.csrc or a.bin):
ap.error("say where: -o, --c or --bin")
+ if a.list:
+ a.roms += [line.strip() for line in open(a.list, encoding="utf-8") if line.strip()]
blob = table(a.roms)
for path, data in ((a.obj, lambda: elf_object(blob)), (a.csrc, lambda: c_source(blob).encode()),
(a.bin, lambda: blob)):