# kiraacorsac/goldencookieobserver architecture

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

- Interactive diagram: https://gitdiagram.com/kiraacorsac/goldencookieobserver
- Repository: https://github.com/kiraacorsac/goldencookieobserver

## Overview

GoldenCookieObserver is a small Cookie Clicker addon: the user loads the script, which checks the game version and installs a hook on golden-cookie spawns; the hook beeps through Web Audio. The beta file contains a parallel implementation with different volume handling. The excerpts show both implementations, but do not establish how the beta is distributed or loaded, so its connection to the documented loading workflow is omitted.

Main entry points: [`GoldenCookieObserver.js`](https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserver.js) (Observer addon), [`GoldenCookieObserverBeta.js`](https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserverBeta.js) (Beta addon)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_game["Cookie Clicker"]
node_main["Observer addon"]
node_main_beep["Beep generator"]
node_beta["Beta addon"]
node_beta_beep["Beta beep generator"]
node_audio["Web Audio"]

node_user -->|"loads via Game.LoadMod"| node_main
node_main -->|"installs spawn hook"| node_game
node_game -->|"sets spawn count"| node_main
node_main -->|"calls on spawn"| node_main_beep
node_main_beep -->|"generates tone"| node_audio
node_beta -->|"installs spawn hook"| node_game
node_game -->|"sets spawn count"| node_beta
node_beta -->|"calls on spawn"| node_beta_beep
node_beta_beep -->|"generates tone"| node_audio

click node_main "https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserver.js"
click node_main_beep "https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserver.js"
click node_beta "https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserverBeta.js"
click node_beta_beep "https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserverBeta.js"

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_user toneBlue
class node_game,node_audio toneIndigo
class node_main toneMint
class node_main_beep,node_beta,node_beta_beep toneTeal
```

## Components

### Other components

- **User**
- **Cookie Clicker**
- [Observer addon](https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserver.js): `GoldenCookieObserver.js`
- [Beep generator](https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserver.js): `GoldenCookieObserver.js`
- [Beta addon](https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserverBeta.js): `GoldenCookieObserverBeta.js`
- [Beta beep generator](https://github.com/kiraacorsac/goldencookieobserver/blob/master/GoldenCookieObserverBeta.js): `GoldenCookieObserverBeta.js`
- **Web Audio**

## Connections

- User → Observer addon: loads via Game.LoadMod (evidence: `README.md`)
- Observer addon → Cookie Clicker: installs spawn hook (evidence: `GoldenCookieObserver.js`)
- Cookie Clicker → Observer addon: sets spawn count (evidence: `GoldenCookieObserver.js`)
- Observer addon → Beep generator: calls on spawn (evidence: `GoldenCookieObserver.js`)
- Beep generator → Web Audio: generates tone (evidence: `GoldenCookieObserver.js`)
- Beta addon → Cookie Clicker: installs spawn hook (evidence: `GoldenCookieObserverBeta.js`)
- Cookie Clicker → Beta addon: sets spawn count (evidence: `GoldenCookieObserverBeta.js`)
- Beta addon → Beta beep generator: calls on spawn (evidence: `GoldenCookieObserverBeta.js`)
- Beta beep generator → Web Audio: generates tone (evidence: `GoldenCookieObserverBeta.js`)
