# smithmediaindustriesinc-code/minescore architecture

> Architecture diagram of the GitHub repository smithmediaindustriesinc-code/minescore, 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/smithmediaindustriesinc-code/minescore
- Repository: https://github.com/smithmediaindustriesinc-code/minescore

## Overview

MineScore is a Forge mod for creating, storing, editing, and playing music in Minecraft. The main listening path is a song or score supplied to a playback source, routed through a wired audio system, and rendered by the client; the lathe also cuts music onto records. The graph preserves the separate MP3, score-editor, effects, storage, power, and configuration capabilities documented in the README. Source excerpts establish only selected calls; README-backed relationships are cited there, and unsampled internals are not inferred.

Main entry points: [`common/src/main/java/com/minescore/playback/PlaybackManager.java`](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/playback/PlaybackManager.java) (Playback Manager), [`common/src/main/java/com/minescore/block/LatheCore.java`](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/LatheCore.java) (Record Cutting), [`common/src/main/java/com/minescore/MineScore.java`](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/MineScore.java) (Mod Bootstrap), [`common/src/main/java/com/minescore/mp3/Mp3Server.java`](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/mp3/Mp3Server.java) (MP3 Player)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Mod Runtime"]
  node_mod["Mod Bootstrap<br/>[MineScore.java]"]
  node_forge["Forge Adapter"]
  node_network["Packet Routing"]
end

subgraph group_music["Music Sources"]
  node_songfiles["Song Files<br/>[SongFiles.java]"]
  node_lathe["Record Cutting<br/>[LatheCore.java]"]
  node_vinyl["Vinyl Playback"]
  node_mp3["MP3 Player<br/>[Mp3Server.java]"]
  node_transfers["Song Transfers<br/>[SongTransfers.java]"]
  node_cabinet[("Music Cabinet")]
  node_display["Vinyl Display"]
end

subgraph group_audio["Audio System"]
  node_effects["Effects Unit<br/>[EffectChain.java]"]
  node_wiring["Cable Network<br/>[WireNetwork.java]"]
  node_speakers["Speaker System"]
  node_playback["Playback Manager"]
  node_clientaudio["Client Audio Engine<br/>[AudioEngine.java]"]
  node_power["Power System<br/>[SystemPower.java]"]
end

subgraph group_scores["Score Editing"]
  node_score["Score Model<br/>[Score.java]"]
  node_scoreeditor["Score Editor<br/>[ScoreEditor.java]"]
  node_scoreio["Score Import Export<br/>[ScoreImport.java]"]
  node_scoresessions["Collaborative Sessions<br/>[ScoreSessions.java]"]
end

subgraph group_state["State and Settings"]
  node_songstore[("Song Store<br/>[SongStore.java]")]
  node_scorestore[("Score Store<br/>[ScoreStore.java]")]
  node_config["Mod Settings"]
end

node_player(("Player"))

node_forge -->|"initializes"| node_mod
node_mod -->|"registers"| node_network
node_player -->|"supplies music"| node_songfiles
node_songfiles -.->|"selects tracks"| node_lathe
node_lathe -->|"cuts records"| node_vinyl
node_player -->|"loads songs"| node_mp3
node_mp3 -.->|"exchanges songs"| node_transfers
node_transfers -.->|"stores tracks"| node_songstore
node_player -->|"edits music"| node_scoreeditor
node_scoreeditor -->|"edits score"| node_score
node_scoreeditor -.->|"sends edits"| node_network
node_network -->|"dispatches edits"| node_scoresessions
node_scoresessions -->|"saves scores"| node_scorestore
node_scoreio -->|"imports exports"| node_score
node_score -->|"presses records"| node_lathe
node_player -->|"configures effects"| node_effects
node_effects -->|"cuts into record"| node_lathe
node_vinyl -.->|"starts playback"| node_playback
node_mp3 -->|"starts playback"| node_playback
node_lathe -.->|"provides source"| node_playback
node_playback -->|"queries routes"| node_wiring
node_playback -->|"resolves speakers"| node_speakers
node_wiring -->|"routes cables"| node_speakers
node_playback -->|"allocates power"| node_power
node_playback -->|"sends playback state"| node_clientaudio
node_clientaudio -->|"renders sound"| node_player
node_player -->|"stores records"| node_cabinet
node_player -->|"displays record"| node_display
node_mod -->|"loads settings"| node_config
node_config -.->|"configures behavior"| node_playback

click node_mod "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/MineScore.java"
click node_forge "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/forge/src/main/java/com/minescore/forge/MineScoreForge.java"
click node_network "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/network/MineScoreNetwork.java"
click node_songfiles "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/client/audio/SongFiles.java"
click node_lathe "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/LatheCore.java"
click node_vinyl "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/VinylPlayerBlockEntity.java"
click node_mp3 "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/mp3/Mp3Server.java"
click node_transfers "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/song/SongTransfers.java"
click node_songstore "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/song/SongStore.java"
click node_score "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/Score.java"
click node_scoreeditor "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/client/score/ScoreEditor.java"
click node_scoreio "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/ScoreImport.java"
click node_scoresessions "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/ScoreSessions.java"
click node_scorestore "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/ScoreStore.java"
click node_effects "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/meu/EffectChain.java"
click node_wiring "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/wiring/WireNetwork.java"
click node_speakers "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/wiring/SpeakerSystems.java"
click node_playback "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/playback/PlaybackManager.java"
click node_clientaudio "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/client/audio/AudioEngine.java"
click node_config "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/config/MineScoreConfig.java"
click node_cabinet "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/MusicCabinetBlockEntity.java"
click node_display "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/VinylDisplayBlockEntity.java"
click node_power "https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/power/SystemPower.java"

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,node_forge,node_network toneBlue
class node_songfiles,node_lathe,node_vinyl,node_mp3,node_transfers,node_cabinet,node_display toneAmber
class node_effects,node_wiring,node_speakers,node_playback,node_clientaudio,node_power toneMint
class node_score,node_scoreeditor,node_scoreio,node_scoresessions toneRose
class node_songstore,node_scorestore,node_config,node_player toneIndigo
```

## Components

### Mod Runtime

- [Mod Bootstrap](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/MineScore.java): `common/src/main/java/com/minescore/MineScore.java`
- [Forge Adapter](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/forge/src/main/java/com/minescore/forge/MineScoreForge.java): `forge/src/main/java/com/minescore/forge/MineScoreForge.java`
- [Packet Routing](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/network/MineScoreNetwork.java): `common/src/main/java/com/minescore/network/MineScoreNetwork.java`

### Music Sources

- [Song Files](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/client/audio/SongFiles.java): `common/src/main/java/com/minescore/client/audio/SongFiles.java`
- [Record Cutting](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/LatheCore.java): `common/src/main/java/com/minescore/block/LatheCore.java`
- [Vinyl Playback](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/VinylPlayerBlockEntity.java): `common/src/main/java/com/minescore/block/VinylPlayerBlockEntity.java`
- [MP3 Player](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/mp3/Mp3Server.java): `common/src/main/java/com/minescore/mp3/Mp3Server.java`
- [Song Transfers](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/song/SongTransfers.java): `common/src/main/java/com/minescore/song/SongTransfers.java`
- [Music Cabinet](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/MusicCabinetBlockEntity.java): `common/src/main/java/com/minescore/block/MusicCabinetBlockEntity.java`
- [Vinyl Display](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/block/VinylDisplayBlockEntity.java): `common/src/main/java/com/minescore/block/VinylDisplayBlockEntity.java`

### Audio System

- [Effects Unit](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/meu/EffectChain.java): `common/src/main/java/com/minescore/meu/EffectChain.java`
- [Cable Network](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/wiring/WireNetwork.java): `common/src/main/java/com/minescore/wiring/WireNetwork.java`
- [Speaker System](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/wiring/SpeakerSystems.java): `common/src/main/java/com/minescore/wiring/SpeakerSystems.java`
- [Playback Manager](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/playback/PlaybackManager.java): `common/src/main/java/com/minescore/playback/PlaybackManager.java`
- [Client Audio Engine](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/client/audio/AudioEngine.java): `common/src/main/java/com/minescore/client/audio/AudioEngine.java`
- [Power System](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/power/SystemPower.java): `common/src/main/java/com/minescore/power/SystemPower.java`

### Score Editing

- [Score Model](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/Score.java): `common/src/main/java/com/minescore/score/Score.java`
- [Score Editor](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/client/score/ScoreEditor.java): `common/src/main/java/com/minescore/client/score/ScoreEditor.java`
- [Score Import Export](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/ScoreImport.java): `common/src/main/java/com/minescore/score/ScoreImport.java`
- [Collaborative Sessions](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/ScoreSessions.java): `common/src/main/java/com/minescore/score/ScoreSessions.java`

### State and Settings

- [Song Store](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/song/SongStore.java): `common/src/main/java/com/minescore/song/SongStore.java`
- [Score Store](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/score/ScoreStore.java): `common/src/main/java/com/minescore/score/ScoreStore.java`
- [Mod Settings](https://github.com/smithmediaindustriesinc-code/minescore/blob/main/common/src/main/java/com/minescore/config/MineScoreConfig.java): `common/src/main/java/com/minescore/config/MineScoreConfig.java`

### Other components

- **Player**

## Connections

- Forge Adapter → Mod Bootstrap: initializes (evidence: `forge/src/main/java/com/minescore/forge/MineScoreForge.java`)
- Mod Bootstrap → Packet Routing: registers (evidence: `common/src/main/java/com/minescore/MineScore.java`)
- Player → Song Files: supplies music
- Song Files → Record Cutting: selects tracks
- Record Cutting → Vinyl Playback: cuts records
- Player → MP3 Player: loads songs
- MP3 Player → Song Transfers: exchanges songs
- Song Transfers → Song Store: stores tracks
- Player → Score Editor: edits music
- Score Editor → Score Model: edits score (evidence: `common/src/main/java/com/minescore/client/score/ClientScores.java`)
- Score Editor → Packet Routing: sends edits
- Packet Routing → Collaborative Sessions: dispatches edits (evidence: `common/src/main/java/com/minescore/network/MineScoreNetwork.java`)
- Collaborative Sessions → Score Store: saves scores (evidence: `common/src/main/java/com/minescore/score/ScoreSessions.java`)
- Score Import Export → Score Model: imports exports
- Score Model → Record Cutting: presses records
- Player → Effects Unit: configures effects
- Effects Unit → Record Cutting: cuts into record
- Vinyl Playback → Playback Manager: starts playback (evidence: `common/src/main/java/com/minescore/playback/PlaybackManager.java`)
- MP3 Player → Playback Manager: starts playback
- Record Cutting → Playback Manager: provides source
- Playback Manager → Cable Network: queries routes (evidence: `common/src/main/java/com/minescore/playback/PlaybackManager.java`)
- Playback Manager → Speaker System: resolves speakers (evidence: `common/src/main/java/com/minescore/playback/PlaybackManager.java`)
- Cable Network → Speaker System: routes cables (evidence: `common/src/main/java/com/minescore/playback/PlaybackManager.java`)
- Playback Manager → Power System: allocates power (evidence: `common/src/main/java/com/minescore/playback/PlaybackManager.java`)
- Playback Manager → Client Audio Engine: sends playback state (evidence: `common/src/main/java/com/minescore/client/audio/AudioEngine.java`)
- Client Audio Engine → Player: renders sound
- Player → Music Cabinet: stores records
- Player → Vinyl Display: displays record
- Mod Bootstrap → Mod Settings: loads settings (evidence: `common/src/main/java/com/minescore/MineScore.java`)
- Mod Settings → Playback Manager: configures behavior (evidence: `common/src/main/java/com/minescore/playback/PlaybackManager.java`)
