# saulbudie1/pisanddag architecture

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

- Interactive diagram: https://gitdiagram.com/saulbudie1/pisanddag
- Repository: https://github.com/saulbudie1/pisanddag

## Overview

PisAndDag is a Terraria/tModLoader content mod that adds custom encounters, combat mechanics, equipment, world content, and presentation systems. The player-facing path is Terraria gameplay through player/combat hooks and encounter or item behavior, then projectiles, effects, and UI. Its world-content branch adds the Vast Ocean and generated structures. The README is empty; relationships below are limited to references in the supplied excerpts and SOURCE INDEX, so unverified dependencies are dashed.

Main entry points: [`Content/Combat`](https://github.com/saulbudie1/pisanddag/tree/master/Content/Combat) (Parry and cinematic), [`Content/NPCs/Foigh/Foigh.cs`](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Foigh/Foigh.cs) (Foigh encounter), [`Content/Particles/PADParticleHandler.cs`](https://github.com/saulbudie1/pisanddag/blob/master/Content/Particles/PADParticleHandler.cs) (Particle effects), [`Content/PADplayer`](https://github.com/saulbudie1/pisanddag/tree/master/Content/PADplayer) (Player systems)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and combat"]
  node_player["Player systems"]
  node_combat["Parry and cinematic"]
  node_mimic["Mimic system<br/>[MimicSystem.cs]"]
  node_mod["Mod bootstrap<br/>[PisAndDag.cs]"]
end

subgraph group_encounters["Boss encounters"]
  node_foigh["Foigh encounter<br/>[Foigh.cs]"]
  node_foighmoves["Foigh moves and rig<br/>[FoighMoves.cs]"]
  node_dona["Dona Quinn encounter<br/>[DonaQuinn.cs]"]
  node_empress["Empress encounter<br/>[EmpressOfLight.cs]"]
  node_empressart["Empress visuals<br/>[EmpressArt.cs]"]
  node_legends["Legends bosses<br/>[LegendsSlimes.cs]"]
end

subgraph group_content["Items and worlds"]
  node_items["Items and weapons"]
  node_projectiles["Projectiles"]
  node_structures["World structures"]
  node_ocean["Vast Ocean world<br/>[VastOcean.cs]"]
  node_biome["Ocean biome<br/>[VastOceanSky.cs]"]
  node_world["World state<br/>[PADWorld.cs]"]
end

subgraph group_presentation["Effects and interface"]
  node_particles["Particle effects"]
  node_particletypes["Particle implementations<br/>[BloomGeneric.cs]"]
  node_ui["Boss interface<br/>[BossPlate.cs]"]
end

node_playeractor(("Player"))

node_playeractor -.->|"uses"| node_player
node_player -->|"spawns"| node_particles
node_player -.->|"supports"| node_combat
node_combat -.->|"queries"| node_mimic
node_combat -.->|"supports"| node_foigh
node_foigh -.->|"uses"| node_foighmoves
node_foigh -.->|"references"| node_dona
node_foigh -.->|"updates"| node_ui
node_empress -.->|"uses"| node_empressart
node_empressart -->|"spawns"| node_particles
node_legends -.->|"uses"| node_combat
node_legends -.->|"spawns"| node_particles
node_items -.->|"fires"| node_projectiles
node_structures -.->|"updates"| node_world
node_ocean -.->|"provides context"| node_biome
node_biome -.->|"reads world state"| node_ocean
node_particles -.->|"draws"| node_particletypes
node_mod -.->|"initializes"| node_world
node_mod -.->|"registers"| node_combat

click node_player "https://github.com/saulbudie1/pisanddag/tree/master/Content/PADplayer"
click node_combat "https://github.com/saulbudie1/pisanddag/tree/master/Content/Combat"
click node_mimic "https://github.com/saulbudie1/pisanddag/blob/master/Content/Mimic/MimicSystem.cs"
click node_mod "https://github.com/saulbudie1/pisanddag/blob/master/PisAndDag.cs"
click node_foigh "https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Foigh/Foigh.cs"
click node_foighmoves "https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Foigh/FoighMoves.cs"
click node_dona "https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/DonaQuinn/DonaQuinn.cs"
click node_empress "https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Empress/EmpressOfLight.cs"
click node_empressart "https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Empress/EmpressArt.cs"
click node_legends "https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Legends/LegendsSlimes.cs"
click node_items "https://github.com/saulbudie1/pisanddag/tree/master/Content/Items"
click node_projectiles "https://github.com/saulbudie1/pisanddag/tree/master/Content/Projectiles"
click node_structures "https://github.com/saulbudie1/pisanddag/tree/master/Content/Structures"
click node_ocean "https://github.com/saulbudie1/pisanddag/blob/master/Content/Subworlds/VastOcean.cs"
click node_biome "https://github.com/saulbudie1/pisanddag/blob/master/Content/Biomes/VastOceanSky.cs"
click node_particles "https://github.com/saulbudie1/pisanddag/blob/master/Content/Particles/PADParticleHandler.cs"
click node_particletypes "https://github.com/saulbudie1/pisanddag/blob/master/Content/Particles/BloomGeneric.cs"
click node_ui "https://github.com/saulbudie1/pisanddag/blob/master/Content/UI/BossPlate.cs"
click node_world "https://github.com/saulbudie1/pisanddag/blob/master/PADWorld.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_player,node_combat,node_mimic,node_mod toneBlue
class node_foigh,node_foighmoves,node_dona,node_empress,node_empressart,node_legends toneAmber
class node_items,node_projectiles,node_structures,node_ocean,node_biome,node_world toneMint
class node_particles,node_particletypes,node_ui toneRose
class node_playeractor toneIndigo
```

## Components

### Runtime and combat

- [Player systems](https://github.com/saulbudie1/pisanddag/tree/master/Content/PADplayer): `Content/PADplayer`
- [Parry and cinematic](https://github.com/saulbudie1/pisanddag/tree/master/Content/Combat): `Content/Combat`
- [Mimic system](https://github.com/saulbudie1/pisanddag/blob/master/Content/Mimic/MimicSystem.cs): `Content/Mimic/MimicSystem.cs`
- [Mod bootstrap](https://github.com/saulbudie1/pisanddag/blob/master/PisAndDag.cs): `PisAndDag.cs`

### Boss encounters

- [Foigh encounter](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Foigh/Foigh.cs): `Content/NPCs/Foigh/Foigh.cs`
- [Foigh moves and rig](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Foigh/FoighMoves.cs): `Content/NPCs/Foigh/FoighMoves.cs`
- [Dona Quinn encounter](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/DonaQuinn/DonaQuinn.cs): `Content/NPCs/DonaQuinn/DonaQuinn.cs`
- [Empress encounter](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Empress/EmpressOfLight.cs): `Content/NPCs/Empress/EmpressOfLight.cs`
- [Empress visuals](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Empress/EmpressArt.cs): `Content/NPCs/Empress/EmpressArt.cs`
- [Legends bosses](https://github.com/saulbudie1/pisanddag/blob/master/Content/NPCs/Legends/LegendsSlimes.cs): `Content/NPCs/Legends/LegendsSlimes.cs`

### Items and worlds

- [Items and weapons](https://github.com/saulbudie1/pisanddag/tree/master/Content/Items): `Content/Items`
- [Projectiles](https://github.com/saulbudie1/pisanddag/tree/master/Content/Projectiles): `Content/Projectiles`
- [World structures](https://github.com/saulbudie1/pisanddag/tree/master/Content/Structures): `Content/Structures`
- [Vast Ocean world](https://github.com/saulbudie1/pisanddag/blob/master/Content/Subworlds/VastOcean.cs): `Content/Subworlds/VastOcean.cs`
- [Ocean biome](https://github.com/saulbudie1/pisanddag/blob/master/Content/Biomes/VastOceanSky.cs): `Content/Biomes/VastOceanSky.cs`
- [World state](https://github.com/saulbudie1/pisanddag/blob/master/PADWorld.cs): `PADWorld.cs`

### Effects and interface

- [Particle effects](https://github.com/saulbudie1/pisanddag/blob/master/Content/Particles/PADParticleHandler.cs): `Content/Particles/PADParticleHandler.cs`
- [Particle implementations](https://github.com/saulbudie1/pisanddag/blob/master/Content/Particles/BloomGeneric.cs): `Content/Particles/BloomGeneric.cs`
- [Boss interface](https://github.com/saulbudie1/pisanddag/blob/master/Content/UI/BossPlate.cs): `Content/UI/BossPlate.cs`

### Other components

- **Player**

## Connections

- Player → Player systems: uses
- Player systems → Particle effects: spawns (evidence: `Content/PADplayer/PisPlayer.cs`)
- Player systems → Parry and cinematic: supports
- Parry and cinematic → Mimic system: queries (evidence: `Content/Combat/Parry.cs`)
- Parry and cinematic → Foigh encounter: supports (evidence: `Content/NPCs/Foigh/Foigh.Fight.cs`)
- Foigh encounter → Foigh moves and rig: uses (evidence: `Content/NPCs/Foigh/Foigh.cs`)
- Foigh encounter → Dona Quinn encounter: references (evidence: `Content/NPCs/Foigh/Foigh.cs`)
- Foigh encounter → Boss interface: updates (evidence: `Content/NPCs/Foigh/Foigh.cs`)
- Empress encounter → Empress visuals: uses (evidence: `Content/NPCs/Empress/EmpressOfLight.cs`)
- Empress visuals → Particle effects: spawns (evidence: `Content/NPCs/Empress/EmpressOfLight.Mirage.cs`)
- Legends bosses → Parry and cinematic: uses (evidence: `Content/NPCs/Legends/LegendsSlimes.cs`)
- Legends bosses → Particle effects: spawns (evidence: `Content/NPCs/Legends/LegendsSlimes.cs`)
- Items and weapons → Projectiles: fires (evidence: `Content/Items/Mage/Incantation/RageSweetFire.cs`)
- World structures → World state: updates (evidence: `Content/Structures/TheWayDown.cs`)
- Vast Ocean world → Ocean biome: provides context (evidence: `Content/Biomes/VastOceanSky.cs`)
- Ocean biome → Vast Ocean world: reads world state (evidence: `Content/Biomes/VastOceanSky.cs`)
- Particle effects → Particle implementations: draws (evidence: `Content/Particles/PADParticleHandler.cs`)
- Mod bootstrap → World state: initializes (evidence: `PisAndDag.cs`)
- Mod bootstrap → Parry and cinematic: registers (evidence: `PisAndDag.cs`)
