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.
C calculatorcalculator-gamescasiochesscrossy-roaddrive-madfx-cg50gamesgeometry-dashgraphing-calculatorndlessnumworksnumworks-appsnumworks-calculatornumworks-gamenumworks-gamestetristi-84-plus-ceti-nspire
Super Mario 64 moves to a repository of its own
Mason3631a715bcdea01
diff --git a/.github/workflows/build.yml b/.github/workflows/build.ymlindex e8935673..854a28f9 100644--- a/.github/workflows/build.yml+++ b/.github/workflows/build.yml@@ -68,7 +68,6 @@ jobs:make -C games/sudoku host testmake -C games/uttt host testmake -C games/sokoban host test- make -C games/sm64 host test- uses: actions/upload-artifact@v4with:diff --git a/Makefile b/Makefileindex 12f582a6..f4ac69ac 100644--- a/Makefile+++ b/Makefile@@ -24,7 +24,7 @@ RAM_LIMIT = 148928# custom builds of Epsilon 25.2's source give apps less: 133652 bytes; every game fits there too, in NumPlay and on# its own (their big buffers are on the stack, 32 KB apart from that RAM, or in the RAM the software has left)CUSTOM_RAM = 133652-BIG_APPS = Celeste HollowKnight Undertale ChampionIsland FinalEarth2 NumPowder NumBlocks NumDrive SubwaySurfers FiveNightsAtFreddys Doom BindingOfIsaac HillClimbRacing PlantsVsZombies SonicTheHedgehog CookieClicker LevelDevil SuperMario64+BIG_APPS = Celeste HollowKnight Undertale ChampionIsland FinalEarth2 NumPowder NumBlocks NumDrive SubwaySurfers FiveNightsAtFreddys Doom BindingOfIsaac HillClimbRacing PlantsVsZombies SonicTheHedgehog CookieClicker LevelDevil# the calculator's space for installed apps (0x90200000 to 0x903F0000 in its flash)APP_SPACE = 2031616# Upsilon, the N0110 and N0115's custom software, gives .nwa apps less RAM: NumPlay-Upsilon.nwa has@@ -216,7 +216,6 @@ APP_pvz = games/pvz/output/pvz.nwa:PlantsVsZombies.nwaAPP_sonic = games/sonic/output/sonic.nwa:SonicTheHedgehog.nwaAPP_cookieclicker = games/cookieclicker/output/cookieclicker.nwa:CookieClicker.nwaAPP_leveldevil = games/leveldevil/output/leveldevil.nwa:LevelDevil.nwa-APP_sm64 = games/sm64/output/sm64.nwa:SuperMario64.nwaapps: | $(B)$(MAKE) -C games/numdash build NWLINK="node node_modules/nwlink/bin/nwlink"@@ -242,7 +241,6 @@ apps: | $(B)$(MAKE) -C games/sonic build NWLINK="$(NWLINK)"$(MAKE) -C games/cookieclicker build NWLINK="$(NWLINK)"$(MAKE) -C games/leveldevil build NWLINK="$(NWLINK)"- $(MAKE) -C games/sm64 build NWLINK="$(NWLINK)"cd games/tetris/tetris && NWLINK="$(NWLINK)" $(CARGO) build --release --quietcp $(word 1,$(subst :, ,$(APP_numdash))) $(B)/apps/$(word 2,$(subst :, ,$(APP_numdash)))cp $(word 1,$(subst :, ,$(APP_crossyroad))) $(B)/apps/$(word 2,$(subst :, ,$(APP_crossyroad)))@@ -268,7 +266,6 @@ apps: | $(B)cp $(word 1,$(subst :, ,$(APP_sonic))) $(B)/apps/$(word 2,$(subst :, ,$(APP_sonic)))cp $(word 1,$(subst :, ,$(APP_cookieclicker))) $(B)/apps/$(word 2,$(subst :, ,$(APP_cookieclicker)))cp $(word 1,$(subst :, ,$(APP_leveldevil))) $(B)/apps/$(word 2,$(subst :, ,$(APP_leveldevil)))- cp $(word 1,$(subst :, ,$(APP_sm64))) $(B)/apps/$(word 2,$(subst :, ,$(APP_sm64)))arm-none-eabi-strip --strip-unneeded $(B)/apps/Tetris.nwaSTD_APPS = $(foreach g,$(STD_GAMES),$(B)/apps/$(NWA_$(g)))@@ -334,6 +331,5 @@ clean:-$(MAKE) -C games/sonic clean-$(MAKE) -C games/cookieclicker clean-$(MAKE) -C games/leveldevil clean- -$(MAKE) -C games/sm64 clean-cd games/tetris/tetris && $(CARGO) clean-$(foreach g,$(STD_GAMES),$(MAKE) -C games/$(g) clean;)diff --git a/README.md b/README.mdindex e77db761..597b5548 100644--- a/README.md+++ b/README.md@@ -6,7 +6,7 @@<p align="center"><b>24 free games for your NumWorks calculator, in one app.</b><br>- Plus 16 big games that install on their own. For the N0110, N0115 and N0120, in English, French and Chinese.+ Plus 15 big games that install on their own. For the N0110, N0115 and N0120, in English, French and Chinese.</p><p align="center">@@ -106,7 +106,7 @@ These are too big to fit next to NumPlay, so each one is its own app. Install it<td align="center"><a href="games/leveldevil/README.md"><img src="docs/media/thumb_leveldevil.png" width="200" alt="Level Devil"><br><b>Level Devil</b></a><br><sub>Unept's troll platformer: the game's 80 rooms, with their own traps</sub><br><a href="https://github.com/Mason363/NumPlay/releases/latest/download/LevelDevil.nwa">Download</a></td></tr><tr>- <td align="center"><a href="games/sm64/README.md"><img src="docs/media/thumb_sm64.png" width="200" alt="Super Mario 64"><br><b>Super Mario 64</b></a><br><sub>Peach's castle and its first five courses, in 3D</sub><br><a href="https://github.com/Mason363/NumPlay/releases/latest/download/SuperMario64.nwa">Download</a></td>+ <td align="center"><a href="https://github.com/Mason363/NumWorks-Super-Mario-64"><b>Super Mario 64</b></a><br><sub>In a repository of its own: NumWorks-Super-Mario-64</sub></td><td align="center"><a href="#roadmap"><b>More on the way</b></a><br><sub>Minecraft 1.18.2, Retro-Go and more: see the roadmap</sub></td></tr></table>@@ -228,7 +228,7 @@ Read **[Make your own NumWorks game](docs/make-a-game.md)** to go from there, an- [x] Sokoban- [x] Sudoku- [x] Ultimate Tic-Tac-Toe-- [x] Super Mario 64: Peach's castle and its first five courses (the rest of the castle, its courses and Bowser to come)+- [x] Super Mario 64, in a repository of its own: [NumWorks-Super-Mario-64](https://github.com/Mason363/NumWorks-Super-Mario-64)- [x] The Nether and the End in NumBlocks: portals, fortresses, strongholds and the Ender Dragon, in NumBlocks.nwa- [ ] 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@@ -264,7 +264,6 @@ NumPlay is a fan project, made out of love for these games and for the NumWorks- **Sokoban** by Hiroyuki Imabayashi (Thinking Rabbit, 1982) inspired NumPlay's Sokoban, written in C for NumPlay with no code or art from any Sokoban. Its levels are **Microban** by David W. Skinner (2000), used with credit to him.- **Sudoku**, the number place puzzle (Dell Magazines, 1979; named by Nikoli), is written in C for NumPlay: its puzzles are made on the calculator, and its look and controls follow the phone apps.- **Ultimate tic-tac-toe** is a folk game, made widely known by [Ben Orlin's 2013 article](https://mathwithbaddrawings.com/2013/06/16/ultimate-tic-tac-toe/); NumPlay's is written in C for it.-- **Super Mario 64** by Nintendo inspired NumPlay's Super Mario 64, which runs the game's own code and data from the [n64decomp/sm64](https://github.com/n64decomp/sm64) decompilation (Nintendo's game, not covered by NumPlay's GPL), with pictures painted after the game's. Not affiliated with Nintendo.- **[The Powder Toy](https://powdertoy.co.uk)** inspired NumPowder, which ports its materials' behaviour, its font and its icons from [its source code](https://github.com/The-Powder-Toy/The-Powder-Toy) (GNU GPL v3.0), by Stanislaw K Skowronek, Simon Robertshaw and its contributors. Not affiliated with them.- **[The Final Earth 2](https://store.steampowered.com/app/1180130/The_Final_Earth_2/)** by [Florian van Strien](https://florianvanstrien.nl) inspired NumPlay's The Final Earth 2, which uses the game's own pictures, fonts and texts, with additional sprites by LukXD99. Not affiliated with him.@@ -281,9 +280,9 @@ NumPlay is a fan project, made out of love for these games and for the NumWorks## License-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, and neither is Super Mario 64's decompiled code in `games/sm64/decomp`, which is Nintendo's, from the n64decomp/sm64 project.+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), id Software (Doom), Edmund McMillen, Florian Himsl or Nicalis (The Binding of Isaac), PopCap Games or Electronic Arts (Plants vs. Zombies), Scott Cawthon (Five Nights at Freddy's), SEGA (Sonic the Hedgehog), SYBO or Kiloo (Subway Surfers), Fingersoft (Hill Climb Racing), Unept (Level Devil), Atari (Pong), Disney (Tron), Orteil or DashNet (Cookie Clicker), Taito or Midway (Space Invaders), Thinking Rabbit or Falcon (Sokoban), Nintendo (Super Mario 64), 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, Connect Four of Hasbro, DOOM of ZeniMax Media, Sonic the Hedgehog of SEGA and Space Invaders of Taito.</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), id Software (Doom), Edmund McMillen, Florian Himsl or Nicalis (The Binding of Isaac), PopCap Games or Electronic Arts (Plants vs. Zombies), Scott Cawthon (Five Nights at Freddy's), SEGA (Sonic the Hedgehog), SYBO or Kiloo (Subway Surfers), Fingersoft (Hill Climb Racing), Unept (Level Devil), Atari (Pong), Disney (Tron), Orteil or DashNet (Cookie Clicker), Taito or Midway (Space Invaders), Thinking Rabbit or Falcon (Sokoban), 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, Connect Four of Hasbro, DOOM of ZeniMax Media, Sonic the Hedgehog of SEGA and Space Invaders of Taito.</sub>## Gallery@@ -356,6 +355,5 @@ NumPlay is licensed under the [GNU General Public License v3.0](LICENSE). Copyri<tr><td align="center"><img src="docs/media/gallery/uttt.gif" alt="Ultimate Tic-Tac-Toe: a game against the computer, which wins the middle board"><br><a href="games/uttt/README.md"><b>Ultimate Tic-Tac-Toe</b></a></td><td align="center"><img src="docs/media/gallery/sokoban.gif" alt="Sokoban: Microban's ninth level, pushed through to its goals"><br><a href="games/sokoban/README.md"><b>Sokoban</b></a></td>- <td align="center"><img src="docs/media/gallery/sm64.gif" alt="Super Mario 64: Mario runs up to Peach's castle, then gets a star in Bob-omb Battlefield"><br><a href="games/sm64/README.md"><b>Super Mario 64</b></a></td></tr></table>diff --git a/_config.yml b/_config.ymlindex 5da19ef6..d21c35db 100644--- a/_config.yml+++ b/_config.yml@@ -1,5 +1,5 @@title: NumPlay-description: "24 games for the NumWorks calculator in one app: NumDash, Crossy Road, NumBlocks, NumDrive, Balatro, Buckshot Roulette, Block Blast, Portal Returns, Tetris, Chrome Dino, Chess, Space Invaders, Sudoku and more. And Super Mario 64, Doom, Sonic, Plants vs. Zombies, Cookie Clicker and more on their own. Free and open source, with a kit to make your own NumWorks games in C."+description: "24 games for the NumWorks calculator in one app: NumDash, Crossy Road, NumBlocks, NumDrive, Balatro, Buckshot Roulette, Block Blast, Portal Returns, Tetris, Chrome Dino, Chess, Space Invaders, Sudoku and more. And Doom, Sonic, Plants vs. Zombies, Cookie Clicker and more on their own. Free and open source, with a kit to make your own NumWorks games in C."url: https://mason363.github.iobaseurl: /NumPlaytheme: jekyll-theme-caymandiff --git a/docs/make-a-game.md b/docs/make-a-game.mdindex a31a2e95..45790a64 100644--- a/docs/make-a-game.md+++ b/docs/make-a-game.md@@ -68,12 +68,12 @@ Plug the calculator in, open [my.numworks.com/apps](https://my.numworks.com/apps| **Saves that survive a reinstall**: a copy kept in a Python script, which the NumWorks website keeps | `games/celeste/src/save.c` (`save_copy`) | Celeste, Hollow Knight, Undertale, the big games || **Safety**: Home handled cleanly, the slower models and Upsilon recognised, keys let go before quitting | `games/common/epsilon_app.h` | every game || **Compression**: LZ for pictures, DEFLATE for levels | `games/common/np_lz.h`, `launcher/src/inflate.c` | Chrome Dino, Sokoban, NumDash |-| **3D**: perspective-correct textured triangles drawn a few rows at a time, with fog and light | `games/sm64/src/render.c` | Super Mario 64 |+| **3D**: perspective-correct textured triangles drawn a few rows at a time, with fog and light | [`src/render.c`](https://github.com/Mason363/NumWorks-Super-Mario-64/blob/main/src/render.c) in NumWorks-Super-Mario-64 | Super Mario 64 || **3D**: shaded, textured models and scenery | `games/subway/src/r3d.c` | Subway Surfers || **Voxels**: a Minecraft-style world renderer | `games/numblocks/src/render.c` | NumBlocks || **Physics**: rigid bodies, joints, contacts and raycasts | `games/numdrive/src` | NumDrive || **Vehicle physics** on hills | `games/hillclimb/src` | Hill Climb Racing |-| **A port of a C game engine** running on the calculator: Doom, Super Mario 64's decompilation, Sonic | `games/doom`, `games/sm64`, `games/sonic` | |+| **A port of a C game engine** running on the calculator: Doom, Sonic, and Super Mario 64's decompilation ([its own repository](https://github.com/Mason363/NumWorks-Super-Mario-64)) | `games/doom`, `games/sonic` | |And the tools, all in `tools/`:diff --git a/docs/play.md b/docs/play.mdindex 51c36f67..825f0c09 100644--- a/docs/play.md+++ b/docs/play.md@@ -422,29 +422,6 @@ Drive as far as you can before the fuel runs out or Bill lands on his head. Pick<br clear="right">-## Super Mario 64--<img src="media/sm64.gif" width="320" align="right" alt="Super Mario 64: Mario runs up to Peach's castle, then gets a star in Bob-omb Battlefield">--Super Mario 64 comes as its own app, `SuperMario64.nwa`: it is too big to share the calculator with NumPlay.--| Key | What it does |-| --- | --- |-| **Arrows** | Move (the control stick) |-| **alpha** (held) | Walk and tiptoe |-| **OK** or **EXE** | A: jump, swim, read and talk |-| **Back** | B: punch, kick, dive, pick up and throw |-| **shift** | Z: crouch, slide, ground pound |-| **4** / **6** | Turn the camera |-| **8** / **2** | Camera closer / further |-| **0** | R: Mario's camera or Lakitu's |-| **⌫** | Start: pause |-| **Home** | Quit |--Press Start or OK on the title: a new game shows these keys, then Peach's letter (Shift shows them again from the title). Jump into a painting to enter its course and choose a star to go for: Bob-omb Battlefield, Whomp's Fortress, Jolly Roger Bay, Cool, Cool Mountain and, from the courtyard, Big Boo's Haunt. In the pause menu, Shift quits the game (it asks first). Collecting a star saves it; your stars are also copied into `sm64_saves.py`, so installing the app again doesn't erase them.--<br clear="right">-## Cookie Clicker<img src="media/cookieclicker.gif" width="320" align="right" alt="Cookie Clicker: a golden cookie caught for a Frenzy, upgrades bought, the Grimoire, then an ascension">diff --git a/tests/test_games.py b/tests/test_games.pyindex 1d5b8848..3ce6e893 100644--- a/tests/test_games.py+++ b/tests/test_games.py@@ -201,10 +201,6 @@ GAMES = {"cookieclicker": ("CookieClicker.nwa", "cookieclicker.sav",presses((2500, "ok"), (3500, "ok"), (4000, "ok"), (4500, "ok")), 6500,presses((3000, "ok"), (3600, "ok")), 5500),- # past the title and the keys (a new game): Peach's letter, Lakitu's flight to the castle, the warp pipe; Home.- # Next time the title, the keys again from Shift, then the game (quitting with On/Off)- "sm64": ("SuperMario64.nwa", "sm64.sav", presses((2500, "ok"), (4000, "ok"), (14000, "ok"), (17000, "ok")), 22000,- presses((2500, "shift"), (4000, "ok"), (5000, "ok")), 9000),# a level, its message, then play; then back to the level select"portal": ("PortalReturns.nwa", "portal.sav",presses((1500, "ok"), (2500, "ok"), (3500, "ok")) + every(4000, 7000, 400, "right", 300), 8000,@@ -236,8 +232,7 @@ COPIES = {"championisland": "champion_saves.py", "numblocks": "numblocks_saves.p"numpowder": "numpowder_saves.py", "undertale": "undertale_saves.py", "subway": "subway_saves.py","fnaf": "fnaf_saves.py", "doom": "doom_saves.py", "isaac": "isaac_saves.py","hillclimb": "hillclimb_saves.py", "pvz": "pvz_saves.py", "sonic": "sonic_saves.py",- "cookieclicker": "cookieclicker_saves.py", "leveldevil": "leveldevil_saves.py",- "sm64": "sm64_saves.py"}+ "cookieclicker": "cookieclicker_saves.py", "leveldevil": "leveldevil_saves.py"}CHECKS = {# the island remembers where Lucky was; after the reinstall, from the copy"championisland": (lambda v: v[:3] == b"CI1" and b"PLAYER_LOC" in v,) * 2,@@ -270,9 +265,6 @@ CHECKS = {# copy, it goes on"sonic": (lambda v: v[:4] == b"S1SV" and v[6] == 1 and v[7] == 0 and struct.unpack_from("<I", v, 28)[0] > 0,lambda v: v[:4] == b"S1SV" and v[6] == 1 and struct.unpack_from("<I", v, 28)[0] > 600),- # the save chip (the N64's 512-byte EEPROM): its menu data's two copies signed ("HI", little-endian); after the- # reinstall, from the copy, kept- "sm64": (lambda v: len(v) == 512 and v[476:478] == b"IH" and v[508:510] == b"IH",) * 2,# a simulation saved ("NPWD"); after the reinstall, from the copy, it goes on and is saved again"numpowder": (lambda v: v[:4] == b"NPWD",) * 2,# a run banked ("HCR1", runs at 212) with a best on the Countryside (at 48); after the reinstall, from the copy,diff --git a/tools/release.py b/tools/release.pyindex 367a67d8..e1c01922 100644--- a/tools/release.py+++ b/tools/release.py@@ -47,9 +47,6 @@ ALONE = {"big to share the calculator with NumPlay: install it on its own"),"isaac": ("The Binding of Isaac", "a whole run, from the Basement past Mom and her heart to Sheol and the Cathedral. ""Too big to share the calculator with NumPlay: install it on its own"),- "sm64": ("Super Mario 64", "Peach's castle, its grounds and courtyard, and the first five courses with their "- "stars: Bob-omb Battlefield, Whomp's Fortress, Jolly Roger Bay, Cool, Cool Mountain and Big Boo's Haunt, in "- "3D. Too big to share the calculator with NumPlay: install it on its own"),"pvz": ("Plants vs. Zombies", "the whole Adventure, from the front lawn to the roof and Dr. Zomboss: 50 levels, 40 ""plants, 24 zombies, Crazy Dave, his shop and the Almanac. Too big to share the calculator with NumPlay: ""install it on its own"),