# starling-client/starling architecture

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

## Overview

Starling is an Android-native Minecraft: Java Edition port, while this fork also develops Horizon’s mod API. The player-facing path is obtaining game files, preparing resources, then playing through the client; the modding path adds mod loading and runtime hooks into game behavior and rendering. The graph preserves major README capabilities and central indexed modules. Most implementation wiring was not sampled, so edges without visible call evidence are limited to README-documented relationships.

Main entry points: [`crates/horizon-client/src`](https://github.com/starling-client/starling/tree/starling/crates/horizon-client/src) (Client core), [`crates/horizon-mod-host`](https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-host) (Mod host), [`crates/horizon-mod-vocab/src`](https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-vocab/src) (Mod vocabulary), [`crates/horizon-client-render/src/gfx.rs`](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/gfx.rs) (GPU renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Android gameplay"]
  node_game["Game runtime<br/>[main.rs]"]
  node_client["Client core"]
  node_craft["Crafting<br/>[crafting.rs]"]
  node_entities["Entity behavior<br/>[entity_nbt.rs]"]
  node_worldgen["World generation<br/>[worldgen.rs]"]
  node_touch["Touch controls"]
  node_chat["Chat interface<br/>[chat.rs]"]
  node_settings["Player settings<br/>[settings.rs]"]
end

subgraph group_mods["Mod platform"]
  node_modloader["Mod loading"]
  node_host["Mod host"]
  node_vocab["Mod vocabulary"]
  node_parts["Parts and hooks<br/>[mod.rs]"]
  node_storage[("Item storage<br/>[storage.rs]")]
  node_registry["Content registry<br/>[registry_keys.rs]"]
  node_modrender["Mod render pipelines<br/>[mod_pipelines.rs]"]
  node_wasm["WebAssembly mods"]
end

subgraph group_prep["Game preparation"]
  node_setup["Game setup<br/>[main.rs]"]
  node_portpack["Pack pipeline<br/>[pipeline.rs]"]
end

subgraph group_render["Client rendering"]
  node_graphics["Graphics settings<br/>[graphics.rs]"]
  node_renderer["GPU renderer<br/>[gfx.rs]"]
  node_hud["HUD<br/>[hud.rs]"]
  node_audio["Audio output<br/>[audio.rs]"]
  node_sound["Sound engine<br/>[sound_engine.rs]"]
end

node_player(("Player"))

node_player -->|"prepares game"| node_setup
node_setup -.->|"enables play"| node_game
node_player -->|"plays"| node_game
node_game -.->|"runs client"| node_client
node_client -.->|"supports crafting"| node_craft
node_client -.->|"updates entities"| node_entities
node_client -->|"generates worlds"| node_worldgen
node_player -->|"uses controls"| node_touch
node_player -->|"sends commands"| node_chat
node_player -->|"changes options"| node_settings
node_settings -.->|"configures graphics"| node_graphics
node_client -.->|"renders game"| node_renderer
node_renderer -.->|"draws HUD"| node_hud
node_renderer -.->|"outputs audio"| node_audio
node_audio -.->|"uses engine"| node_sound
node_player -->|"loads mods"| node_modloader
node_modloader -->|"initializes host"| node_host
node_host -->|"exposes API"| node_vocab
node_vocab -->|"provides parts"| node_parts
node_parts -.->|"resolves attachments"| node_registry
node_vocab -->|"provides storage"| node_storage
node_host -->|"supports mods"| node_wasm
node_host -->|"registers pipelines"| node_modrender
node_portpack -->|"prepares worldgen"| node_worldgen

click node_setup "https://github.com/starling-client/starling/blob/starling/crates/horizon-prepare/src/main.rs"
click node_portpack "https://github.com/starling-client/starling/blob/starling/crates/horizon-port-pack/src/pipeline.rs"
click node_game "https://github.com/starling-client/starling/blob/starling/crates/horizon-game/src/main.rs"
click node_client "https://github.com/starling-client/starling/tree/starling/crates/horizon-client/src"
click node_craft "https://github.com/starling-client/starling/blob/starling/crates/horizon-client/src/crafting.rs"
click node_entities "https://github.com/starling-client/starling/blob/starling/crates/horizon-client/src/entity_nbt.rs"
click node_worldgen "https://github.com/starling-client/starling/blob/starling/crates/horizon-port-pack/src/worldgen.rs"
click node_touch "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/android_controls.rs"
click node_chat "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/chat.rs"
click node_settings "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/settings.rs"
click node_graphics "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/graphics.rs"
click node_renderer "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/gfx.rs"
click node_hud "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/hud.rs"
click node_audio "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/audio.rs"
click node_sound "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/sound_engine.rs"
click node_modloader "https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-runtime"
click node_host "https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-host"
click node_vocab "https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-vocab/src"
click node_parts "https://github.com/starling-client/starling/blob/starling/crates/horizon-mod-vocab/src/parts/mod.rs"
click node_storage "https://github.com/starling-client/starling/blob/starling/crates/horizon-mod-vocab/src/item/storage.rs"
click node_registry "https://github.com/starling-client/starling/blob/starling/crates/horizon-mod-vocab/src/content/registry_keys.rs"
click node_modrender "https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/gfx/mod_pipelines.rs"
click node_wasm "https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-wasm"

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_game,node_client,node_craft,node_entities,node_worldgen,node_touch,node_chat,node_settings toneBlue
class node_modloader,node_host,node_vocab,node_parts,node_storage,node_registry,node_modrender,node_wasm toneAmber
class node_setup,node_portpack toneMint
class node_graphics,node_renderer,node_hud,node_audio,node_sound toneRose
class node_player toneIndigo
```

## Components

### Android gameplay

- [Game runtime](https://github.com/starling-client/starling/blob/starling/crates/horizon-game/src/main.rs): `crates/horizon-game/src/main.rs`
- [Client core](https://github.com/starling-client/starling/tree/starling/crates/horizon-client/src): `crates/horizon-client/src`
- [Crafting](https://github.com/starling-client/starling/blob/starling/crates/horizon-client/src/crafting.rs): `crates/horizon-client/src/crafting.rs`
- [Entity behavior](https://github.com/starling-client/starling/blob/starling/crates/horizon-client/src/entity_nbt.rs): `crates/horizon-client/src/entity_nbt.rs`
- [World generation](https://github.com/starling-client/starling/blob/starling/crates/horizon-port-pack/src/worldgen.rs): `crates/horizon-port-pack/src/worldgen.rs`
- [Touch controls](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/android_controls.rs): `crates/horizon-client-render/src/android_controls.rs`
- [Chat interface](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/chat.rs): `crates/horizon-client-render/src/chat.rs`
- [Player settings](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/settings.rs): `crates/horizon-client-render/src/settings.rs`

### Mod platform

- [Mod loading](https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-runtime): `crates/horizon-mod-runtime`
- [Mod host](https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-host): `crates/horizon-mod-host`
- [Mod vocabulary](https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-vocab/src): `crates/horizon-mod-vocab/src`
- [Parts and hooks](https://github.com/starling-client/starling/blob/starling/crates/horizon-mod-vocab/src/parts/mod.rs): `crates/horizon-mod-vocab/src/parts/mod.rs`
- [Item storage](https://github.com/starling-client/starling/blob/starling/crates/horizon-mod-vocab/src/item/storage.rs): `crates/horizon-mod-vocab/src/item/storage.rs`
- [Content registry](https://github.com/starling-client/starling/blob/starling/crates/horizon-mod-vocab/src/content/registry_keys.rs): `crates/horizon-mod-vocab/src/content/registry_keys.rs`
- [Mod render pipelines](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/gfx/mod_pipelines.rs): `crates/horizon-client-render/src/gfx/mod_pipelines.rs`
- [WebAssembly mods](https://github.com/starling-client/starling/tree/starling/crates/horizon-mod-wasm): `crates/horizon-mod-wasm`

### Game preparation

- [Game setup](https://github.com/starling-client/starling/blob/starling/crates/horizon-prepare/src/main.rs): `crates/horizon-prepare/src/main.rs`
- [Pack pipeline](https://github.com/starling-client/starling/blob/starling/crates/horizon-port-pack/src/pipeline.rs): `crates/horizon-port-pack/src/pipeline.rs`

### Client rendering

- [Graphics settings](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/graphics.rs): `crates/horizon-client-render/src/graphics.rs`
- [GPU renderer](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/gfx.rs): `crates/horizon-client-render/src/gfx.rs`
- [HUD](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/hud.rs): `crates/horizon-client-render/src/hud.rs`
- [Audio output](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/audio.rs): `crates/horizon-client-render/src/audio.rs`
- [Sound engine](https://github.com/starling-client/starling/blob/starling/crates/horizon-client-render/src/sound_engine.rs): `crates/horizon-client-render/src/sound_engine.rs`

### Other components

- **Player**

## Connections

- Player → Game setup: prepares game (evidence: `README.md`)
- Game setup → Game runtime: enables play
- Player → Game runtime: plays (evidence: `README.md`)
- Game runtime → Client core: runs client
- Client core → Crafting: supports crafting (evidence: `crates/horizon-client/src/merchant.rs`)
- Client core → Entity behavior: updates entities (evidence: `crates/horizon-client/src/save.rs`)
- Client core → World generation: generates worlds (evidence: `README.md`)
- Player → Touch controls: uses controls (evidence: `README.md`)
- Player → Chat interface: sends commands (evidence: `README.md`)
- Player → Player settings: changes options (evidence: `README.md`)
- Player settings → Graphics settings: configures graphics (evidence: `crates/horizon-client-render/src/settings.rs`)
- Client core → GPU renderer: renders game
- GPU renderer → HUD: draws HUD
- GPU renderer → Audio output: outputs audio
- Audio output → Sound engine: uses engine
- Player → Mod loading: loads mods (evidence: `README.md`)
- Mod loading → Mod host: initializes host (evidence: `README.md`)
- Mod host → Mod vocabulary: exposes API (evidence: `README.md`)
- Mod vocabulary → Parts and hooks: provides parts (evidence: `crates/horizon-mod-vocab/src/parts/mod.rs`)
- Parts and hooks → Content registry: resolves attachments (evidence: `crates/horizon-mod-vocab/src/content/registry_keys.rs`)
- Mod vocabulary → Item storage: provides storage (evidence: `crates/horizon-mod-vocab/src/item/storage.rs`)
- Mod host → WebAssembly mods: supports mods (evidence: `README.md`)
- Mod host → Mod render pipelines: registers pipelines (evidence: `crates/horizon-client-render/src/gfx/mod_pipelines.rs`)
- Pack pipeline → World generation: prepares worldgen (evidence: `crates/horizon-port-pack/src/pipeline.rs`)
