whatisgithub

What is moon-below?

pjperez/moon-below — explained in plain English

Analysis updated 2026-05-18

1CAudience · developerComplexity · 5/5LicenseSetup · hard

In one sentence

Moon Below is a horror adventure game for the Game Boy where a tiny transformer model generates narration on-device, word by word, with no server or internet connection.

Mindmap

mindmap
  root((moon-below))
    What it does
      On-device text generation
      Game Boy horror adventure
      Deterministic world logic
    Tech stack
      C
      GBDK-2020
      Tiny transformer
    Features
      Semantic token masking
      Seeded sampling
      Proof mode
    Related
      DMGFormer runtime

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play a text adventure horror game on real or emulated Game Boy hardware where narration is generated live by an on-cartridge AI model.

USE CASE 2

Study a working example of running a tiny transformer model entirely within Game Boy hardware memory limits.

USE CASE 3

Build the ROM from source and reproduce byte-identical output using the project's verification tooling.

USE CASE 4

Learn how semantic masking and seeded sampling can vary wording while keeping the underlying game state deterministic.

What is it built with?

CGBDK-2020

How does it compare?

pjperez/moon-belowabrown/aomadroxz1122/injected-host-enumeration
Stars111
LanguageCCC
Last pushed2020-03-11
MaintenanceDormant
Setup difficultyhardhardmoderate
Complexity5/55/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Building from source requires the GBDK-2020 4.5.0 toolchain and pinned dependencies documented in reproducibility.md.

Permissive open-source license, free to use, modify, and redistribute, including for commercial purposes.

So what is it?

Moon Below is a horror adventure game built to run entirely on an original Nintendo Game Boy, with no internet connection or outside server involved. What makes it unusual is that the narration text you read during the game is not pre-written. Instead, a tiny language model, a scaled down version of the kind of AI that generates text, runs directly inside the game cartridge and generates the wording word by word as you play. The story itself is fixed: you wake beneath a ruined observatory during an eclipse and must reach the Moon Gate before morning, choosing what happens along the way. The observatory has fourteen locations, ten important objects, three different routes through it, and six different endings, all determined by fixed game logic. A creature called the Warden reacts to noise rather than following a scripted path, so playing quietly or triggering loud machinery changes how it behaves. The technical trick is that the game engine tracks the true state of the world, such as where you are and what has happened, and turns that into a short sequence of tokens the tiny transformer model reads. The model then generates up to ten words, chosen only from words that make sense for the current situation, using a random seed so that the exact wording can differ between playthroughs even when the underlying events are the same. The developer is explicit that this is not simply picking from a table of pre-written sentences, and the game includes a way to inspect the model's internal state during play to prove this. The model itself is extremely small, about 15,840 parameters and a vocabulary of 232 tokens, small enough to fit inside the tight memory limits of Game Boy hardware. The project builds on an earlier related project called DMGFormer, which provides the reusable transformer engine. Building the game from source requires a specific Game Boy development toolchain called GBDK-2020. All of the project's own code, along with the trained model and its assets, is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how Moon Below generates narration text on a Game Boy without an internet connection or server.
Prompt 2
Walk me through building the Moon Below ROM from source using GBDK-2020 and running make verify.
Prompt 3
How does Moon Below prove its narration comes from a real transformer model instead of pre-written sentences?
Prompt 4
Describe how the Warden enemy in Moon Below reacts to player noise instead of following a fixed script.

Frequently asked questions

What is moon-below?

Moon Below is a horror adventure game for the Game Boy where a tiny transformer model generates narration on-device, word by word, with no server or internet connection.

What language is moon-below written in?

Mainly C. The stack also includes C, GBDK-2020.

What license does moon-below use?

Permissive open-source license, free to use, modify, and redistribute, including for commercial purposes.

How hard is moon-below to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is moon-below for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.