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.

Subway Surfers: README, screenshots, GIFs and thumbnail for the game's own look

Mason363eb2959d49098
diff --git a/docs/media/gallery/subway.gif b/docs/media/gallery/subway.gif
index 9a20d3f9..8851c71e 100644
Binary files a/docs/media/gallery/subway.gif and b/docs/media/gallery/subway.gif differ
diff --git a/docs/media/subway.gif b/docs/media/subway.gif
index 91643f23..cc2634f1 100644
Binary files a/docs/media/subway.gif and b/docs/media/subway.gif differ
diff --git a/docs/media/thumb_subway.png b/docs/media/thumb_subway.png
index ec8e6e1b..e10dc9b9 100644
Binary files a/docs/media/thumb_subway.png and b/docs/media/thumb_subway.png differ
diff --git a/games/subway/README.md b/games/subway/README.md
index a04d2581..edcdb821 100644
--- a/games/subway/README.md
+++ b/games/subway/README.md
@@ -17,38 +17,37 @@
</p>
<p align="center">
- <img src="../../docs/media/subway.gif" width="640" alt="Running down the tracks between trains, jumping a barrier and flying with the jetpack">
+ <img src="../../docs/media/subway.gif" width="640" alt="From the title into a run, the Inspector and his dog behind, riding a hoverboard between subway trains, then flying with the jetpack">
</p>
## Highlights
-* **Three tracks in real 3D:** trains standing on them and trains coming at you with their lights on, ramps up onto the roofs, low barriers to jump, high ones to roll under and big ones to go round. Running along the roofs and jumping from one train to the next is often the way through.
-* **The classic yard:** the orange viaduct with its arches and the bushy trees over it, the overhead wires on their gantries, blue steel bridges over the water, stretches of concrete wall with graffiti and houses behind, stations with their platforms, and tunnels into the dark. The trains wear the game's liveries: the orange and lime commuter train, the silver one, the red, white and blue one, the blue open wagons and the green box cars.
-* **The game's own people:** Jake, Tricky, Fresh (with his boombox) and Spike, and the Inspector and his dog, built on the game's own 3D models and wearing their textures, with smooth shading. They run, jump, roll, stumble, surf and fly with keyframed animations, and Jake's vest has the Sub Surf graffiti on its back.
-* **The Inspector and his dog:** they chase you off at the start. Hit the side of a train or a barrier's edge and you stumble: they're right behind you, and if you stumble again before they give up, you're caught. Run into anything head-on and it's over.
-* **Faster and faster:** the longer you run, the faster it goes, and the harder the tracks get.
-* **Coins everywhere:** in lines down the tracks, in arcs over the barriers, up the ramps and along the roofs, and high in the sky for the jetpack.
-* **Power-ups:** the **Jetpack** flies you over everything, **Super Sneakers** jump high enough to land on the trains, the **Coin Magnet** pulls in every coin near you and the **2x Multiplier** doubles your score. **Mystery boxes** hold coins, keys, hoverboards and more, and **keys** turn up now and then.
-* **Hoverboards:** OK rides one for 30 seconds, and a crash only breaks the board. Three boards: the classic **Hoverboard**, the **Bouncer** (super jumps) and the **Daredevil** (faster).
+* **The game's own people:** Jake, Tricky, Fresh and Spike, the Inspector and his dog are the game's own 3D models and textures, with fewer triangles for the calculator. They move with the game's own animations: running, jumping, rolling, dodging, surfing, flying with the jetpack, stumbling, being caught. From behind, Jake has his white hood and the Sub Surf graffiti on his vest, as in the game.
+* **Subway City:** the game's own streets and yards along the tracks, its elevated line and stations, its glass hall, its trains (the silver subway train, the teal train, the red cargo wagons and their engine, the ramp wagon), its barriers and its tracks. They are the game's models, made into a few flat faces each with all their detail painted on, so the calculator can draw them fast.
+* **The game's numbers:** the speed (from 110 to 220 of the game's units a second over three minutes), a lane change in 0.27 seconds, jumps 20 units high, rolls of 0.6 seconds, the camera 33 units up and 33 behind, the time of each power-up at each upgrade (jetpack 8 to 25 seconds, the others 10 to 30), a 30 second hoverboard, a 6 second headstart, the score multiplier up to x30.
+* **Trains and barriers:** trains standing on the tracks and trains coming at you with their lights on, ramp wagons up onto the roofs, the low barrier to jump, the tall one to roll under, and the one on trestles to jump or roll under. Hit the side of a train or a barrier and you stumble: the Inspector and his dog are right behind you, and if you stumble again you're caught. Run into anything head-on and it's over.
+* **Coins and power-ups:** the game's coins in lines and arcs, the **Jetpack**, **Super Sneakers**, **Coin Magnet** and **2x Multiplier**, **Mystery boxes** and **keys**, all the game's own models, turning.
+* **Hoverboards:** OK rides one for 30 seconds, and a crash only breaks the board. The game's three boards: the classic **Hoverboard**, the **Bouncer** (super jumps) and the **Daredevil** (faster).
* **Headstarts and score boosters:** at the start of a run, 1 flies you far ahead and 3 adds 5 to your score multiplier.
* **Save me!** Crashed? Spend a key to keep going: then 2, 4, 8...
-* **Missions:** sets of three, like "Jump 25 times in one run" or "Run 150 m on top of trains". Finish a set and your score multiplier goes up, all the way to x30.
-* **The shop:** upgrade each power-up to make it last longer (six levels, up to 30 seconds), buy hoverboards, headstarts, score boosters and mystery boxes, and unlock **Jake**, **Tricky**, **Fresh** and **Spike** and the boards.
-* **Smooth:** the world is drawn in 3D, a band of the screen at a time, at 30 frames a second or more on every calculator.
-* **Saved:** your coins, keys, best score, items, upgrades, characters, boards and missions. Home or On/Off in a run keeps the coins you've picked up. The save is also copied into `subway_saves.py`, so installing the app again doesn't erase it.
+* **Missions:** sets of three, like "Jump 25 times in one run". Finish a set and your score multiplier goes up, all the way to x30.
+* **The game's screens:** its score plate with the star, its pause button, its pause screen with the missions and QUIT and RESUME, its popups, buttons, icons and logo, in its own lettering. Every screen shows which keys to press.
+* **The shop:** upgrade each power-up (six steps), buy hoverboards, headstarts, score boosters and mystery boxes, and unlock **Tricky**, **Fresh** and **Spike** and the boards.
+* **Smooth:** about 30 frames a second or more on every calculator.
+* **Saved:** your coins, keys, best score, items, upgrades, characters, boards and missions. Home or On/Off saves and quits from anywhere, and keeps the coins of a run. The save is also copied into `subway_saves.py`, so installing the app again doesn't erase it.
<table>
<tr>
- <td align="center" width="50%"><img src="docs/title.png" width="100%" alt="The title: Jake between two of the classic orange and lime trains"></td>
- <td align="center" width="50%"><img src="docs/run.png" width="100%" alt="Running between trains under the orange viaduct, coins down the free track"></td>
+ <td align="center" width="50%"><img src="docs/title.png" width="100%" alt="The title: Jake standing on the tracks between a subway train and a cargo wagon"></td>
+ <td align="center" width="50%"><img src="docs/run.png" width="100%" alt="Running between two silver subway trains, coins down the track"></td>
</tr>
<tr>
- <td align="center"><img src="docs/bridge.png" width="100%" alt="Over the blue steel bridge"></td>
- <td align="center"><img src="docs/jetpack.png" width="100%" alt="Flying with the jetpack over the tracks and the trees"></td>
+ <td align="center"><img src="docs/trains.png" width="100%" alt="Two subway trains coming, their lights on"></td>
+ <td align="center"><img src="docs/jetpack.png" width="100%" alt="Flying with the jetpack over the tracks"></td>
</tr>
<tr>
- <td align="center"><img src="docs/tunnel.png" width="100%" alt="Into a tunnel"></td>
- <td align="center"><img src="docs/shop.png" width="100%" alt="The shop: Fresh with his boombox, turning on his stand"></td>
+ <td align="center"><img src="docs/pause.png" width="100%" alt="The pause screen: the missions, QUIT and RESUME"></td>
+ <td align="center"><img src="docs/shop.png" width="100%" alt="The shop: Fresh turning on his stand"></td>
</tr>
</table>
@@ -62,7 +61,7 @@
| OK, EXE or 5 | Ride a hoverboard; choose, buy |
| 1 | A headstart (at the start of a run) |
| 3 | A score booster (at the start of a run) |
-| Back or ⌫ | Pause (Resume, Quit game); back in the menus |
+| Back or ⌫ | Pause (QUIT or RESUME, QUIT asks first); back in the menus |
| Home or On/Off | Save and quit |
On the title, OK plays, and Down goes to the **Shop**, the **Missions** and **Help**. In the shop, Left and Right go from shelf to shelf.
@@ -72,19 +71,19 @@ On the title, OK plays, and Down goes to the **Shop**, the **Missions** and **He
* **One app at a time:** Subway Surfers 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.
* **No clock, no daily rewards:** the calculator has no clock, so there are no daily challenges or word hunts.
* **No music or sound:** the calculator has no speaker.
-* **Where the pictures come from:** the people are fitted to the game's own 3D models as the Subway Surfers Wiki shows them from the front, and wear those pictures as their textures; the logo and the icons of coins, keys, power-ups and items are the wiki's. The yard, the trains, the barriers and the dog are drawn after the game.
+* **Where the pictures come from:** everything you see is the game's own: its 3D models, textures, animations, screen pictures and logo, taken from its Android package (version 3.70.3) with `tools/apk.py`. The city is the game's Subway City yard, in the colours of its Plant Invasion version, without the plants.
## Credits
-Inspired by Subway Surfers by SYBO and Kiloo, not affiliated with them.
+Subway Surfers is a game by SYBO (first with Kiloo). This port is not affiliated with or endorsed by them.
-* The people's looks (Jake, Tricky, Fresh, Spike and the Inspector: their outlines and textures), the logo and the icons of coins, keys, power-ups and items come from the [Subway Surfers Wiki](https://subwaysurf.fandom.com): its pictures of the game's 3D models, its logo and its item icons.
-* The lettering is the **Lilita One** font by Juan Montoreano, under the SIL Open Font License ([license](../../LICENSES/OFL-1.1-LilitaOne.txt)).
+* The people, the Inspector and his dog, their animations, the trains, barriers, tracks and city, the coins, keys, power-ups and boards, the icons, buttons and logo, and the app icon are the game's own (SYBO's), taken from its Android package.
+* The lettering is the game's own font, **Lilita One** by Juan Montoreano, under the SIL Open Font License ([license](../../LICENSES/OFL-1.1-LilitaOne.txt)).
Made by Mason Chen as part of NumPlay.
-Build: `make` (needs `arm-none-eabi-gcc` and Node.js for nwlink); `make test` plays it on a computer. `make data` gathers the wiki's pictures (`tools/fetch.py`) and turns them into `src/data.c` (`tools/pack.py`, with `tools/models.py` for the people and `tools/scenery.py` for the yard); the result is committed, so building needs no network.
+Build: `make` (needs `arm-none-eabi-gcc` and Node.js for nwlink); `make test` plays it on a computer. `make data APK=DIR` makes `src/data.c` and `src/icon.png` again from the game's Android package unzipped in `DIR` (`tools/apk.py` reads its bundles with UnityPy, `tools/decimate.py` takes triangles away, `tools/bake.py` makes the city's faces); the result is committed, so building needs neither the package nor the network.
## 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 and the font keep their own terms (see Credits).
+The port'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, models and animations are SYBO's, and the font keeps its own terms (see Credits).
diff --git a/games/subway/docs/bridge.png b/games/subway/docs/bridge.png
deleted file mode 100644
index 55bad0d6..00000000
Binary files a/games/subway/docs/bridge.png and /dev/null differ
diff --git a/games/subway/docs/jetpack.png b/games/subway/docs/jetpack.png
index 7551d77d..e49e78a2 100644
Binary files a/games/subway/docs/jetpack.png and b/games/subway/docs/jetpack.png differ
diff --git a/games/subway/docs/pause.png b/games/subway/docs/pause.png
new file mode 100644
index 00000000..6f716886
Binary files /dev/null and b/games/subway/docs/pause.png differ
diff --git a/games/subway/docs/run.png b/games/subway/docs/run.png
index f157a653..3568add9 100644
Binary files a/games/subway/docs/run.png and b/games/subway/docs/run.png differ
diff --git a/games/subway/docs/shop.png b/games/subway/docs/shop.png
index bd55ed5e..cc78f82f 100644
Binary files a/games/subway/docs/shop.png and b/games/subway/docs/shop.png differ
diff --git a/games/subway/docs/title.png b/games/subway/docs/title.png
index b7576900..c19a8bb6 100644
Binary files a/games/subway/docs/title.png and b/games/subway/docs/title.png differ
diff --git a/games/subway/docs/trains.png b/games/subway/docs/trains.png
new file mode 100644
index 00000000..e0643ebe
Binary files /dev/null and b/games/subway/docs/trains.png differ
diff --git a/games/subway/docs/tunnel.png b/games/subway/docs/tunnel.png
deleted file mode 100644
index b80e4dad..00000000
Binary files a/games/subway/docs/tunnel.png and /dev/null differ
diff --git a/games/subway/src/app.c b/games/subway/src/app.c
index 67d86461..79376d04 100644
--- a/games/subway/src/app.c
+++ b/games/subway/src/app.c
@@ -398,7 +398,7 @@ static void draw_runner(void) {
if (!title && (pl.chase > 0 || pl.dead)) {
float back = pl.dead ? 1.3f - (pl.crash_t > 1 ? 1 : pl.crash_t) * 0.5f : 2.4f + (pl.chase < 1 ? (1 - pl.chase) * 9 : 0);
if (run.start_t < 1) back = 2.4f + (1 - run.start_t) * 3;
- float ix = pl.x + 0.55f, dx = pl.x - 0.75f;
+ float ix = pl.x + (pl.dead ? 0.85f : 0.55f), dx = pl.x - 0.8f;
actor_draw(WHO_INSPECTOR, &a_guard, (V3){ix, pl.dead ? pl.ground : 0, pl.z - back}, 0, 0, lt);
actor_draw(WHO_DOG, &a_dog, (V3){dx, pl.dead ? pl.ground : 0, pl.z - back + 0.7f}, 0, 0, lt);
}