A roguelike dungeon crawler that lives entirely in a GitHub profile README. No JavaScript, no downloads. Just HTML links and server-rendered pixel art.

Play it here: github.com/pgagnidze

How it works

The game runs on a Lua server that renders the dungeon as a PNG image. Each control (move, attack, pickup) is a plain HTML link that hits the server, updates the game state, and redirects back to the page. The image refreshes to show the new state.

It is one shared game for everyone. If someone moves on GitHub, you see it here too.

Features

• Procedurally generated dungeon floors
• Fog of war with shadowcast FOV
• Turn-based grid movement (8 directions + wait)
• Permadeath
• 5 monster types scaling with depth
• Items: potions, weapons, shields
• Descending floors with increasing difficulty

Play on this page

@ player r rat s snake k skeleton g ghost D dragon ! potion / weapon ] shield > stairs

Tech

Written in Lua, powered by mote (a Lua HTTP server). The dungeon, pixel-art glyphs, and PNG encoding are all done server-side with no external dependencies.

Source code: github.com/pgagnidze/pgagnidze