# watabou/pixel-dungeon architecture

> Architecture diagram of the GitHub repository watabou/pixel-dungeon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/watabou/pixel-dungeon
- Repository: https://github.com/watabou/pixel-dungeon

## Overview

Pixel Dungeon is a traditional pixel-art roguelike. The player enters a run, explores generated dungeon floors, fights monsters, collects and uses items, and progresses toward the Amulet; the game scene presents that activity and the dungeon state persists between sessions. The graph highlights those stages alongside combat, item, and achievement systems. Evidence is limited to the supplied excerpts, SOURCE INDEX references, and README; several subsystem links are therefore omitted where implementation details were not shown.

Main entry points: [`src/com/watabou/pixeldungeon/Dungeon.java`](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Dungeon.java) (Run State), [`src/com/watabou/pixeldungeon/items/Item.java`](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Item.java) (Inventory Items), [`src/com/watabou/pixeldungeon/scenes/GameScene.java`](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/scenes/GameScene.java) (Game View), [`src/com/watabou/pixeldungeon/levels/Level.java`](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/levels/Level.java) (Dungeon Level)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_run["Run and Progression"]
  node_pixel["Game Entry<br/>[PixelDungeon.java]"]
  node_dungeon["Run State<br/>[Dungeon.java]"]
  node_statistics["Run Statistics<br/>[Statistics.java]"]
  node_save[("Saved Runs")]
end

subgraph group_world["Dungeon World"]
  node_level["Dungeon Level<br/>[Level.java]"]
  node_generation["Floor Generation<br/>[RegularLevel.java]"]
  node_floorstyles["Floor Variants"]
  node_plants["Plants<br/>[Plant.java]"]
  node_visibility["Visibility<br/>[ShadowCaster.java]"]
end

subgraph group_combat["Actors and Combat"]
  node_hero["Hero Actions<br/>[Hero.java]"]
  node_characters["Character Combat<br/>[Char.java]"]
  node_monsters["Monster AI<br/>[Mob.java]"]
  node_buffs["Status Effects<br/>[Buff.java]"]
end

subgraph group_items["Items and Effects"]
  node_items["Inventory Items<br/>[Item.java]"]
  node_heaps["Floor Loot<br/>[Heap.java]"]
  node_generationitems["Item Generation<br/>[Generator.java]"]
  node_equipment["Equipment<br/>[Armor.java]"]
  node_rings["Rings<br/>[Ring.java]"]
  node_wands["Wands<br/>[Wand.java]"]
end

subgraph group_presentation["Interface and Records"]
  node_scene["Game View<br/>[GameScene.java]"]
  node_sprites["Character Sprites<br/>[CharSprite.java]"]
  node_assets["Game Assets<br/>[Assets.java]"]
  node_badges["Achievements<br/>[Badges.java]"]
end

node_player(("Player"))

node_player -.->|"starts game"| node_pixel
node_pixel -.->|"starts run"| node_dungeon
node_dungeon -->|"selects floor"| node_level
node_dungeon -->|"saves progress"| node_save
node_dungeon -.->|"creates floor"| node_generation
node_generation -.->|"uses variants"| node_floorstyles
node_level -->|"casts shadows"| node_visibility
node_level -->|"activates plants"| node_plants
node_player -.->|"issues actions"| node_hero
node_hero -->|"picks up loot"| node_heaps
node_hero -->|"opens trade"| node_scene
node_hero -.->|"uses items"| node_items
node_characters -->|"applies effects"| node_buffs
node_monsters -->|"deals damage"| node_characters
node_level -->|"places loot"| node_heaps
node_generationitems -->|"creates items"| node_items
node_items -.->|"specializes as"| node_equipment
node_items -.->|"specializes as"| node_rings
node_items -.->|"specializes as"| node_wands
node_wands -->|"shows missile"| node_scene
node_scene -->|"reads run state"| node_dungeon
node_scene -.->|"renders characters"| node_sprites
node_scene -.->|"loads resources"| node_assets
node_dungeon -->|"restores statistics"| node_statistics
node_statistics -->|"checks milestones"| node_badges

click node_pixel "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/PixelDungeon.java"
click node_dungeon "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Dungeon.java"
click node_level "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/levels/Level.java"
click node_generation "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/levels/RegularLevel.java"
click node_floorstyles "https://github.com/watabou/pixel-dungeon/tree/master/src/com/watabou/pixeldungeon/levels"
click node_plants "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/plants/Plant.java"
click node_visibility "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/mechanics/ShadowCaster.java"
click node_hero "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/hero/Hero.java"
click node_characters "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/Char.java"
click node_monsters "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/mobs/Mob.java"
click node_buffs "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/buffs/Buff.java"
click node_items "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Item.java"
click node_heaps "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Heap.java"
click node_generationitems "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Generator.java"
click node_equipment "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/armor/Armor.java"
click node_rings "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/rings/Ring.java"
click node_wands "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/wands/Wand.java"
click node_scene "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/scenes/GameScene.java"
click node_sprites "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/sprites/CharSprite.java"
click node_assets "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Assets.java"
click node_statistics "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Statistics.java"
click node_badges "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Badges.java"
click node_save "https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/GamesInProgress.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_pixel,node_dungeon,node_statistics,node_save toneBlue
class node_level,node_generation,node_floorstyles,node_plants,node_visibility toneAmber
class node_hero,node_characters,node_monsters,node_buffs toneMint
class node_items,node_heaps,node_generationitems,node_equipment,node_rings,node_wands toneRose
class node_scene,node_sprites,node_assets,node_badges,node_player toneIndigo
```

## Components

### Run and Progression

- [Game Entry](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/PixelDungeon.java): `src/com/watabou/pixeldungeon/PixelDungeon.java`
- [Run State](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Dungeon.java): `src/com/watabou/pixeldungeon/Dungeon.java`
- [Run Statistics](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Statistics.java): `src/com/watabou/pixeldungeon/Statistics.java`
- [Saved Runs](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/GamesInProgress.java): `src/com/watabou/pixeldungeon/GamesInProgress.java`

### Dungeon World

- [Dungeon Level](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/levels/Level.java): `src/com/watabou/pixeldungeon/levels/Level.java`
- [Floor Generation](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/levels/RegularLevel.java): `src/com/watabou/pixeldungeon/levels/RegularLevel.java`
- [Floor Variants](https://github.com/watabou/pixel-dungeon/tree/master/src/com/watabou/pixeldungeon/levels): `src/com/watabou/pixeldungeon/levels`
- [Plants](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/plants/Plant.java): `src/com/watabou/pixeldungeon/plants/Plant.java`
- [Visibility](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/mechanics/ShadowCaster.java): `src/com/watabou/pixeldungeon/mechanics/ShadowCaster.java`

### Actors and Combat

- [Hero Actions](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/hero/Hero.java): `src/com/watabou/pixeldungeon/actors/hero/Hero.java`
- [Character Combat](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/Char.java): `src/com/watabou/pixeldungeon/actors/Char.java`
- [Monster AI](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/mobs/Mob.java): `src/com/watabou/pixeldungeon/actors/mobs/Mob.java`
- [Status Effects](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/actors/buffs/Buff.java): `src/com/watabou/pixeldungeon/actors/buffs/Buff.java`

### Items and Effects

- [Inventory Items](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Item.java): `src/com/watabou/pixeldungeon/items/Item.java`
- [Floor Loot](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Heap.java): `src/com/watabou/pixeldungeon/items/Heap.java`
- [Item Generation](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/Generator.java): `src/com/watabou/pixeldungeon/items/Generator.java`
- [Equipment](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/armor/Armor.java): `src/com/watabou/pixeldungeon/items/armor/Armor.java`
- [Rings](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/rings/Ring.java): `src/com/watabou/pixeldungeon/items/rings/Ring.java`
- [Wands](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/items/wands/Wand.java): `src/com/watabou/pixeldungeon/items/wands/Wand.java`

### Interface and Records

- [Game View](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/scenes/GameScene.java): `src/com/watabou/pixeldungeon/scenes/GameScene.java`
- [Character Sprites](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/sprites/CharSprite.java): `src/com/watabou/pixeldungeon/sprites/CharSprite.java`
- [Game Assets](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Assets.java): `src/com/watabou/pixeldungeon/Assets.java`
- [Achievements](https://github.com/watabou/pixel-dungeon/blob/master/src/com/watabou/pixeldungeon/Badges.java): `src/com/watabou/pixeldungeon/Badges.java`

### Other components

- **Player**

## Connections

- Player → Game Entry: starts game
- Game Entry → Run State: starts run (evidence: `src/com/watabou/pixeldungeon/Dungeon.java`)
- Run State → Dungeon Level: selects floor (evidence: `src/com/watabou/pixeldungeon/Dungeon.java`)
- Run State → Saved Runs: saves progress (evidence: `src/com/watabou/pixeldungeon/Dungeon.java`)
- Run State → Floor Generation: creates floor
- Floor Generation → Floor Variants: uses variants
- Dungeon Level → Visibility: casts shadows (evidence: `src/com/watabou/pixeldungeon/levels/Level.java`)
- Dungeon Level → Plants: activates plants (evidence: `src/com/watabou/pixeldungeon/levels/Level.java`)
- Player → Hero Actions: issues actions
- Hero Actions → Floor Loot: picks up loot (evidence: `src/com/watabou/pixeldungeon/actors/hero/Hero.java`)
- Hero Actions → Game View: opens trade (evidence: `src/com/watabou/pixeldungeon/actors/hero/Hero.java`)
- Hero Actions → Inventory Items: uses items (evidence: `src/com/watabou/pixeldungeon/actors/hero/Hero.java`)
- Character Combat → Status Effects: applies effects (evidence: `src/com/watabou/pixeldungeon/actors/Char.java`)
- Monster AI → Character Combat: deals damage (evidence: `src/com/watabou/pixeldungeon/actors/mobs/Mob.java`)
- Dungeon Level → Floor Loot: places loot (evidence: `src/com/watabou/pixeldungeon/levels/Level.java`)
- Item Generation → Inventory Items: creates items (evidence: `src/com/watabou/pixeldungeon/items/Generator.java`)
- Inventory Items → Equipment: specializes as (evidence: `src/com/watabou/pixeldungeon/items/Item.java`)
- Inventory Items → Rings: specializes as (evidence: `src/com/watabou/pixeldungeon/items/Item.java`)
- Inventory Items → Wands: specializes as (evidence: `src/com/watabou/pixeldungeon/items/Item.java`)
- Wands → Game View: shows missile (evidence: `src/com/watabou/pixeldungeon/items/wands/Wand.java`)
- Game View → Run State: reads run state (evidence: `src/com/watabou/pixeldungeon/scenes/GameScene.java`)
- Game View → Character Sprites: renders characters (evidence: `src/com/watabou/pixeldungeon/scenes/GameScene.java`)
- Game View → Game Assets: loads resources (evidence: `src/com/watabou/pixeldungeon/scenes/GameScene.java`)
- Run State → Run Statistics: restores statistics (evidence: `src/com/watabou/pixeldungeon/Dungeon.java`)
- Run Statistics → Achievements: checks milestones (evidence: `src/com/watabou/pixeldungeon/Badges.java`)
