# vladislavsaltanov/punchup architecture

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

- Interactive diagram: https://gitdiagram.com/vladislavsaltanov/punchup
- Repository: https://github.com/vladislavsaltanov/punchup

## Overview

PunchUp is a Unity 2D action roguelike: the player ascends a procedurally regenerated tower, fights enemies, gathers and buys gear, and ultimately faces Theseus. The README documents the gameplay stages and capabilities, but no gameplay source excerpts are available, so implementation ownership and most runtime links cannot be verified. Paths below identify only directories or assets present in the tree; dashed links represent documented behavior, not inspected call sites.

Main entry points: [`Assets/PlayerControls.inputactions`](https://github.com/vladislavsaltanov/punchup/blob/main/Assets/PlayerControls.inputactions) (Controls), [`PunchUpFMOD`](https://github.com/vladislavsaltanov/punchup/tree/main/PunchUpFMOD) (FMOD project data), [`Assets/Animations`](https://github.com/vladislavsaltanov/punchup/tree/main/Assets/Animations) (Character animations), [`Music`](https://github.com/vladislavsaltanov/punchup/tree/main/Music) (Soundtracks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_run["Tower run"]
  node_runloop["Run progression"]
  node_tower["Procedural tower"]
  node_sections["Tower sections"]
  node_shop["Floor shop"]
end

subgraph group_combat["Combat and growth"]
  node_enemies["Enemy encounters"]
  node_combatplay["Combat abilities"]
  node_items["Items and rarity"]
  node_difficulty["Scaling difficulty"]
  node_boss["Theseus boss"]
end

subgraph group_presentation["Player experience"]
  node_controls["Controls"]
  node_gameassets["Game visuals"]
  node_animations["Character animations"]
end

subgraph group_audio["Audio"]
  node_music["Soundtracks"]
  node_sounds["Sound effects"]
  node_fmod["FMOD project data"]
end

node_player(("Player"))

node_player -.->|"provides input"| node_controls
node_controls -.->|"controls actions"| node_combatplay
node_player -.->|"starts ascent"| node_runloop
node_runloop -.->|"generates floors"| node_tower
node_tower -.->|"contains sections"| node_sections
node_runloop -.->|"spawns encounters"| node_enemies
node_combatplay -.->|"fights"| node_enemies
node_enemies -.->|"rewards with gear"| node_items
node_items -.->|"changes play style"| node_combatplay
node_runloop -.->|"opens on odd floors"| node_shop
node_shop -.->|"sells gear"| node_items
node_runloop -.->|"raises over time"| node_difficulty
node_difficulty -.->|"strengthens"| node_enemies
node_runloop -.->|"ends at"| node_boss
node_animations -.->|"supports visuals"| node_gameassets
node_music -.->|"audio content"| node_fmod
node_sounds -.->|"audio content"| node_fmod

click node_controls "https://github.com/vladislavsaltanov/punchup/blob/main/Assets/PlayerControls.inputactions"
click node_gameassets "https://github.com/vladislavsaltanov/punchup/tree/main/Assets"
click node_animations "https://github.com/vladislavsaltanov/punchup/tree/main/Assets/Animations"
click node_music "https://github.com/vladislavsaltanov/punchup/tree/main/Music"
click node_sounds "https://github.com/vladislavsaltanov/punchup/tree/main/Sounds"
click node_fmod "https://github.com/vladislavsaltanov/punchup/tree/main/PunchUpFMOD"

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_runloop,node_tower,node_sections,node_shop toneBlue
class node_enemies,node_combatplay,node_items,node_difficulty,node_boss toneAmber
class node_controls,node_gameassets,node_animations toneMint
class node_music,node_sounds,node_fmod toneRose
class node_player toneIndigo
```

## Components

### Tower run

- **Run progression**
- **Procedural tower**
- **Tower sections**
- **Floor shop**

### Combat and growth

- **Enemy encounters**
- **Combat abilities**
- **Items and rarity**
- **Scaling difficulty**
- **Theseus boss**

### Player experience

- [Controls](https://github.com/vladislavsaltanov/punchup/blob/main/Assets/PlayerControls.inputactions): `Assets/PlayerControls.inputactions`
- [Game visuals](https://github.com/vladislavsaltanov/punchup/tree/main/Assets): `Assets`
- [Character animations](https://github.com/vladislavsaltanov/punchup/tree/main/Assets/Animations): `Assets/Animations`

### Audio

- [Soundtracks](https://github.com/vladislavsaltanov/punchup/tree/main/Music): `Music`
- [Sound effects](https://github.com/vladislavsaltanov/punchup/tree/main/Sounds): `Sounds`
- [FMOD project data](https://github.com/vladislavsaltanov/punchup/tree/main/PunchUpFMOD): `PunchUpFMOD`

### Other components

- **Player**

## Connections

- Player → Controls: provides input
- Controls → Combat abilities: controls actions
- Player → Run progression: starts ascent
- Run progression → Procedural tower: generates floors
- Procedural tower → Tower sections: contains sections
- Run progression → Enemy encounters: spawns encounters
- Combat abilities → Enemy encounters: fights
- Enemy encounters → Items and rarity: rewards with gear
- Items and rarity → Combat abilities: changes play style
- Run progression → Floor shop: opens on odd floors
- Floor shop → Items and rarity: sells gear
- Run progression → Scaling difficulty: raises over time
- Scaling difficulty → Enemy encounters: strengthens
- Run progression → Theseus boss: ends at
- Character animations → Game visuals: supports visuals
- Soundtracks → FMOD project data: audio content
- Sound effects → FMOD project data: audio content
