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.

Sonic: README, icon, screenshots and media

Mason3636018b9d1dd9a
diff --git a/docs/media/gallery/sonic.gif b/docs/media/gallery/sonic.gif
new file mode 100644
index 00000000..254154a7
Binary files /dev/null and b/docs/media/gallery/sonic.gif differ
diff --git a/docs/media/sonic.gif b/docs/media/sonic.gif
new file mode 100644
index 00000000..4d2ab54e
Binary files /dev/null and b/docs/media/sonic.gif differ
diff --git a/docs/media/thumb_sonic.png b/docs/media/thumb_sonic.png
new file mode 100644
index 00000000..f7075fb8
Binary files /dev/null and b/docs/media/thumb_sonic.png differ
diff --git a/games/sonic/README.md b/games/sonic/README.md
new file mode 100644
index 00000000..5da17847
--- /dev/null
+++ b/games/sonic/README.md
@@ -0,0 +1,93 @@
+> **Sonic the Hedgehog is a [NumPlay](../../README.md) game that comes on its own.** It is too big to sit next to NumPlay. Get `SonicTheHedgehog.nwa` from the [latest release](https://github.com/Mason363/NumPlay/releases/latest).
+
+<p align="center">
+ <img src="src/icon.png" width="84" alt="Sonic the Hedgehog icon">
+</p>
+
+<h1 align="center">Sonic the Hedgehog</h1>
+
+<p align="center">
+ <b>The 1991 Mega Drive game, whole, on the NumWorks calculator.</b><br>
+ Green Hill, Marble, Spring Yard, Labyrinth, Star Light and Scrap Brain, the Final Zone, the Special Stages and the six Chaos Emeralds, to the ending, at 60 frames a second.
+</p>
+
+<p align="center">
+ <a href="https://github.com/Mason363/NumPlay/releases/latest/download/SonicTheHedgehog.nwa"><b>Download SonicTheHedgehog.nwa</b></a>
+ &nbsp;·&nbsp; <a href="#controls">Controls</a>
+</p>
+
+<p align="center">
+ <img src="../../docs/media/sonic.gif" width="640" alt="The title, then the demos: Green Hill, Marble, Spring Yard and the Special Stage">
+</p>
+
+## Highlights
+
+* **All of it:** the six zones, three acts each (Scrap Brain's third under Labyrinth's water), the Final Zone, the six Special Stages, the continue screen, the good and the bad ending, the credits with their demos and Dr. Robotnik juggling the emeralds you missed.
+* **The game itself, not a remake:** its code is the original's, routine by routine, in C: Sonic's physics (his speeds, slopes, loops, rolling, the way he sticks to the ground and lets go of it), every object and badnik with its quirks, every boss, the camera, the zones' moving backgrounds, the colour cycles, the water. The attract mode's demos play back the recorded buttons and Sonic goes where he went on the Mega Drive.
+* **Its pictures and levels:** the art, the levels, the object placement, the palettes and the demos come from the game's data (see Credits), drawn as the Mega Drive drew them: two scrolling planes and the sprites, a scroll for each line, the water's palette below its surface.
+* **The Special Stages:** the maze turning round Sonic, with its bumpers, UP and DOWN, R, glass and ghost blocks and the emerald in the middle, and the birds turning into fish behind it.
+* **Saved:** each act as it starts, and Home or On/Off keeps where you are: Continue on the title goes back to it with your lives, continues, emeralds and score. The save is also copied into `sonic_saves.py`, so installing the app again doesn't erase it.
+
+<table>
+ <tr>
+ <td align="center"><img src="docs/ghz.png" width="390" alt="Green Hill Zone"><br><sub>Green Hill Zone</sub></td>
+ <td align="center"><img src="docs/ghzboss.png" width="390" alt="Dr. Robotnik's wrecking ball"><br><sub>Dr. Robotnik's wrecking ball</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><img src="docs/mz.png" width="390" alt="Marble Zone"><br><sub>Marble Zone</sub></td>
+ <td align="center"><img src="docs/syz.png" width="390" alt="Spring Yard Zone"><br><sub>Spring Yard Zone</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><img src="docs/lz.png" width="390" alt="Labyrinth Zone"><br><sub>Labyrinth Zone, under water</sub></td>
+ <td align="center"><img src="docs/slz.png" width="390" alt="Star Light Zone"><br><sub>Star Light Zone</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><img src="docs/slzboss.png" width="390" alt="The seesaws of Star Light Zone's boss"><br><sub>Spiked balls and seesaws</sub></td>
+ <td align="center"><img src="docs/sbz.png" width="390" alt="Scrap Brain Zone"><br><sub>Scrap Brain Zone</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><img src="docs/fz.png" width="390" alt="The Final Zone"><br><sub>The Final Zone's crushing cylinders</sub></td>
+ <td align="center"><img src="docs/special.png" width="390" alt="A Special Stage"><br><sub>A Special Stage</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><img src="docs/continue.png" width="390" alt="The continue screen"><br><sub>Continue?</sub></td>
+ <td align="center"><img src="docs/ending.png" width="390" alt="The ending"><br><sub>The ending</sub></td>
+ </tr>
+</table>
+
+## How to play
+
+Run to the right and reach the signpost at the end of each act; the third act of each zone ends with Dr. Robotnik and the capsule his animals are locked in. Collect rings: when something hits you, you only drop them, and with none you lose a life. A hundred rings give an extra life. Roll into badniks or jump on them to free the animals inside.
+
+Finish an act with 50 rings or more and a giant ring appears by the signpost: jump into it for a Special Stage. Steer Sonic through the turning maze to the Chaos Emerald in the middle, away from the GOAL blocks. The six emeralds change the ending.
+
+When the game is over, the continues you collected (50 rings in a Special Stage) let you go on from the act you were in.
+
+## Controls
+
+| Key | What it does |
+| --- | --- |
+| Arrows (or 4, 6, 8, 2) | Run, look up, duck; Down while running rolls |
+| OK, EXE, 5, 0 or Shift | Jump (A, B and C on the Mega Drive pad) |
+| Back or ⌫ | Start: pause, with Resume and Quit game |
+| Home or On/Off | Save and quit: Continue on the title goes back there |
+
+## Good to know
+
+* **One app at a time:** Sonic the Hedgehog is too big to sit next to NumPlay or the other big games. Installing it from the NumWorks website swaps them out, and installing them again swaps it out. Your saves in each one are kept.
+* **The picture:** the Mega Drive's 320 by 224 picture, one pixel for one, with a band above and below. On the N0110 the slowest moments leave a frame out now and then to keep the game at full speed.
+* **No music or sound:** the calculator has no speaker.
+* **Not in it:** the cheats (level select, debug mode), so no object placing.
+
+## Credits
+
+Inspired by Sonic the Hedgehog (1991) by Sonic Team, not affiliated with SEGA.
+
+* The game's art, levels, object placement, palettes and demos are read from the [Sonic Retro disassembly](https://github.com/sonicretro/s1disasm) (`tools/fetch.py` gets it, `tools/pack.py` packs it), whose labels and notes the code follows.
+* The physics follow the [Sonic Physics Guide](https://info.sonicretro.org/Sonic_Physics_Guide).
+
+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. Sonic the Hedgehog's pictures, levels and characters belong to SEGA (see Credits).
diff --git a/games/sonic/docs/continue.png b/games/sonic/docs/continue.png
new file mode 100644
index 00000000..18a5ce5b
Binary files /dev/null and b/games/sonic/docs/continue.png differ
diff --git a/games/sonic/docs/ending.png b/games/sonic/docs/ending.png
new file mode 100644
index 00000000..629f0dde
Binary files /dev/null and b/games/sonic/docs/ending.png differ
diff --git a/games/sonic/docs/fz.png b/games/sonic/docs/fz.png
new file mode 100644
index 00000000..c64761a7
Binary files /dev/null and b/games/sonic/docs/fz.png differ
diff --git a/games/sonic/docs/ghz.png b/games/sonic/docs/ghz.png
new file mode 100644
index 00000000..4be5d722
Binary files /dev/null and b/games/sonic/docs/ghz.png differ
diff --git a/games/sonic/docs/ghzboss.png b/games/sonic/docs/ghzboss.png
new file mode 100644
index 00000000..f0424fd1
Binary files /dev/null and b/games/sonic/docs/ghzboss.png differ
diff --git a/games/sonic/docs/lz.png b/games/sonic/docs/lz.png
new file mode 100644
index 00000000..f68b90fa
Binary files /dev/null and b/games/sonic/docs/lz.png differ
diff --git a/games/sonic/docs/mz.png b/games/sonic/docs/mz.png
new file mode 100644
index 00000000..49547d7c
Binary files /dev/null and b/games/sonic/docs/mz.png differ
diff --git a/games/sonic/docs/sbz.png b/games/sonic/docs/sbz.png
new file mode 100644
index 00000000..3a5e55d1
Binary files /dev/null and b/games/sonic/docs/sbz.png differ
diff --git a/games/sonic/docs/slz.png b/games/sonic/docs/slz.png
new file mode 100644
index 00000000..cd2f6e9f
Binary files /dev/null and b/games/sonic/docs/slz.png differ
diff --git a/games/sonic/docs/slzboss.png b/games/sonic/docs/slzboss.png
new file mode 100644
index 00000000..1a86f044
Binary files /dev/null and b/games/sonic/docs/slzboss.png differ
diff --git a/games/sonic/docs/special.png b/games/sonic/docs/special.png
new file mode 100644
index 00000000..400aa350
Binary files /dev/null and b/games/sonic/docs/special.png differ
diff --git a/games/sonic/docs/syz.png b/games/sonic/docs/syz.png
new file mode 100644
index 00000000..8e60f873
Binary files /dev/null and b/games/sonic/docs/syz.png differ
diff --git a/games/sonic/src/icon.png b/games/sonic/src/icon.png
index 608fe4b0..3745a907 100644
Binary files a/games/sonic/src/icon.png and b/games/sonic/src/icon.png differ