00-Evan/shattered-pixel-dungeon
GamesAn open-source roguelike dungeon crawler for Android, iOS, and desktop with randomized levels and hundreds of items.
What it is
Shattered Pixel Dungeon is a traditional roguelike dungeon crawler with randomized levels, randomized enemies, and hundreds of items to find and use. It is built on the source code of Pixel Dungeon by Watabou and is written in Java with libGDX, shipping for Android, iOS, and desktop platforms (14). The repository holds the full game code rather than an installer wrapper.
It suits players who want a polished open-source mobile and desktop roguelike, and developers who want to read or fork a complete libGDX game codebase.
Play or build
To play, install the official release from one of the listed stores, such as Google Play, the App Store, Steam, GOG, itch.io, or the GitHub releases.
To build from source, pick the platform guide in docs/: Android, desktop, or iOS. Each guide covers the toolchain and build steps for that target; follow the platform-specific instructions rather than a single cross-platform command.
Working with the code
The repository does not accept pull requests. The code is published so others can study and reuse it; bug reports and feature requests are welcome (14). If you plan to publish your own version, read the starter guidance for building on the codebase, including the note about distributing on Google Play (33), and the recommended changes for making your own version.
Constraints
The game is licensed under GPL-3.0, which matters if you redistribute a modified build. Translation work happens on Transifex (31). Platform builds require the respective Android, desktop, or iOS toolchains described in the docs; the README does not claim a single build works everywhere unchanged.
HotRepo's take
The project has a modest daily record: 6,809 stars and 1,743 forks as of 2026-11-16, with 9 stars gained that day and a best Java-language daily rank of 13; no all-language daily rank is recorded. Discussion is more notable than the daily chart. A March 2024 Hacker News thread drew 747 points and 228 comments (3), where commenters described automatic identification of potions and scrolls once their effect is observed (8) and one reader reported that controllers work with the iOS build (11). Those comments are user impressions from that date, not guarantees about current builds. The codebase itself is a long-running libGDX game rather than a thin promotional repo, which is consistent with the sustained interest around it.
Written by AI from the project's README, updated . The project's own docs are the source of truth.