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
Hollow Knight: README, how to play, its own app in the build and the release, emulator save test
Mason Chen78b3d5404a52
diff --git a/Makefile b/Makefileindex c1972119..79abb945 100644--- a/Makefile+++ b/Makefile@@ -145,6 +145,7 @@ APP_numvisuals = games/numvisuals/output/numvisuals.nwa:NumVisuals.nwa# too big to share the calculator's app space with NumPlay: only on their ownAPP_celeste = games/celeste/output/celeste.nwa:Celeste.nwaAPP_championisland = games/championisland/output/championisland.nwa:ChampionIsland.nwa+APP_hollowknight = games/hollowknight/output/hollowknight.nwa:HollowKnight.nwaapps: | $(B)$(MAKE) -C games/numdash build NWLINK="node node_modules/nwlink/bin/nwlink"@@ -157,6 +158,7 @@ apps: | $(B)$(MAKE) -C games/numvisuals build NWLINK="$(NWLINK)"$(MAKE) -C games/celeste build NWLINK="$(NWLINK)"$(MAKE) -C games/championisland build NWLINK="$(NWLINK)"+ $(MAKE) -C games/hollowknight 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)))@@ -169,6 +171,7 @@ apps: | $(B)cp $(word 1,$(subst :, ,$(APP_numvisuals))) $(B)/apps/$(word 2,$(subst :, ,$(APP_numvisuals)))cp $(word 1,$(subst :, ,$(APP_celeste))) $(B)/apps/$(word 2,$(subst :, ,$(APP_celeste)))cp $(word 1,$(subst :, ,$(APP_championisland))) $(B)/apps/$(word 2,$(subst :, ,$(APP_championisland)))+ cp $(word 1,$(subst :, ,$(APP_hollowknight))) $(B)/apps/$(word 2,$(subst :, ,$(APP_hollowknight)))arm-none-eabi-strip --strip-unneeded $(B)/apps/Tetris.nwaSTD_APPS = $(foreach g,$(STD_GAMES),$(B)/apps/$(NWA_$(g)))@@ -222,5 +225,6 @@ clean:-$(MAKE) -C games/chess clean-$(MAKE) -C games/numvisuals clean-$(MAKE) -C games/championisland clean+ -$(MAKE) -C games/hollowknight clean-cd games/tetris/tetris && $(CARGO) clean-$(foreach g,$(STD_GAMES),$(MAKE) -C games/$(g) clean;)diff --git a/README.md b/README.mdindex 3c52127f..24813535 100644--- a/README.md+++ b/README.md@@ -6,7 +6,7 @@<p align="center"><b>17 free games for your NumWorks calculator, in one app.</b><br>- Plus <b>Celeste</b> and <b>Champion Island</b>, two big games that come as apps of their own.+ Plus <b>Hollow Knight</b>, <b>Celeste</b> and <b>Champion Island</b>, three big games that come as apps of their own.</p><p align="center">@@ -28,7 +28,7 @@</p><p align="center">- <b>New: <a href="#new-numblocks">NumBlocks</a></b>, a world like Minecraft 1.8. <b>And <a href="#new-celeste">Celeste</a></b>, the whole climb up Celeste Mountain.+ <b>New: <a href="#new-hollow-knight">Hollow Knight</a></b>, from King's Pass to Hornet in Greenpath. <b>And <a href="#new-numblocks">NumBlocks</a></b>, a world like Minecraft 1.8.</p><p align="center">@@ -64,6 +64,29 @@ Mine, craft and survive in a world like Minecraft 1.8, right on your calculator.+## New: Hollow Knight++<p align="center">+ <img src="docs/media/hollowknight.gif" width="640" alt="Hollow Knight: the Knight in King's Pass, against the False Knight and Hornet">+</p>++Explore Hallownest as the Knight, right on your calculator.++- **The start of the journey:** King's Pass, Dirtmouth, the Forgotten Crossroads and Greenpath, up to Hornet.+- **The Knight moves like in the game:** the same jumps, nail slashes, pogos, dash, focus and Vengeful Spirit.+- **Its bosses and people:** the False Knight, Gruz Mother and Hornet; Elderbug, Sly, Iselda, Cornifer and more.+- **Everything to find:** geo, charms, mask shards, vessel fragments, grubs, the map and the stag stations.++<p align="center">+ <a href="https://github.com/Mason363/NumPlay/releases/latest/download/HollowKnight.nwa"><img src="https://img.shields.io/badge/Download-HollowKnight.nwa-4A5A7A?style=for-the-badge" alt="Download HollowKnight.nwa"></a>+</p>++<p align="center">+ It fills the calculator's app space, so it comes on its own. <a href="games/hollowknight/README.md"><b>More about Hollow Knight</b></a> · <a href="docs/play.md#hollow-knight"><b>How to play</b></a>+</p>+++## New: Celeste<p align="center">@@ -150,6 +173,10 @@ Click a file to download it. Not sure which one? Take the first.<td width="120" align="center"><img src="docs/media/thumb_celeste.png" width="112" alt="Celeste"></td><td><a href="https://github.com/Mason363/NumPlay/releases/latest/download/Celeste.nwa">Celeste.nwa</a><br>Celeste: the whole climb up Celeste Mountain. It fills the calculator's app space, so it comes on its own, not inside NumPlay (<a href="games/celeste/README.md">more</a>)</td></tr>+ <tr>+ <td width="120" align="center"><img src="docs/media/thumb_hollowknight.png" width="112" alt="Hollow Knight"></td>+ <td><a href="https://github.com/Mason363/NumPlay/releases/latest/download/HollowKnight.nwa">HollowKnight.nwa</a><br>Hollow Knight: from King's Pass to Hornet in Greenpath. It fills the calculator's app space, so it comes on its own, not inside NumPlay (<a href="games/hollowknight/README.md">more</a>)</td>+ </tr><tr><td width="120" align="center"><img src="docs/media/thumb_numdrive.png" width="112" alt="NumDrive"></td><td><a href="https://github.com/Mason363/NumPlay/releases/latest/download/NumDrive.nwa">NumDrive.nwa</a><br>Only NumDrive: drive, flip, finish</td>@@ -251,6 +278,10 @@ You need your calculator, its USB cable, and a computer with **Google Chrome** o<td><img src="docs/media/celeste.gif" alt="Celeste: Madeline dashing through the Forsaken City, climbing Golden Ridge and the Summit"></td><td><img src="games/celeste/docs/reflection.png" width="100%" alt="Celeste: Badeline fights back in Reflection"></td></tr>+ <tr>+ <td><img src="docs/media/hollowknight.gif" alt="Hollow Knight: the Knight in King's Pass, against the False Knight and Hornet"></td>+ <td><img src="games/hollowknight/docs/greenpath.png" width="100%" alt="Hollow Knight: Greenpath"></td>+ </tr><tr><td><img src="docs/media/numdrive.gif" alt="NumDrive gameplay"></td><td><img src="docs/media/balatro.gif" alt="Balatro: a Four of a Kind scoring with five Jokers"></td>@@ -298,6 +329,7 @@ You need your calculator, its USB cable, and a computer with **Google Chrome** o- **Balatro** by LocalThunk inspired NumPlay's Balatro, which uses art adapted from the game and the **m6x11** font by Daniel Linssen.- **Minecraft** by Mojang inspired NumBlocks, which uses Minecraft 1.8.8's textures, font and screens and makes its worlds the way Minecraft 1.8.8 does.- **Celeste** inspired NumPlay's Celeste, which uses the game's own pictures, maps, texts and fonts. Not affiliated with Maddy Makes Games.+- **Hollow Knight** inspired NumPlay's Hollow Knight, which uses the game's own pictures, animations, maps, texts and fonts. Not affiliated with Team Cherry.- **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.@@ -310,4 +342,4 @@ NumPlay is licensed under the [GNU General Public License v3.0](LICENSE). CopyriCode 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), Mojang or Microsoft (Minecraft), Maddy Makes Games (Celeste), MateoConLechuga (Portal Returns), Valve (Portal), .GEARS (Flappy Bird), Bandai Namco (Pac-Man), Hasbro (Connect Four), Google (Snake, Solitaire, Block Breaker, Doodle Champion Island Games), STUDIO4°C or Microsoft (Minesweeper). Tetris is a trademark of The Tetris Company, 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), Mojang or Microsoft (Minecraft), Maddy Makes Games (Celeste), Team Cherry (Hollow Knight), MateoConLechuga (Portal Returns), Valve (Portal), .GEARS (Flappy Bird), Bandai Namco (Pac-Man), Hasbro (Connect Four), Google (Snake, Solitaire, Block Breaker, Doodle Champion Island Games), STUDIO4°C or Microsoft (Minesweeper). Tetris is a trademark of The Tetris Company, Minecraft of Mojang Synergies AB, Pac-Man of Bandai Namco and Connect Four of Hasbro.</sub>diff --git a/docs/media/hollowknight.gif b/docs/media/hollowknight.gifnew file mode 100644index 00000000..470ca95dBinary files /dev/null and b/docs/media/hollowknight.gif differdiff --git a/docs/media/thumb_hollowknight.png b/docs/media/thumb_hollowknight.pngnew file mode 100644index 00000000..3ef321a1Binary files /dev/null and b/docs/media/thumb_hollowknight.png differdiff --git a/docs/play.md b/docs/play.mdindex 9f0bcd89..aac27fbf 100644--- a/docs/play.md+++ b/docs/play.md@@ -73,6 +73,29 @@ The left thumb looks with the arrows (shift and alpha are just under them), the<br clear="right">+## Hollow Knight++<img src="media/hollowknight.gif" width="320" align="right" alt="Hollow Knight: the Knight in King's Pass, against the False Knight and Hornet">++Hollow Knight comes as its own app, `HollowKnight.nwa`: it is too big to share the calculator with NumPlay.++| Key | What it does |+| --- | --- |+| **Arrows** | Move, look up and down, aim the nail up or down |+| **Up** | Talk, read, rest at a bench, go through a door |+| **OK** | Jump |+| **Back** | Nail |+| **shift** | Dash, once you have the Mothwing Cloak |+| **alpha** | Hold to focus and heal, tap to cast a spell |+| **var** | Hold for the quick map |+| **toolbox** | Inventory |+| **⌫** | Pause |+| **Home** | Save and quit |++Choose Start Game, then a save. Rest at benches to save and to change charms. In menus, **OK** or **EXE** confirms and **Back** goes back. In the inventory, left and right at the edges change pages; on the map page, **OK** places markers once you have them, and **shift** shows or hides the key and the pins. Home saves and quits, as Quit to Menu does. Your saves are also copied into `hollowknight_saves.py`, so installing the app again doesn't erase them.++<br clear="right">+## Celeste<img src="media/celeste.gif" width="320" align="right" alt="Celeste: Madeline dashing through the Forsaken City">diff --git a/games/hollowknight/README.md b/games/hollowknight/README.mdnew file mode 100644index 00000000..d8ba127c--- /dev/null+++ b/games/hollowknight/README.md@@ -0,0 +1,89 @@+> **Hollow Knight is a [NumPlay](../../README.md) game that comes on its own.** It fills the calculator's whole app space, so it can't sit next to NumPlay. Get `HollowKnight.nwa` from the [latest release](https://github.com/Mason363/NumPlay/releases/latest).++<p align="center">+ <img src="src/icon.png" width="84" alt="Hollow Knight icon">+</p>++<h1 align="center">Hollow Knight</h1>++<p align="center">+ <b>Explore Hallownest as the Knight, on the NumWorks calculator.</b><br>+ From King's Pass and Dirtmouth, through the Forgotten Crossroads, to Hornet in Greenpath.+</p>++<p align="center">+ <a href="https://github.com/Mason363/NumPlay/releases/latest/download/HollowKnight.nwa"><b>Download HollowKnight.nwa</b></a>+ · <a href="#controls">Controls</a>+</p>++## Highlights++* **The start of the journey:** King's Pass, Dirtmouth, the Forgotten Crossroads with the False Knight, Gruz Mother and the Ancestral Mound, then Greenpath up to Hornet and the Mothwing Cloak, with the rooms along the way and their secrets.+* **The Knight moves like in the game:** the same jumps, nail slashes, recoils, pogos, dash, focus and Vengeful Spirit.+* **Its creatures and bosses:** from Crawlids and Vengeflies to Moss Knights and Mosskin, the False Knight, Gruz Mother and Hornet, each with its own attacks.+* **The people of Hallownest:** Elderbug, Sly, Iselda, Cornifer, Salubra, the Snail Shaman, Quirrel, Tiso, the Stag and the Grubfather, with all they have to say.+* **Everything to find and spend:** geo, charms and what they do, mask shards, vessel fragments, grubs, relics, the map, the quill and its markers, the stag stations and the shops.+* **Saved like in the game:** rest at a bench to save; die and your shade waits where you fell. Your saves are also copied into `hollowknight_saves.py`, so installing the app again doesn't erase them.++<table>+ <tr>+ <td align="center"><img src="docs/kingspass.png" width="390" alt="King's Pass"><br><sub>King's Pass</sub></td>+ <td align="center"><img src="docs/dirtmouth.png" width="390" alt="Dirtmouth"><br><sub>Dirtmouth and Elderbug</sub></td>+ </tr>+ <tr>+ <td align="center"><img src="docs/crossroads.png" width="390" alt="Forgotten Crossroads"><br><sub>The Forgotten Crossroads</sub></td>+ <td align="center"><img src="docs/falseknight.png" width="390" alt="False Knight"><br><sub>The False Knight</sub></td>+ </tr>+ <tr>+ <td align="center"><img src="docs/greenpath.png" width="390" alt="Greenpath"><br><sub>Greenpath</sub></td>+ <td align="center"><img src="docs/hornet.png" width="390" alt="Hornet"><br><sub>Hornet</sub></td>+ </tr>+ <tr>+ <td align="center"><img src="docs/iselda.png" width="390" alt="Iselda's shop"><br><sub>Iselda's map shop</sub></td>+ <td align="center"><img src="docs/map.png" width="390" alt="The quick map"><br><sub>The quick map</sub></td>+ </tr>+</table>++## How to play++Choose Start Game, then a save. A new game starts with the Knight falling into King's Pass. Walk on to Dirtmouth and down the well into the Forgotten Crossroads.++Hit enemies with the nail to fill your soul, then hold the spell key to focus it into health. Rest at benches to save and to change charms. When you die you lose your geo and leave a shade behind: defeat it to get them back.++⌫ pauses: from there you can go on or quit to the title screen, which saves.++## Controls++| Key | What it does |+| --- | --- |+| Arrows | Move, look up and down, aim the nail up or down |+| Up | Talk, read, rest at a bench, go through a door |+| OK | Jump |+| Back | Nail |+| Shift | Dash, once you have the Mothwing Cloak |+| Alpha | Hold to focus and heal, tap to cast a spell |+| Var | Hold for the quick map |+| Toolbox | Inventory |+| ⌫ | Pause |+| Home | Save and quit |++In menus, OK or EXE confirms and Back goes back. In the inventory, left and right at the edges change pages. On the map page, OK places markers once you have them, and Shift shows or hides the key and the pins.++## Good to know++* **One app at a time:** Hollow Knight takes all the room the calculator has for apps. Installing it from the NumWorks website swaps out NumPlay and the other apps, and installing NumPlay again swaps it back out. Your saves in each one are kept.+* **Only the start of the game:** it ends with Hornet in Greenpath. The ways on to places further in stay shut, like Jiji's door, the lift down to the mines and the Dream Nail's paths.+* **No music or sound:** the calculator has no speaker.+* **A few things are simpler:** dust, sparks and other particles are left out, and characters and scenery are drawn a little less finely so the whole game fits.++## Credits++Inspired by Hollow Knight, not affiliated with Team Cherry.++* The pictures, animations, maps, texts and fonts come from the game's own files.++Made by Mason Chen as part of NumPlay.++## License++The game's code is licensed under the GNU General Public License v3.0: see the `LICENSE` file at the root of the repository. The game's pictures, animations, maps, texts and fonts keep their own terms (see Credits).diff --git a/games/hollowknight/docs/crossroads.png b/games/hollowknight/docs/crossroads.pngnew file mode 100644index 00000000..64884683Binary files /dev/null and b/games/hollowknight/docs/crossroads.png differdiff --git a/games/hollowknight/docs/dirtmouth.png b/games/hollowknight/docs/dirtmouth.pngnew file mode 100644index 00000000..b88445e9Binary files /dev/null and b/games/hollowknight/docs/dirtmouth.png differdiff --git a/games/hollowknight/docs/falseknight.png b/games/hollowknight/docs/falseknight.pngnew file mode 100644index 00000000..cf985048Binary files /dev/null and b/games/hollowknight/docs/falseknight.png differdiff --git a/games/hollowknight/docs/greenpath.png b/games/hollowknight/docs/greenpath.pngnew file mode 100644index 00000000..36415ddfBinary files /dev/null and b/games/hollowknight/docs/greenpath.png differdiff --git a/games/hollowknight/docs/hornet.png b/games/hollowknight/docs/hornet.pngnew file mode 100644index 00000000..d4d8b446Binary files /dev/null and b/games/hollowknight/docs/hornet.png differdiff --git a/games/hollowknight/docs/iselda.png b/games/hollowknight/docs/iselda.pngnew file mode 100644index 00000000..f7d9859bBinary files /dev/null and b/games/hollowknight/docs/iselda.png differdiff --git a/games/hollowknight/docs/kingspass.png b/games/hollowknight/docs/kingspass.pngnew file mode 100644index 00000000..6931527fBinary files /dev/null and b/games/hollowknight/docs/kingspass.png differdiff --git a/games/hollowknight/docs/map.png b/games/hollowknight/docs/map.pngnew file mode 100644index 00000000..b18cd79fBinary files /dev/null and b/games/hollowknight/docs/map.png differdiff --git a/tests/test_games.py b/tests/test_games.pyindex 59b3c8de..7e4276f6 100644--- a/tests/test_games.py+++ b/tests/test_games.py@@ -111,6 +111,11 @@ GAMES = {"celeste": ("Celeste.nwa", "celeste.sav",presses((2500, "ok"), (4000, "ok"), (5500, "ok"), (7000, "ok"), (8500, "ok"), (11000, "right", 2500)), 15000,presses((2500, "ok"), (4000, "ok"), (5500, "ok"), (7500, "right", 1500)), 11000),+ # Start Game, the first profile (a new game: the Knight falls into King's Pass), then Home, which saves as Quit+ # to Menu; then the same profile, loaded+ "hollowknight": ("HollowKnight.nwa", "hk1.sav",+ presses((2500, "ok"), (4500, "ok")) + every(12000, 16000, 600, "right", 400), 20000,+ presses((2500, "ok"), (4500, "ok")) + every(9000, 11000, 600, "left", 400), 14000),# 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,@@ -137,7 +142,8 @@ SEEDS = {# games that keep a copy of their save in a Python script (the only files the# NumWorks installer keeps): before the second session, as after installing# the app again, only the scripts are left, and the save must come back-COPIES = {"championisland": "champion_saves.py", "numblocks": "numblocks_saves.py", "celeste": "celeste_saves.py"}+COPIES = {"championisland": "champion_saves.py", "numblocks": "numblocks_saves.py", "celeste": "celeste_saves.py",+ "hollowknight": "hollowknight_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,@@ -146,6 +152,9 @@ CHECKS = {"celeste": (lambda v: v[:4] == b"SLEC" and v[1072] == 1 and struct.unpack_from("<I", v, 1096)[0] > 0,lambda v: v[:4] == b"SLEC" and v[1072] == 1 and struct.unpack_from("<I", v, 1096)[0] > 60),"chess": (lambda v: v == SEEDS["chess"],) * 2, # read back and kept+ # a game saved ("HKSV", then the play time at 152); after the reinstall, from the copy, it goes on+ "hollowknight": (lambda v: v[:4] == b"HKSV" and struct.unpack_from("<f", v, 152)[0] > 0,+ lambda v: v[:4] == b"HKSV" and struct.unpack_from("<f", v, 152)[0] > 10),"numvisuals": (lambda v: v[:2] == b"V\1" and v[3] == 4 and struct.unpack_from("<i", v, 8)[0] == 2,lambda v: struct.unpack_from("<i", v, 8)[0] == 3), # the add-on and its count"flappybird": (lambda v: len(v) == 26 and v[:3] == b"F\1\1" and v[8] == 3, # Custom, Speed Fastdiff --git a/tools/release.py b/tools/release.pyindex 0b10d72e..1bac2e61 100644--- a/tools/release.py+++ b/tools/release.py@@ -28,6 +28,8 @@ ALONE = {"on its own", "numblocks"),"championisland": ("Champion Island", "the Doodle Champion Island Games. Too big to share the calculator with ""NumPlay: install it on its own", None),+ "hollowknight": ("Hollow Knight", "from King's Pass to Hornet in Greenpath. Too big to share the calculator with "+ "NumPlay: install it on its own", "numblocks"),}VARIANTS = [("NumPlay-Invisible.nwa", "The same app, hidden: a blank icon with no name"),