explaingit

chrismaltby/gb-studio

9,274TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A drag-and-drop desktop app for Mac, Windows, and Linux that lets you create Game Boy games without writing code, then compiles a real ROM file you can play on original hardware, emulators, or as a web build.

Mindmap

mindmap
  root((repo))
    What It Does
      Create Game Boy games
      No coding needed
      Export to ROM
    Output Formats
      Game Boy ROM
      Web build
      Analogue Pocket ROM
    Tools
      Visual drag-drop editor
      CLI compiler
      Language JSON files
    Use Cases
      Make retro games
      Share online
      Automate builds
    Audience
      Hobbyist game makers
      Retro game fans
      No-code creators
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Design and export a playable Game Boy ROM without writing any C or assembly code using the visual editor.

USE CASE 2

Use the CLI to compile a ROM from a GB Studio project file in an automated build pipeline.

USE CASE 3

Export your game as a web build to share it online without requiring a physical cartridge or emulator download.

USE CASE 4

Translate the GB Studio interface into a new language by editing the JSON language files in the repository.

Tech stack

TypeScriptElectronGBDK

Getting it running

Difficulty · easy Time to first run · 30min
Free to use, modify, and distribute for any purpose including commercial projects, as long as the MIT license notice is kept.

In plain English

GB Studio is a desktop application that lets you create retro-style adventure games for the original Game Boy handheld console without writing code. It is available for Mac, Windows, and Linux. You design your game using a visual editor and the tool compiles everything into a ROM file, which is the format the Game Boy reads. That ROM can be played on original hardware using a cartridge flasher, on a Game Boy emulator, or as a web build you can share online. The application is built on Electron, which is a framework for making desktop apps with web technologies, and under the hood it uses GBDK, a development kit for writing Game Boy games in C. When you publish your game, GB Studio handles all of that compilation work so you do not have to deal with the underlying toolchain yourself. Aside from the graphical editor there is also a command-line interface for users who want to automate parts of the workflow. The CLI can export a project to GBDK source code, compile a Game Boy ROM file, compile a file for the Analogue Pocket handheld, or produce a web build, all from a project file created in the visual editor. The project is open source under the MIT license and has been actively developed since 2019. It has a community on Reddit and Discord, and the author accepts support through Patreon. Documentation lives on the GB Studio website. Translations for the interface into other languages can be contributed by editing JSON language files in the repository. GB Studio is aimed at people who want to make games in the style of classic Game Boy titles without learning the low-level programming those games originally required. The barrier to entry is intentionally low.

Copy-paste prompts

Prompt 1
I want to make a simple top-down adventure game in GB Studio, walk me through setting up scenes, sprites, and player movement without writing code.
Prompt 2
How do I use the GB Studio CLI to compile a ROM file from my project.gbsproj file without opening the desktop app?
Prompt 3
Export my GB Studio game as a web build I can share on itch.io, what are the exact steps?
Prompt 4
How do I add a new language translation to GB Studio by editing the JSON language files in the repo?
Prompt 5
What is the difference between exporting a Game Boy ROM and an Analogue Pocket ROM in GB Studio?
Open on GitHub → Explain another repo

← chrismaltby on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.