From 7c398ee1cbcbf59f0c213b37e59ff673e12ab652 Mon Sep 17 00:00:00 2001
From: Bobydeluxe <337467661+Bobydeluxe@users.noreply.github.com>
Date: Fri, 23 Oct 2026 14:23:20 +0200
Subject: [PATCH 1/4] Add Friday Night Funkin as a silent standalone NumWorks
game
---
.github/workflows/fnf.yml | 53 +
Makefile | 13 +-
README.md | 8 +-
games/fnf/.gitattributes | 4 +
games/fnf/.gitignore | 5 +
games/fnf/ASSETS.md | 17 +
games/fnf/LICENSES/Funkin.md | 213 ++++
games/fnf/LICENSES/OFL-1.1-Nunito.txt | 93 ++
games/fnf/LICENSES/funkin.art.md | 9 +
games/fnf/LICENSES/funkin.assets.md | 9 +
games/fnf/Makefile | 52 +
games/fnf/NOTICE | 13 +
games/fnf/README.md | 64 ++
games/fnf/VALIDATION.md | 63 +
games/fnf/assets/art.bin | Bin 0 -> 1375375 bytes
games/fnf/assets/art.json | 1 +
games/fnf/assets/chart-manifest.json | 1520 +++++++++++++++++++++++++
games/fnf/assets/model.json.zlib | Bin 0 -> 304351 bytes
games/fnf/build.py | 83 ++
games/fnf/docs/freeplay.png | Bin 0 -> 12559 bytes
games/fnf/docs/gameplay.png | Bin 0 -> 16704 bytes
games/fnf/docs/menu.png | Bin 0 -> 22379 bytes
games/fnf/src/data.h | 29 +
games/fnf/src/font.c | 2 +
games/fnf/src/game.c | 123 ++
games/fnf/src/game.h | 36 +
games/fnf/src/icon.png | Bin 0 -> 4484 bytes
games/fnf/src/inflate.c | 44 +
games/fnf/src/inflate.h | 7 +
games/fnf/src/main.c | 108 ++
games/fnf/src/render.c | 104 ++
games/fnf/src/render.h | 9 +
games/fnf/src/save.c | 21 +
games/fnf/src/save.h | 10 +
games/fnf/tests/test.c | 75 ++
games/fnf/tests/test_arm.py | 82 ++
games/fnf/tests/test_assets.py | 53 +
games/fnf/tools/assets.py | 110 ++
games/fnf/tools/compact_nwa.py | 228 ++++
games/fnf/tools/import_reference.py | 118 ++
games/fnf/tools/reference_art.py | 141 +++
games/fnf/tools/standalone.ld | 15 +
tools/release.py | 1 +
43 files changed, 3531 insertions(+), 5 deletions(-)
create mode 100644 .github/workflows/fnf.yml
create mode 100644 games/fnf/.gitattributes
create mode 100644 games/fnf/.gitignore
create mode 100644 games/fnf/ASSETS.md
create mode 100644 games/fnf/LICENSES/Funkin.md
create mode 100644 games/fnf/LICENSES/OFL-1.1-Nunito.txt
create mode 100644 games/fnf/LICENSES/funkin.art.md
create mode 100644 games/fnf/LICENSES/funkin.assets.md
create mode 100644 games/fnf/Makefile
create mode 100644 games/fnf/NOTICE
create mode 100644 games/fnf/README.md
create mode 100644 games/fnf/VALIDATION.md
create mode 100644 games/fnf/assets/art.bin
create mode 100644 games/fnf/assets/art.json
create mode 100644 games/fnf/assets/chart-manifest.json
create mode 100644 games/fnf/assets/model.json.zlib
create mode 100644 games/fnf/build.py
create mode 100644 games/fnf/docs/freeplay.png
create mode 100644 games/fnf/docs/gameplay.png
create mode 100644 games/fnf/docs/menu.png
create mode 100644 games/fnf/src/data.h
create mode 100644 games/fnf/src/font.c
create mode 100644 games/fnf/src/game.c
create mode 100644 games/fnf/src/game.h
create mode 100644 games/fnf/src/icon.png
create mode 100644 games/fnf/src/inflate.c
create mode 100644 games/fnf/src/inflate.h
create mode 100644 games/fnf/src/main.c
create mode 100644 games/fnf/src/render.c
create mode 100644 games/fnf/src/render.h
create mode 100644 games/fnf/src/save.c
create mode 100644 games/fnf/src/save.h
create mode 100644 games/fnf/tests/test.c
create mode 100644 games/fnf/tests/test_arm.py
create mode 100644 games/fnf/tests/test_assets.py
create mode 100644 games/fnf/tools/assets.py
create mode 100644 games/fnf/tools/compact_nwa.py
create mode 100644 games/fnf/tools/import_reference.py
create mode 100644 games/fnf/tools/reference_art.py
create mode 100644 games/fnf/tools/standalone.ld
diff --git a/.github/workflows/fnf.yml b/.github/workflows/fnf.yml
new file mode 100644
index 00000000..ea66d028
--- /dev/null
+++ b/.github/workflows/fnf.yml
@@ -0,0 +1,53 @@
+name: Friday Night Funkin
+
+on:
+ pull_request:
+ paths:
+ - 'games/fnf/**'
+ - 'games/common/**'
+ - 'launcher/src/font*'
+ - 'tools/emu.py'
+ - 'Makefile'
+ - '.github/workflows/fnf.yml'
+ push:
+ branches: [main]
+ paths:
+ - 'games/fnf/**'
+ - 'games/common/**'
+ - 'launcher/src/font*'
+ - '.github/workflows/fnf.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ game:
+ runs-on: ubuntu-24.04
+ steps:
+ - uses: actions/checkout@v4
+ - name: ARM toolchain
+ run: |
+ v=15.2.1-1.1
+ curl -fsSL "https://github.com/xpack-dev-tools/arm-none-eabi-gcc-xpack/releases/download/v$v/xpack-arm-none-eabi-gcc-$v-linux-x64.tar.gz" | tar -xz -C "$RUNNER_TEMP"
+ echo "$RUNNER_TEMP/xpack-arm-none-eabi-gcc-$v/bin" >> "$GITHUB_PATH"
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ - uses: actions/setup-python@v5
+ with:
+ python-version: '3.12'
+ - name: Tools
+ run: |
+ npm install -g nwlink@1.0.0
+ pip install pillow==11.3.0 numpy pyelftools unicorn==2.1.4
+ - name: Standalone build and all 166 charts
+ run: |
+ make build/data/apps/FridayNightFunkin.nwa NWLINK=nwlink
+ make -C games/fnf check test test-assets NWLINK=nwlink
+ - name: ARM controls, saves and firmware safety
+ run: python3 games/fnf/tests/test_arm.py --nwlink nwlink
+ - uses: actions/upload-artifact@v4
+ with:
+ name: Friday Night Funkin
+ path: build/data/apps/FridayNightFunkin.nwa
diff --git a/Makefile b/Makefile
index c683fb0e..e385f036 100644
--- a/Makefile
+++ b/Makefile
@@ -29,7 +29,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 JetpackJoyride StickmanHook DonkeyKong Dune MonkeyMart TombOfTheMask
+BIG_APPS = Celeste HollowKnight Undertale ChampionIsland FinalEarth2 NumPowder NumBlocks NumDrive SubwaySurfers FiveNightsAtFreddys Doom BindingOfIsaac HillClimbRacing PlantsVsZombies SonicTheHedgehog CookieClicker LevelDevil JetpackJoyride StickmanHook DonkeyKong Dune MonkeyMart TombOfTheMask FridayNightFunkin
# the calculator's space for installed apps: from the end of its software (64 KiB aligned) to 64 KiB before the
# end of its 4 MiB slot of flash, 0x903F0000. The software's size sets the start: 0x90200000 is the latest a
# NumPlay counts on (1.94 MB, APP_SPACE); Epsilon 26.4 on an N0120 ends at 0x90180000 (2.44 MB, the
@@ -47,7 +47,7 @@ XL_APP_SPACE = 6291456
# the spaces the customizer website offers (kit.json "spaces"; tools/kit.py links a NumPlay at each)
SPACES = std:$(APP_START):$(APP_END) e26:$(APP_START_26):$(APP_END) xl:$(APP_START):$(XL_END) xl26:$(APP_START_26):$(XL_END)
# big games that must install on their own without Enlarged Extra Apps: make check holds them to APP_SPACE
-APP_SPACE_APPS = HillClimbRacing
+APP_SPACE_APPS = HillClimbRacing FridayNightFunkin
# Upsilon, the N0110 and N0115's custom software, gives .nwa apps less RAM: NumPlay-Upsilon.nwa has
# the games that fit it (NumPlay draws their text there: see launcher/src/compat.c)
UPSILON_RAM = 107674
@@ -321,6 +321,7 @@ APP_donkeykong = $(B)/games/donkeykong/donkeykong.nwa:DonkeyKong.nwa
APP_dune = $(B)/games/dune/dune.nwa:Dune.nwa
APP_monkeymart = $(B)/games/monkeymart/monkeymart.nwa:MonkeyMart.nwa
APP_tombofthemask = $(B)/games/tombofthemask/tombofthemask.nwa:TombOfTheMask.nwa
+APP_fnf = games/fnf/output/fnf.nwa:FridayNightFunkin.nwa
# the big games' modules are made from these (the kit)
$(foreach g,$(XL_GAMES),$(eval MOD_$(g) = $$(word 1,$$(subst :, ,$$(APP_$(g))))))
@@ -387,6 +388,13 @@ apps: | $(B)
cp $(word 1,$(subst :, ,$(APP_tombofthemask))) $(B)/apps/$(word 2,$(subst :, ,$(APP_tombofthemask)))
arm-none-eabi-strip --strip-unneeded $(B)/apps/Tetris.nwa
+# Friday Night Funkin' is a standalone large game, outside the launcher and kit.
+apps: $(B)/apps/FridayNightFunkin.nwa
+$(B)/apps/FridayNightFunkin.nwa: FORCE | $(B)
+ $(MAKE) --no-print-directory -C games/fnf build NWLINK="$(NWLINK)" PYTHON="$(PY)"
+ mkdir -p $(B)/apps
+ cp games/fnf/output/fnf.nwa $@
+
STD_APPS = $(foreach g,$(STD_GAMES),$(B)/apps/$(NWA_$(g)))
apps: $(STD_APPS)
$(STD_APPS): $(B)/apps/%.nwa: FORCE | $(B)
@@ -456,5 +464,6 @@ clean:
-$(MAKE) -C games/dune clean
-$(MAKE) -C games/monkeymart clean
-$(MAKE) -C games/tombofthemask clean
+ -$(MAKE) -C games/fnf clean
-cd games/tetris/tetris && $(CARGO) clean
-$(foreach g,$(STD_GAMES),$(MAKE) -C games/$(g) clean;)
diff --git a/README.md b/README.md
index ece2d770..98dc9263 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
29 free games for your NumWorks calculator, in one app.
- Plus 21 big games that install on their own. For the N0110, N0115 and N0120, in English, French and Chinese.
+ Plus 22 big games that install on their own. For the N0110, N0115 and N0120, in English, French and Chinese.
@@ -132,7 +132,7 @@ These are too big to fit next to NumPlay, so each one is its own app. Install it
Super Mario 64
In a repository of its own: NumWorks-Super-Mario-64 |
Super Mario Bros.
All 32 stages, in a repository of its own: NumWorks-Super-Mario-Bros |
- More on the way
Minecraft 1.18.2 and more: see the roadmap |
+ 
Friday Night Funkin'
27 songs, 166 charts, without sound. By Bobydeluxe.
Download |
@@ -302,10 +302,12 @@ Read **[Make your own NumWorks game](docs/make-a-game.md)** to go from there, an
- [ ] More of Retro-Go: Game & Watch, SNES, Mega Drive, SG-1000 and ColecoVision
- [ ] Five Nights at Freddy's 2, 3, 4 and FNAF World
- [ ] Brawl Stars, against bots
-- [ ] Friday Night Funkin'
+- [x] [Friday Night Funkin'](games/fnf/README.md): a silent standalone adaptation, with 27 songs and 166 charts
## Credits
+- **[Friday Night Funkin'](https://github.com/FunkinCrew/Funkin)** by **The Funkin' Crew and the original contributors**: original charts, characters and artwork. Silent native calculator adaptation by **[Bobydeluxe](https://github.com/Bobydeluxe)**, installed separately as **FridayNightFunkin.nwa**. Not affiliated with The Funkin' Crew. Source code and art/assets retain their separate upstream licenses; see [provenance and rights](games/fnf/ASSETS.md).
+
NumPlay is a fan project, made out of love for these games and for the NumWorks calculator. If you enjoy a game here, go play the original and support the people who made it. NumWorks also has a great community of people making games by hand: try [Numcraft](https://github.com/yannis300307/NumcraftRust), [Celeste Classic](https://github.com/BenchatonDev/Celeste-Numworks), [Tatone26's All the Apps](https://github.com/Tatone26/Numworks-games), the apps on [Nwagyu](https://nwagyu.org/guide/) and [yannis300307's list](https://gist.github.com/yannis300307/9123136f90877107ec0d49ba96b303e5).
- **[Tatone26](https://github.com/Tatone26/Numworks-games)**'s **All the Apps** inspired NumPlay's list of classics. Flappy Bird, Pac-Man, Snake, Connect Four, Solitaire and 2048 are written in C for NumPlay and keep its options, with no code copied from it. Tetris is Tatone26's own, which they released into the public domain, adapted for NumPlay.
diff --git a/games/fnf/.gitattributes b/games/fnf/.gitattributes
new file mode 100644
index 00000000..d2a62023
--- /dev/null
+++ b/games/fnf/.gitattributes
@@ -0,0 +1,4 @@
+* text=auto eol=lf
+*.png -text
+*.bin -text
+*.zlib -text
diff --git a/games/fnf/.gitignore b/games/fnf/.gitignore
new file mode 100644
index 00000000..72201efa
--- /dev/null
+++ b/games/fnf/.gitignore
@@ -0,0 +1,5 @@
+output/
+__pycache__/
+*.pyc
+/src/data.c
+/src/ids.h
diff --git a/games/fnf/ASSETS.md b/games/fnf/ASSETS.md
new file mode 100644
index 00000000..a4c5d0a9
--- /dev/null
+++ b/games/fnf/ASSETS.md
@@ -0,0 +1,17 @@
+# Source provenance
+
+| Project | Pinned revision | Use |
+| --- | --- | --- |
+| [FunkinCrew/Funkin](https://github.com/FunkinCrew/Funkin/tree/d05659bbdcf0d83073c900207cf410472afbbede) | `d05659bbdcf0d83073c900207cf410472afbbede` | Timing, note/score rules, original credits and license |
+| [FunkinCrew/Funkin.art](https://github.com/FunkinCrew/Funkin.art/tree/429ab728b19272dca834c83d97b1646455b22579) | `429ab728b19272dca834c83d97b1646455b22579` | Original art project and chart format reference |
+| [FunkinCrew/Funkin.assets](https://github.com/FunkinCrew/Funkin.assets/tree/724eba9de9e76761d9cefd52169926bc51c760a5) | `724eba9de9e76761d9cefd52169926bc51c760a5` | Published game charts, metadata, character/stage configs and compiled artwork |
+
+The game source's asset/art submodule revisions match the user-provided links. Reference downloads were checked against their Git blob hashes and lengths. Music, sound effects, voices and video were neither imported into the game nor embedded in the `.nwa`. No ROM, browser runtime, web page or emulator of the original game is embedded.
+
+`assets/model.json.zlib` preserves the original metadata, events and note arrays for all 61 song variations, plus converted character/stage/UI tables. `assets/chart-manifest.json` identifies the 166 selectable charts and their binary note stream hashes. `tests/test_assets.py` verifies every original time, duration, direction and kind against the compiled streams. `output/asset-report.json` records the exact hashes of the packed build inputs.
+
+`tools/reference_art.py` reads Sparrow XML, packed text atlases and Adobe Animate JSON, including nested symbols, transformations, alpha and clipping masks. `tools/import_reference.py` extracts selected frames, crops transparency, resizes to calculator scale, quantizes to 15 opaque colours and transparency, and deduplicates exact frames. Character offsets are retained relative to their native idle centre and foot position. Stage props are composited into 160×120 cached backgrounds. Desktop shader colour filters and parallax are simplified. The game icon is derived from the original Boyfriend artwork.
+
+Ordinary sprites use independently addressable row RLE with 4-bit palette indices. Stage/menu backgrounds use bounded raw DEFLATE and decode to exactly 9,600 bytes. Notes use delta timestamps and unsigned LEB128, with optional hold duration. No lossy chart simplification is used. The ARM build runs the same score and chart engine as the host tests.
+
+Original license texts are in `LICENSES/Funkin.md`, `LICENSES/funkin.art.md` and `LICENSES/funkin.assets.md`. Nunito's font license is `LICENSES/OFL-1.1-Nunito.txt`. The upstream art and assets are proprietary; their conversion does not remove their copyright or permit public redistribution. The public contribution keeps these license texts and flags this restriction for maintainer review; it does not assert additional redistribution permission.
diff --git a/games/fnf/LICENSES/Funkin.md b/games/fnf/LICENSES/Funkin.md
new file mode 100644
index 00000000..c4d5ba1e
--- /dev/null
+++ b/games/fnf/LICENSES/Funkin.md
@@ -0,0 +1,213 @@
+# Friday Night Funkin'
+
+The Friday Night Funkin' source code is licensed under the Apache 2.0 license: (https://www.apache.org/licenses/LICENSE-2.0)
+
+Friday Night Funkin' Copyright 2020-2024 The Funkin' Crew Inc.
+All Rights Reserved. "Friday Night Funkin'" and the "Friday Night Funkin'" logo are trademarks of The Funkin' Crew Inc.
+
+You can view the `funkin-assets` license here: (https://github.com/FunkinCrew/funkin.assets/blob/main/LICENSE.md)
+
+## Apache 2.0 License
+```
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright 2020-2026 The Funkin' Crew Inc.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+```
diff --git a/games/fnf/LICENSES/OFL-1.1-Nunito.txt b/games/fnf/LICENSES/OFL-1.1-Nunito.txt
new file mode 100644
index 00000000..4950a581
--- /dev/null
+++ b/games/fnf/LICENSES/OFL-1.1-Nunito.txt
@@ -0,0 +1,93 @@
+Copyright 2014 The Nunito Project Authors (https://github.com/googlefonts/nunito)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/games/fnf/LICENSES/funkin.art.md b/games/fnf/LICENSES/funkin.art.md
new file mode 100644
index 00000000..138c4c82
--- /dev/null
+++ b/games/fnf/LICENSES/funkin.art.md
@@ -0,0 +1,9 @@
+"Friday Night Funkin'" and the "Friday Night Funkin'" logo are trademarks of The Funkin' Crew Inc.
+
+Copyright 2020-2026 The Funkin' Crew Inc.
+
+All rights reserved.
+
+This game's Content is proprietary and protected by national and international copyright and trademark laws, and may not be publicly distributed for free or for profit by anyone but the copyright owner. "Content" includes but is not limited to the art, visual assets, audio assets, sound effects, music, and any other creative works.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/games/fnf/LICENSES/funkin.assets.md b/games/fnf/LICENSES/funkin.assets.md
new file mode 100644
index 00000000..138c4c82
--- /dev/null
+++ b/games/fnf/LICENSES/funkin.assets.md
@@ -0,0 +1,9 @@
+"Friday Night Funkin'" and the "Friday Night Funkin'" logo are trademarks of The Funkin' Crew Inc.
+
+Copyright 2020-2026 The Funkin' Crew Inc.
+
+All rights reserved.
+
+This game's Content is proprietary and protected by national and international copyright and trademark laws, and may not be publicly distributed for free or for profit by anyone but the copyright owner. "Content" includes but is not limited to the art, visual assets, audio assets, sound effects, music, and any other creative works.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/games/fnf/Makefile b/games/fnf/Makefile
new file mode 100644
index 00000000..dea84940
--- /dev/null
+++ b/games/fnf/Makefile
@@ -0,0 +1,52 @@
+.DEFAULT_GOAL := build
+CC = arm-none-eabi-gcc
+NWLINK ?= nwlink
+PYTHON ?= python3
+HOST_CC ?= cc
+ARM_LD ?= arm-none-eabi-ld
+OBJCOPY ?= arm-none-eabi-objcopy
+SRC = src/main.c src/game.c src/inflate.c src/save.c src/render.c src/font.c src/data.c
+OBJECTS = $(patsubst src/%.c,output/%.o,$(SRC))
+HEADERS = $(wildcard src/*.h) ../common/epsilon_app.h ../common/epsilon_files.h ../../launcher/src/font.h ../../launcher/src/font_data.c
+PACKER = tools/compact_nwa.py tools/standalone.ld
+ASSET_FILES = assets/model.json.zlib assets/art.json assets/art.bin
+src/data.c: tools/assets.py $(ASSET_FILES)
+ $(PYTHON) tools/assets.py
+src/ids.h: src/data.c
+ @test -f $@ || $(PYTHON) tools/assets.py
+$(OBJECTS): src/data.c src/ids.h
+CFLAGS = -std=c11 $(shell $(NWLINK) eadk-cflags-device) -Os -Wall -Wextra -Werror -Wno-misleading-indentation
+CFLAGS += -DEPSILON_XL=1 -ffunction-sections -fdata-sections -fstack-usage -fno-tree-loop-distribute-patterns
+CFLAGS += -flto -fno-fat-lto-objects -fvisibility=internal
+LINK = -nostartfiles --specs=nano.specs -Wl,--relocatable,--gc-sections,-e,main -flinker-output=nolto-rel
+.PHONY: build check test test-arm test-assets assets clean host
+build: output/fnf.nwa
+output:
+ mkdir -p $@
+output/%.o: src/%.c $(HEADERS) | output
+ $(CC) $(CFLAGS) -c $< -o $@
+output/icon.o: src/icon.png | output
+ $(NWLINK) png-icon-o $< $@
+output/icon-compact.o: output/icon.o $(PACKER)
+ $(PYTHON) tools/compact_nwa.py icon $< $@ --objcopy $(OBJCOPY)
+output/fnf-debug.nwa: $(OBJECTS) output/icon-compact.o $(PACKER)
+ $(CC) $(CFLAGS) $(LINK) -Wl,-u,eadk_app_name,-u,eadk_app_icon,-u,eadk_api_level $(OBJECTS) output/icon-compact.o -lm -o output/standalone.o
+ $(PYTHON) tools/compact_nwa.py app output/standalone.o $@ --ld $(ARM_LD)
+output/fnf.nwa: output/fnf-debug.nwa $(PACKER)
+ $(PYTHON) tools/compact_nwa.py release $< $@ --objcopy $(OBJCOPY)
+check: build
+ $(NWLINK) nwa-bin output/fnf.nwa output/fnf.bin --ram-length 107674
+ $(NWLINK) nwa-bin output/fnf-debug.nwa output/fnf-debug.bin --ram-length 107674
+ $(PYTHON) -c "from pathlib import Path; a=Path('output/fnf.bin').read_bytes(); assert a == Path('output/fnf-debug.bin').read_bytes(); assert len(a)<=2031616"
+host: test
+test: src/data.c src/ids.h | output
+ $(HOST_CC) -std=c11 -O2 -Wall -Wextra -Werror -Wno-misleading-indentation -DFNF_TEST -Isrc tests/test.c src/game.c src/save.c src/render.c src/font.c src/inflate.c src/data.c -lm -o output/test
+ cd output && ./test
+test-arm:
+ $(PYTHON) tests/test_arm.py --nwlink "$(NWLINK)"
+test-assets: src/data.c src/ids.h
+ $(PYTHON) tests/test_assets.py
+assets:
+ $(PYTHON) tools/assets.py
+clean:
+ rm -rf output
diff --git a/games/fnf/NOTICE b/games/fnf/NOTICE
new file mode 100644
index 00000000..df8f6cd1
--- /dev/null
+++ b/games/fnf/NOTICE
@@ -0,0 +1,13 @@
+Friday Night Funkin' calculator adaptation by Bobydeluxe.
+
+Original game: The Funkin' Crew Inc. and the original contributors.
+Original creators include ninjamuffin99, PhantomArcade, evilsk8r and Kawai Sprite.
+PBOT1 scoring and gameplay constants follow the pinned Funkin source (Apache 2.0).
+Copyright and license text: LICENSES/Funkin.md.
+
+Original characters, artwork, charts and trademarks remain with their owners.
+The separate upstream art/assets license restricts public redistribution.
+See LICENSES/funkin.art.md, LICENSES/funkin.assets.md and ASSETS.md.
+
+Nunito font, from the NumPlay launcher: SIL Open Font License 1.1.
+See LICENSES/OFL-1.1-Nunito.txt.
diff --git a/games/fnf/README.md b/games/fnf/README.md
new file mode 100644
index 00000000..c7104191
--- /dev/null
+++ b/games/fnf/README.md
@@ -0,0 +1,64 @@
+# Friday Night Funkin' — calculator adaptation
+
+Native, silent adaptation by **Bobydeluxe** for the NumWorks N0110, N0115 and N0120. Standalone large-game download, outside the NumPlay launcher and customizer kit. English interface.
+
+ 
+
+From the repository root, build it with `make build/data/apps/FridayNightFunkin.nwa` or `python tools/build.py --game fnf`. The release catalogue lists it among the individual big games. This fan adaptation is not affiliated with The Funkin' Crew.
+
+The pinned official content contains **27 songs and 166 playable charts**: Tutorial, Weeks 1–7, Weekend 1 and the LE SSERAFIM collaboration. Freeplay includes the original, Erect/Nightmare, Pico and Boyfriend variations wherever present in those source files. Story Mode runs each week's songs in sequence. All weeks and charts are selectable from the start.
+
+There is **no music, voice, sound effect, encoded silent audio or video** in the installed app. A clock, visual countdown and beat cue drive play. The app ends a song 1.2 seconds after its final charted note/hold or event; an audio file's uncharted tail is not included.
+
+## Controls
+
+| Action | Keys |
+| --- | --- |
+| Left / Down / Up / Right notes | Left / Down / Up / Right arrows **or 7 / 8 / ( / )**, respectively |
+| Chords and holds | Press lanes together; keep the key down for a long note |
+| Select / Confirm | OK or EXE |
+| Pause / Back | Back |
+| Week or song | Up / Down |
+| Difficulty | Left / Right |
+| Freeplay variation | 1 |
+| Credits on title | 0 |
+| Save and leave | Home or Power |
+
+Arrow and number aliases are combined before detecting presses. Pressing both aliases for a lane produces one hit; releasing one while keeping the other pressed preserves the hold. Menus use the arrow keys. Options provide downscroll, ghost tapping (off by default) and beat animation.
+
+## Gameplay and fidelity
+
+The native engine retains **all 90,437 notes from the 166 player charts**, including opponent notes, chords, long notes, note kinds, difficulty, scroll speeds and BPM changes. Time and duration are quantized to 1/16 millisecond (at most 0.03125 ms error each). Notes are read from flash, with a bounded 64-note working queue. The PBOT1 scoring curve, 45/90/135/160 ms judgements, health, combo rules, hold rewards and drop penalties follow the pinned source. The source's two `picospeaker` charts are auxiliary NPC animation tracks, not additional player levels; their original data is retained in the source model but they are not playable chart entries.
+
+This is a C adaptation for a 320×240 calculator, **not the Haxe/Flixel runtime**. Original artwork is reduced to native display sizes and a 15-colour palette per sprite, with up to four selected frames per animation. All 21 referenced stages and 46 character configurations are converted. Stage backgrounds use one composited frame; framing, camera effects, character placement, scripted fights and collaboration lighting are simplified. Complex desktop cinematics, shaders, background actors' choreography, editor, online functions and video are not reproduced. It is not a pixel-for-pixel reproduction of the desktop game.
+
+Saved records contain each chart's best score, best completion and best combo, completed weeks and options. Completion follows the source's `(Sick + Good - Missed) / player notes`, clamped to 0–100%. Best records are updated on a successful clear. A failed run or retry does not erase them.
+
+## Storage and RAM
+
+The final build sizes and hash are written to `output/build-report.json`. Both released and debug packages must produce identical installed bytes and fit the shared **2,031,616-byte flash budget**; compilation/install checks use the smaller **107,674-byte RAM allocation** too.
+
+Artwork and note streams remain in flash. RAM contains one 9,600-byte half-resolution background cache, one 5,120-byte LCD strip, the bounded note/input queues and small game/save state. There is no full framebuffer, dynamic allocation, whole-song note array, decoded atlas or on-device JSON parser. Keyboard transitions are sampled between LCD strips and judged using their wall-clock timestamps, independent of rendering frequency. Pausing freezes the chart clock; retry resets the stream and all per-run state.
+
+The `fnf.sav` record is versioned and CRC checked. An inert Python script `fnf_save.py` carries a comment-only hexadecimal backup so records can be recovered after reinstalling an app; its contents are parsed as data, never executed. Both files use about 4.1 KB including record names. Keep the backup if reinstalling. If storage is full, the app shows Retry / Return to menu / Exit without saving. It preserves unrelated calculator records.
+
+## Build and validation
+
+With ARM GCC, Python 3 (Pillow for importing art), Node and nwlink available:
+
+```sh
+python build.py --arm-bin /path/to/arm/bin --nwlink /path/to/nwlink
+make test HOST_CC=cc
+python tests/test_assets.py
+python tests/test_arm.py --nwlink /path/to/nwlink
+```
+
+The build needs only the checked-in packed inputs and original-art icon. To reimport the large reference assets, use `tools/import_reference.py --reference PATH`; the reference directory must contain the exact pinned repositories under `original/` and their license files. `tools/assets.py` builds deterministic C ROM tables from `assets/model.json.zlib`, `assets/art.json` and `assets/art.bin`. Generated `src/data.c` and `src/ids.h` are ignored build outputs; the Makefile generates them before parallel compilation. `assets/chart-manifest.json` is checked in for review. All three reproduce from the packed inputs.
+
+The artifact is `output/fnf.nwa`, also copied to the workspace's `build/apps/FridayNightFunkin.nwa`. See [VALIDATION.md](VALIDATION.md) for the measured checks and their limits.
+
+## Credits and rights
+
+Original game, characters, charts, logo and art: **The Funkin' Crew and the original contributors**, credited in the pinned projects. Native calculator adaptation: **Bobydeluxe**. The interface uses NumPlay's Nunito font (SIL OFL 1.1).
+
+See [ASSETS.md](ASSETS.md) for source revisions and conversion details. The upstream code is Apache 2.0; the separate art/assets license reserves copyright and explicitly restricts public redistribution. This local build does not grant redistribution rights. Original content is not relicensed under NumPlay's license. The PR records this upstream licensing limitation for maintainer review; no additional art redistribution permission is asserted.
diff --git a/games/fnf/VALIDATION.md b/games/fnf/VALIDATION.md
new file mode 100644
index 00000000..d4160c95
--- /dev/null
+++ b/games/fnf/VALIDATION.md
@@ -0,0 +1,63 @@
+# Validation — 23 October 2026
+
+This is a native, silent calculator adaptation. The chart content is complete for the pinned assets; desktop presentation is adapted as described in README.md. No physical calculator was connected for these checks.
+
+## Build and limits
+
+| Measurement | Result |
+| --- | ---: |
+| Released `.nwa` | 1,840,140 bytes |
+| Installed flash bytes | 1,829,516 bytes |
+| Shared flash limit | 2,031,616 bytes |
+| Static app RAM | 23,396 bytes |
+| Highest measured ARM stack after final input change | 2,608 bytes |
+| Minimum tested installer RAM allocation | 107,674 bytes |
+| Background cache | 9,600 bytes |
+| LCD strip | 5,120 bytes |
+| Game state including records and notes | 2,352 bytes |
+| Save payload | 1,344 bytes |
+
+Release SHA-256: `a3a90cd6895cb820578e9a7a5a71813c8d4d16cacb17244881e839c689ad3a43`.
+
+Both the Python build and `make check` passed the real nwlink conversion with the minimum RAM allocation. Release and debug packages produce **identical installed bytes**. Generated ROM C tables, IDs and the chart manifest reproduce byte for byte from the checked-in packed inputs.
+
+## Chart and engine checks
+
+- 27 songs, 61 variations, 166 selectable charts, 90,437 notes, 21 stage backgrounds and 46 character configurations.
+- Every note's direction, kind, head time and hold duration were compared against the preserved source JSON. Maximum time/duration quantization error: 0.03125 ms.
+- All 166 charts were completed with a host-side input oracle using the actual native engine. Every scoreable player head received Sick; no missed player heads, queue overflow or forced completion. Opponent notes and chart events were processed during these runs.
+- The worst observed working queue was 47 notes. A separate conservative interval sweep, retaining missed holds through their entire duration, bounds it at 49 including the one-note lookahead, below the fixed 64 slots.
+- All 166 charts also fail normally with no input. Random inputs were checked for bounded note count and health; restart resets per-run state.
+- Judgement boundaries, the symmetric/monotonic PBOT1 curve, empty taps, ghost tapping, same-lane key aliases, long-note rewards, early hold release penalties and the 160 ms tail grace were tested.
+- Save round trips, inert backup recovery, rejection of every individual flipped save bit, truncated saves and rejection without changing the existing progress were tested.
+
+## Rendering and input
+
+Native font text has measured pixel bounds; it is not taken from a scaled browser screenshot or a large text atlas. Menu choices, every freeplay song/variation/difficulty, every story group and each referenced stage were rendered through the actual eight-line strip renderer. Screenshots were inspected, including the logo, health HUD, pixel characters and the six-character collaboration scene. Adobe clipping masks were corrected during asset conversion.
+
+A regression test verifies **30 keypad polls per frame even when all 30 LCD strips are unchanged and no LCD push is needed**. Rendering reads a fixed game snapshot; timestamped key transitions are consumed afterward. The chart clock never advances according to frame count.
+
+The final ARM smoke run passed all four memory profiles and rechecks both key layouts after this input fix and the final logo sizing. The 16-note real-key sequences received 16 Sick judgements on every profile; the measured gameplay sampling interval was at most 2 ms in those runs. Ordinary Bopeebo frame work was at most 13 ms on N0120 and 31 ms on the older processor profile. Dense/crowded rendering fixtures reached 16 ms / 41 ms respectively, including a fixture-only background cache switch. These are instruction-driven emulator estimates, not hardware frame-rate guarantees. Exact per-profile measurements are in `output/arm/smoke-report.json`.
+
+The earlier complete Bopeebo run used 51 real player note presses and cleared the song. After the final input and logo adjustments, the complete 166-chart host regression, real-key smoke runs, pause/retry, persistence, full-storage checks, firmware guards and both heavy rendering fixtures passed again. Static RAM plus the highest measured stack use totals **26,004 bytes**.
+
+## ARM / firmware checks
+
+The compiled Cortex-M app ran against Epsilon N0120, Epsilon N0110, the smaller N0115 RAM profile and Upsilon memory layouts. The test drives the real menus and keys. It checks:
+
+- Arrow controls and 7 / 8 / ( / ) controls, including simultaneous aliases for one lane.
+- Song selection, accurate notes, frozen pause clock, resume and retry countdown.
+- Home and Power exits, save/backup round trips and recovery when only the Python backup remains.
+- Full storage: failed-save message, retry, return to menu and explicit unsaved exit; unrelated records remain intact.
+- A held confirm key at launch does not enter a menu accidentally.
+- Firmware RAM guards, clean application RAM on exit and balanced Home locks; Upsilon makes no Epsilon-only system calls.
+
+Host-engine snapshots explicitly exercise the dense 2hot chart and the collaboration's larger visible cast on both processor profiles. These fixtures test rendering, input sampling and safe exits; they are not presented as real-key song completions.
+
+CPU emulation uses 216 million instructions/second for the N0120 profile and 86.4 million for the older processor profile to preserve their relative speed. It does not model LCD transfer cost or every cache/pipeline effect. Physical play testing remains necessary to confirm frame pacing on a particular firmware and calculator.
+
+## Reports and scope
+
+Reproducible commands are in README.md. Reports and screenshots are generated under ignored `output/`: `build-report.json`, `asset-report.json`, `host-report.json`, `autoplay-report.json`, `arm/report.json` and `arm/smoke-report.json`.
+
+This contribution creates a standalone `.nwa`, registers its build and release output, adds a big-game download card and credits, and provides focused CI. It leaves the launcher manifest and all other game directories unchanged. The source art/assets' redistribution restrictions remain in force; see ASSETS.md and the original license texts.
diff --git a/games/fnf/assets/art.bin b/games/fnf/assets/art.bin
new file mode 100644
index 0000000000000000000000000000000000000000..34053e6363d9617469f4e12fda5630d89413a69d
GIT binary patch
literal 1375375
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