About
GBHack is a roguelike dungeon crawler for the Game Boy Color, inspired by NetHack and written in C with GBDK by statico. It is released under the permissive MIT license with the full source on GitHub.
The game adapts NetHack's core loop to a handheld: 15 procedurally generated dungeon levels, permadeath, unidentified items, hunger mechanics, pets, shops and traps — with the Amulet of Yendor as the ultimate goal.
Play GBHack online free — the Game Boy Color core runs in your browser, no download, with save states (a mercy in a permadeath game), gamepad support and touch controls.
Source & project page ↗
How to play GBHack: goal and rules
GBHack is a dungeon-crawling roguelike in the NetHack lineage: descend through 15 procedurally generated dungeon levels, each a random layout of rooms, corridors, doors, traps, fountains, altars and shops; retrieve the Amulet of Yendor at the bottom and climb back to the surface to win. Permadeath is the law — when your character dies, the run is over and a new one begins.
- Movement: the D-pad; hold B plus a direction to step diagonally, eight directions in all.
- Action menu: press A — eat, quaff, read, zap, pick up, drop, wait and save all live here.
- Shortcuts: B picks up the item under you or rests in place; START opens the character sheet; SELECT opens the system menu (sound toggle, help, save and quit).
Your first minute
After Start, the screen loads in about seven seconds (6.8 in our test) into a dark picture — near-black shades measured at 96 percent of the screen, pure dungeon mood. In our test, Enter triggered a large scene change (464 grid cells, over half the screen) and the D-pad steps one tile at a time (one left press moved an 8-cell pixel region). You begin in a room on dungeon level one, and per the author’s README the first three jobs are: feel out the room’s walls with the D-pad — note this is a turn-based game, and walking into a wall changes nothing on screen, which is normal; open the A menu once to see every command; and keep an eye on the floor — B picks up ground items. The game auto-saves every 50 turns, so you can put it down at any time.
What this game is
GBHack is a dungeon-crawling roguelike for the Game Boy Color — procedural dungeons, permadeath, unidentified items, hunger, pets and shops, the whole NetHack core loop in your palm. One line: an entire NetHack packed into a 256 KB cartridge.
Who made it, and when
The author is statico; it was written in 2026 in C with the GBDK toolchain and open-sourced under MIT. The repository says outright that the game was generated with Claude Code — making it a public specimen of AI-assisted handheld development. Technically it manages 16 ROM banks and 4 SRAM banks through an MBC5 mapper, generates dungeons with BSP, computes visibility with shadowcasting, and plays music through hUGEDriver.
What makes it special
NetHack’s depth was ported in earnest: eight monster types with distinct AI behaviors (aggressive, passive, wandering, fleeing…) and six special abilities (poison, paralysis, teleportation, theft, drain, petrification); nine item categories with appearances reshuffled every run; blessed/uncursed/cursed status; bookkeeping shopkeepers; a six-state hunger meter; auto-save every 50 turns; and high-score tracking. For roguelike veterans every one of those nouns is a familiar recipe; for anyone curious how many systems fit in a Game Boy, the open source is the answer.
Who it’s for — and who it isn’t
It’s for NetHack and roguelike fans: permadeath, item identification and hunger management — the old-school tortures are all present; and for programmers studying AI-assisted game development, since the whole process and source are public. It is not for a relaxed session: dying restarts everything and potions reveal themselves by poisoning you, a design philosophy that cures any speedrun mentality.
Frequently Asked Questions
Is GBHack free?
Yes. It’s MIT-licensed open source; this page runs it right in your browser, no download and no account.
Do I need to install an emulator or any software?
No. Emulation happens inside the page: no emulator, no browser extension, no plugin.
Does it work on a phone?
It runs with the built-in touch buttons. D-pad plus A/B/START/SELECT all work on touch; the B-plus-direction diagonals take a little practice.
Can I revive a dead character?
No — permadeath is the roguelike rule. But the game keeps “bones files”: in a later run you may meet your previous character’s remains, gear and all.
How does it relate to NetHack?
It’s an independent work inspired by NetHack: procedural dungeons, unidentified items, pets, shops, hunger and the Amulet of Yendor — the same core loop, scaled to 15 levels for a handheld.