# jesusdabest/dreams-shadps4 architecture

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

- Interactive diagram: https://gitdiagram.com/jesusdabest/dreams-shadps4
- Repository: https://github.com/jesusdabest/dreams-shadps4

## Overview

This repository packages Windows shadPS4 builds tuned for Dreams (CUSA04301), with a graphical launcher and optional tutorial-skip utility. The user selects Dreams in the launcher; it starts the bundled emulator with the included fixes and settings. README-described graphics, audio, gameplay, and display fixes are represented as capabilities of the build, not as a verified internal call chain. The tree contains many versioned snapshots; sampled excerpts show launcher process setup but not the emulator’s internal implementation, so their relationships are documented at the product level.

Main entry points: [`builds/cusa04301-graphical-launcher-20261019/DreamsCore.cs`](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-graphical-launcher-20261019/DreamsCore.cs) (Graphical launcher), [`builds/cusa04301-clean-main-20261025/SkipDreamsTutorial.cs`](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-clean-main-20261025/SkipDreamsTutorial.cs) (Tutorial skip tool), [`builds/cusa04301-shadow-fix-20261025/DreamsCore.cs`](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-shadow-fix-20261025/DreamsCore.cs) (Shadow repairs), [`builds/cusa04301-single-mip-write-20261102/DreamsCore.cs`](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-single-mip-write-20261102/DreamsCore.cs) (Texture and sampling fixes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch experience"]
  node_launcher["Graphical launcher<br/>[DreamsCore.cs]"]
  node_emulator["shadPS4 emulator"]
  node_tutorial["Tutorial skip tool"]
end

subgraph group_graphics["Graphics fixes"]
  node_shadow["Shadow repairs<br/>[DreamsCore.cs]"]
  node_texture["Texture and sampling fixes<br/>[DreamsCore.cs]"]
  node_mip["Mip and cache fixes<br/>[DreamsCore.cs]"]
  node_copy["Texture transfer fixes<br/>[DreamsCore.cs]"]
  node_gpu["GPU image writes<br/>[DreamsCore.cs]"]
  node_lifetime["GPU resource lifetime<br/>[DreamsCore.cs]"]
  node_flicker["Flicker repair<br/>[DreamsCore.cs]"]
  node_othercopies["Versioned fix snapshots"]
end

subgraph group_gameplay["Game fixes"]
  node_tren["Tren collision fix<br/>[DreamsCore.cs]"]
end

subgraph group_audio["Audio and display"]
  node_microphone["Microphone recording<br/>[DreamsCore.cs]"]
  node_colour["Display colour fix<br/>[DreamsCore.cs]"]
end

node_user(("Dreams player"))

node_user -->|"selects and plays"| node_launcher
node_launcher -->|"starts process"| node_emulator
node_emulator -->|"includes fixes"| node_shadow
node_emulator -->|"includes fixes"| node_texture
node_emulator -->|"includes fixes"| node_mip
node_emulator -->|"includes fixes"| node_copy
node_emulator -.->|"includes fixes"| node_gpu
node_emulator -.->|"includes fixes"| node_lifetime
node_emulator -.->|"includes fixes"| node_flicker
node_emulator -->|"includes fix"| node_tren
node_emulator -->|"includes fix"| node_microphone
node_emulator -->|"includes fix"| node_colour
node_user -.->|"may use"| node_tutorial

click node_launcher "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-graphical-launcher-20261019/DreamsCore.cs"
click node_tutorial "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-clean-main-20261025/SkipDreamsTutorial.cs"
click node_shadow "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-shadow-fix-20261025/DreamsCore.cs"
click node_texture "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-single-mip-write-20261102/DreamsCore.cs"
click node_mip "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-dynamic-mip-20261028/DreamsCore.cs"
click node_copy "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-compressed-copy-20261029/DreamsCore.cs"
click node_gpu "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-gpu-image-writes-20261031/DreamsCore.cs"
click node_lifetime "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-gpu-resource-lifetime-20261101/DreamsCore.cs"
click node_flicker "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-flicker-repair-20261102/DreamsCore.cs"
click node_tren "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-tren-collision-20261029/DreamsCore.cs"
click node_microphone "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-microphone-encoder-20261031/DreamsCore.cs"
click node_colour "https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-display-colour-20261028/DreamsCore.cs"
click node_othercopies "https://github.com/jesusdabest/dreams-shadps4/tree/main/builds"

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_launcher,node_emulator,node_tutorial toneBlue
class node_shadow,node_texture,node_mip,node_copy,node_gpu,node_lifetime,node_flicker,node_othercopies toneAmber
class node_tren toneMint
class node_microphone,node_colour toneRose
class node_user toneIndigo
```

## Components

### Launch experience

- [Graphical launcher](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-graphical-launcher-20261019/DreamsCore.cs): `builds/cusa04301-graphical-launcher-20261019/DreamsCore.cs`
- **shadPS4 emulator**
- [Tutorial skip tool](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-clean-main-20261025/SkipDreamsTutorial.cs): `builds/cusa04301-clean-main-20261025/SkipDreamsTutorial.cs`

### Graphics fixes

- [Shadow repairs](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-shadow-fix-20261025/DreamsCore.cs): `builds/cusa04301-shadow-fix-20261025/DreamsCore.cs`
- [Texture and sampling fixes](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-single-mip-write-20261102/DreamsCore.cs): `builds/cusa04301-single-mip-write-20261102/DreamsCore.cs`
- [Mip and cache fixes](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-dynamic-mip-20261028/DreamsCore.cs): `builds/cusa04301-dynamic-mip-20261028/DreamsCore.cs`
- [Texture transfer fixes](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-compressed-copy-20261029/DreamsCore.cs): `builds/cusa04301-compressed-copy-20261029/DreamsCore.cs`
- [GPU image writes](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-gpu-image-writes-20261031/DreamsCore.cs): `builds/cusa04301-gpu-image-writes-20261031/DreamsCore.cs`
- [GPU resource lifetime](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-gpu-resource-lifetime-20261101/DreamsCore.cs): `builds/cusa04301-gpu-resource-lifetime-20261101/DreamsCore.cs`
- [Flicker repair](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-flicker-repair-20261102/DreamsCore.cs): `builds/cusa04301-flicker-repair-20261102/DreamsCore.cs`
- [Versioned fix snapshots](https://github.com/jesusdabest/dreams-shadps4/tree/main/builds): `builds`

### Game fixes

- [Tren collision fix](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-tren-collision-20261029/DreamsCore.cs): `builds/cusa04301-tren-collision-20261029/DreamsCore.cs`

### Audio and display

- [Microphone recording](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-microphone-encoder-20261031/DreamsCore.cs): `builds/cusa04301-microphone-encoder-20261031/DreamsCore.cs`
- [Display colour fix](https://github.com/jesusdabest/dreams-shadps4/blob/main/builds/cusa04301-display-colour-20261028/DreamsCore.cs): `builds/cusa04301-display-colour-20261028/DreamsCore.cs`

### Other components

- **Dreams player**

## Connections

- Dreams player → Graphical launcher: selects and plays (evidence: `README.md`)
- Graphical launcher → shadPS4 emulator: starts process (evidence: `builds/cusa04301-graphical-launcher-20261019/DreamsCore.cs`)
- shadPS4 emulator → Shadow repairs: includes fixes (evidence: `README.md`)
- shadPS4 emulator → Texture and sampling fixes: includes fixes (evidence: `README.md`)
- shadPS4 emulator → Mip and cache fixes: includes fixes (evidence: `README.md`)
- shadPS4 emulator → Texture transfer fixes: includes fixes (evidence: `README.md`)
- shadPS4 emulator → GPU image writes: includes fixes
- shadPS4 emulator → GPU resource lifetime: includes fixes
- shadPS4 emulator → Flicker repair: includes fixes
- shadPS4 emulator → Tren collision fix: includes fix (evidence: `README.md`)
- shadPS4 emulator → Microphone recording: includes fix (evidence: `README.md`)
- shadPS4 emulator → Display colour fix: includes fix (evidence: `README.md`)
- Dreams player → Tutorial skip tool: may use (evidence: `README.md`)