# ivanpnto/fairgroundshooter architecture

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

- Interactive diagram: https://gitdiagram.com/ivanpnto/fairgroundshooter
- Repository: https://github.com/ivanpnto/fairgroundshooter

## Overview

Fairground Shooter is a Unity first-person shooting-gallery game. The documented player journey runs from choosing a profile and equipment, through timed target-shooting levels and inter-level transitions, to scoring, rewards, and shopping before the next round. The README also describes a secret boss level and its combat mechanics. The supplied tree exposes art and audio-generation sources, but not the Unity runtime scripts or scenes, so runtime relationships below are based on README statements; implementation ownership cannot be verified from the excerpts.

Main entry points: [`Assets`](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets) (Shooting levels), [`Assets/Art`](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets/Art) (Game art assets), [`AudioSource/Synth/boss_sfx.py`](https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/boss_sfx.py) (Boss audio synthesis), [`AudioSource/Synth/armory_sfx.py`](https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/armory_sfx.py) (Shop audio synthesis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Game flow"]
  node_menus["Menus and controls"]
  node_round["Round progression"]
  node_levels["Shooting levels"]
  node_targets["Targets and scoring"]
  node_transitions["Level transitions"]
  node_boss["Secret boss fight"]
end

subgraph group_progress["Progression"]
  node_profile["Player profile"]
  node_equipment["Weapons and upgrades"]
  node_results["Results and credits"]
  node_shop["Shop"]
end

subgraph group_assets["Game assets"]
  node_hud["Boss HUD art<br/>[hud_sprites.py]"]
  node_art["Game art assets"]
end

subgraph group_authoring["Asset generators"]
  node_bossaudio["Boss audio synthesis<br/>[boss_sfx.py]"]
  node_armsfx["Shop audio synthesis<br/>[armory_sfx.py]"]
  node_boticasfx["Botica audio synthesis<br/>[botica_sfx.py]"]
  node_transsfx["Transition audio synthesis<br/>[transition_sfx.py]"]
end

node_player(("Player"))

node_player -->|"uses"| node_menus
node_menus -->|"selects"| node_profile
node_menus -->|"chooses"| node_equipment
node_menus -->|"starts"| node_round
node_round -->|"runs"| node_levels
node_player -->|"shoots"| node_targets
node_levels -->|"presents"| node_targets
node_levels -->|"advances through"| node_transitions
node_transitions -->|"starts next"| node_levels
node_levels -->|"ends at"| node_results
node_results -->|"updates credits"| node_profile
node_results -->|"opens"| node_shop
node_shop -->|"saves purchases"| node_profile
node_shop -->|"upgrades"| node_equipment
node_equipment -->|"equips next"| node_round
node_shop -->|"unlocks"| node_boss
node_boss -.->|"uses imagery"| node_hud
node_art -.->|"supplies scenery"| node_levels
node_bossaudio -.->|"generates effects"| node_boss
node_armsfx -.->|"generates effects"| node_shop
node_boticasfx -.->|"generates effects"| node_shop
node_transsfx -.->|"generates effects"| node_transitions

click node_menus "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_equipment "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_round "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_levels "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_targets "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_transitions "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_results "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_shop "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_boss "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets"
click node_hud "https://github.com/ivanpnto/fairgroundshooter/blob/main/ArtSource/UI/hud_sprites.py"
click node_art "https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets/Art"
click node_bossaudio "https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/boss_sfx.py"
click node_armsfx "https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/armory_sfx.py"
click node_boticasfx "https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/botica_sfx.py"
click node_transsfx "https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/transition_sfx.py"

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_menus,node_round,node_levels,node_targets,node_transitions,node_boss toneBlue
class node_profile,node_equipment,node_results,node_shop toneAmber
class node_hud,node_art toneMint
class node_bossaudio,node_armsfx,node_boticasfx,node_transsfx toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Menus and controls](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Round progression](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Shooting levels](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Targets and scoring](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Level transitions](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Secret boss fight](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`

### Progression

- **Player profile**
- [Weapons and upgrades](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Results and credits](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`
- [Shop](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets): `Assets`

### Game assets

- [Boss HUD art](https://github.com/ivanpnto/fairgroundshooter/blob/main/ArtSource/UI/hud_sprites.py): `ArtSource/UI/hud_sprites.py`
- [Game art assets](https://github.com/ivanpnto/fairgroundshooter/tree/main/Assets/Art): `Assets/Art`

### Asset generators

- [Boss audio synthesis](https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/boss_sfx.py): `AudioSource/Synth/boss_sfx.py`
- [Shop audio synthesis](https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/armory_sfx.py): `AudioSource/Synth/armory_sfx.py`
- [Botica audio synthesis](https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/botica_sfx.py): `AudioSource/Synth/botica_sfx.py`
- [Transition audio synthesis](https://github.com/ivanpnto/fairgroundshooter/blob/main/AudioSource/Synth/transition_sfx.py): `AudioSource/Synth/transition_sfx.py`

### Other components

- **Player**

## Connections

- Player → Menus and controls: uses
- Menus and controls → Player profile: selects
- Menus and controls → Weapons and upgrades: chooses
- Menus and controls → Round progression: starts
- Round progression → Shooting levels: runs
- Player → Targets and scoring: shoots
- Shooting levels → Targets and scoring: presents
- Shooting levels → Level transitions: advances through
- Level transitions → Shooting levels: starts next
- Shooting levels → Results and credits: ends at
- Results and credits → Player profile: updates credits
- Results and credits → Shop: opens
- Shop → Player profile: saves purchases
- Shop → Weapons and upgrades: upgrades
- Weapons and upgrades → Round progression: equips next
- Shop → Secret boss fight: unlocks
- Secret boss fight → Boss HUD art: uses imagery
- Game art assets → Shooting levels: supplies scenery
- Boss audio synthesis → Secret boss fight: generates effects
- Shop audio synthesis → Shop: generates effects
- Botica audio synthesis → Shop: generates effects
- Transition audio synthesis → Level transitions: generates effects
