# xhummingbird/ace-sts2-mod architecture

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

- Interactive diagram: https://gitdiagram.com/xhummingbird/ace-sts2-mod
- Repository: https://github.com/xhummingbird/ace-sts2-mod

## Overview

Ace is a Slay the Spire 2 mod that adds a playable character built around colored card stock and Flip effects. In play, a player uses Ace cards; stock state tracks colors, and Flip mechanics consume stock to select and autoplay a corresponding Flip card. The mod also supplies character progression content, powers, relics, potions, and custom combat presentation. The graph follows documented and indexed references; unsampled subsystems are represented by their exact directories, and unverified links are omitted.

Main entry points: [`AceCode/Character/Ace.cs`](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Character/Ace.cs) (Ace Character), [`AceCode/Cards`](https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Cards) (Card Families), [`AceCode/Mechanics/Stock.cs`](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Stock.cs) (Stock State), [`AceCode/Mechanics/Flip.cs`](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Flip.cs) (Flip Resolution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Mod Runtime"]
  node_mod_init["Mod Initialization<br/>[MainFile.cs]"]
end

subgraph group_character["Character Content"]
  node_ace_character["Ace Character<br/>[Ace.cs]"]
  node_card_pool["Card Pool<br/>[AceCardPool.cs]"]
  node_character_pools["Progression Pools"]
  node_card_families["Card Families"]
  node_flip_cards["Flip Cards"]
  node_powers["Character Powers"]
  node_relics["Character Relics"]
  node_potions["Character Potion<br/>[AcePotion.cs]"]
end

subgraph group_mechanics["Combat Mechanics"]
  node_stock[("Stock State<br/>[Stock.cs]")]
  node_stock_model["Stock Combat Hooks<br/>[AceStockModel.cs]"]
  node_consume["Stock Consumption<br/>[Consume.cs]"]
  node_flip["Flip Resolution<br/>[Flip.cs]"]
  node_relic_triggers["Relic Triggers"]
end

subgraph group_presentation["Combat Presentation"]
  node_card_overlay["Card Display Overlay"]
  node_audio["Audio Helpers<br/>[AudioHelper.cs]"]
  node_extensions["Character Extensions<br/>[AceExtensions.cs]"]
  node_cinematic["Card Cinematic"]
end

node_player(("Player"))
node_game["Slay the Spire 2"]

node_game -->|"loads mod"| node_mod_init
node_mod_init -->|"registers save state"| node_stock
node_mod_init -->|"patches assembly"| node_ace_character
node_player -.->|"plays as"| node_ace_character
node_ace_character -->|"uses pool"| node_card_pool
node_ace_character -->|"uses pools"| node_character_pools
node_ace_character -->|"registers starter cards"| node_card_families
node_card_families -->|"declares pool"| node_card_pool
node_card_families -->|"defines stock colors"| node_stock
node_card_families -->|"invokes Flip"| node_flip
node_flip_cards -->|"selected for autoplay"| node_flip
node_flip -->|"consumes stock"| node_consume
node_flip -->|"reads majority color"| node_stock
node_flip -->|"autoplays card"| node_game
node_stock_model -.->|"updates stock"| node_stock
node_stock -->|"provides display state"| node_card_overlay
node_ace_character -.->|"character powers"| node_powers
node_ace_character -->|"uses relic pool"| node_relics
node_ace_character -->|"uses potion pool"| node_potions
node_ace_character -->|"plays character audio"| node_audio
node_card_families -->|"plays card audio"| node_audio
node_card_families -->|"starts card cinematic"| node_cinematic
node_card_families -->|"uses combat helpers"| node_extensions
node_relics -->|"reads stock"| node_stock
node_relic_triggers -.->|"stock interaction"| node_stock

click node_mod_init "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/MainFile.cs"
click node_ace_character "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Character/Ace.cs"
click node_card_pool "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Character/AceCardPool.cs"
click node_character_pools "https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Character"
click node_card_families "https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Cards"
click node_flip_cards "https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Cards/Flip"
click node_powers "https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Powers"
click node_relics "https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Relics"
click node_potions "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Potions/AcePotion.cs"
click node_stock "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Stock.cs"
click node_stock_model "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/AceStockModel.cs"
click node_consume "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Consume.cs"
click node_flip "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Flip.cs"
click node_relic_triggers "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/AceRelicTriggers.cs"
click node_card_overlay "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/CardDisplayOverlay.cs"
click node_audio "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Extensions/AudioHelper.cs"
click node_extensions "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Extensions/AceExtensions.cs"
click node_cinematic "https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Extensions/CenterCardCinematic.cs"

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_mod_init toneBlue
class node_ace_character,node_card_pool,node_character_pools,node_card_families,node_flip_cards,node_powers,node_relics,node_potions toneAmber
class node_stock,node_stock_model,node_consume,node_flip,node_relic_triggers toneMint
class node_card_overlay,node_audio,node_extensions,node_cinematic toneRose
class node_player,node_game toneIndigo
```

## Components

### Mod Runtime

- [Mod Initialization](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/MainFile.cs): `AceCode/MainFile.cs`

### Character Content

- [Ace Character](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Character/Ace.cs): `AceCode/Character/Ace.cs`
- [Card Pool](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Character/AceCardPool.cs): `AceCode/Character/AceCardPool.cs`
- [Progression Pools](https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Character): `AceCode/Character`
- [Card Families](https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Cards): `AceCode/Cards`
- [Flip Cards](https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Cards/Flip): `AceCode/Cards/Flip`
- [Character Powers](https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Powers): `AceCode/Powers`
- [Character Relics](https://github.com/xhummingbird/ace-sts2-mod/tree/main/AceCode/Relics): `AceCode/Relics`
- [Character Potion](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Potions/AcePotion.cs): `AceCode/Potions/AcePotion.cs`

### Combat Mechanics

- [Stock State](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Stock.cs): `AceCode/Mechanics/Stock.cs`
- [Stock Combat Hooks](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/AceStockModel.cs): `AceCode/Mechanics/AceStockModel.cs`
- [Stock Consumption](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Consume.cs): `AceCode/Mechanics/Consume.cs`
- [Flip Resolution](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/Flip.cs): `AceCode/Mechanics/Flip.cs`
- [Relic Triggers](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/AceRelicTriggers.cs): `AceCode/Mechanics/AceRelicTriggers.cs`

### Combat Presentation

- [Card Display Overlay](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Mechanics/CardDisplayOverlay.cs): `AceCode/Mechanics/CardDisplayOverlay.cs`
- [Audio Helpers](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Extensions/AudioHelper.cs): `AceCode/Extensions/AudioHelper.cs`
- [Character Extensions](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Extensions/AceExtensions.cs): `AceCode/Extensions/AceExtensions.cs`
- [Card Cinematic](https://github.com/xhummingbird/ace-sts2-mod/blob/main/AceCode/Extensions/CenterCardCinematic.cs): `AceCode/Extensions/CenterCardCinematic.cs`

### Other components

- **Player**
- **Slay the Spire 2**

## Connections

- Slay the Spire 2 → Mod Initialization: loads mod (evidence: `AceCode/MainFile.cs`)
- Mod Initialization → Stock State: registers save state (evidence: `AceCode/MainFile.cs`)
- Mod Initialization → Ace Character: patches assembly (evidence: `AceCode/MainFile.cs`)
- Player → Ace Character: plays as
- Ace Character → Card Pool: uses pool (evidence: `AceCode/Character/Ace.cs`)
- Ace Character → Progression Pools: uses pools (evidence: `AceCode/Character/Ace.cs`)
- Ace Character → Card Families: registers starter cards (evidence: `AceCode/Character/Ace.cs`)
- Card Families → Card Pool: declares pool (evidence: `AceCode/Cards/AceBlueCard.cs`)
- Card Families → Stock State: defines stock colors (evidence: `AceCode/Cards/AceBlueCard.cs`)
- Card Families → Flip Resolution: invokes Flip (evidence: `AceCode/Cards/Rare/FiragaRf.cs`)
- Flip Cards → Flip Resolution: selected for autoplay (evidence: `AceCode/Mechanics/Flip.cs`)
- Flip Resolution → Stock Consumption: consumes stock (evidence: `AceCode/Mechanics/Flip.cs`)
- Flip Resolution → Stock State: reads majority color (evidence: `AceCode/Mechanics/Flip.cs`)
- Flip Resolution → Slay the Spire 2: autoplays card (evidence: `AceCode/Mechanics/Flip.cs`)
- Stock Combat Hooks → Stock State: updates stock
- Stock State → Card Display Overlay: provides display state (evidence: `AceCode/Mechanics/CardDisplayOverlay.cs`)
- Ace Character → Character Powers: character powers (evidence: `AceCode/Powers/BreaksightPower.cs`)
- Ace Character → Character Relics: uses relic pool (evidence: `AceCode/Character/Ace.cs`)
- Ace Character → Character Potion: uses potion pool (evidence: `AceCode/Character/Ace.cs`)
- Ace Character → Audio Helpers: plays character audio (evidence: `AceCode/Character/Ace.cs`)
- Card Families → Audio Helpers: plays card audio (evidence: `AceCode/Cards/Rare/FiragaRf.cs`)
- Card Families → Card Cinematic: starts card cinematic (evidence: `AceCode/Cards/Ancient/JackpotShot.cs`)
- Card Families → Character Extensions: uses combat helpers (evidence: `AceCode/Cards/Ancient/JackpotShot.cs`)
- Character Relics → Stock State: reads stock (evidence: `AceCode/Relics/DraconicDeck.cs`)
- Relic Triggers → Stock State: stock interaction
