# aydanli/starship-forge architecture

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

- Interactive diagram: https://gitdiagram.com/aydanli/starship-forge
- Repository: https://github.com/aydanli/starship-forge

## Overview

星舰熔炉 is a Cocos Creator sci-fi game for Douyin; the web version is an older prototype, so this map focuses on the documented Cocos product. The main loop runs from login and progression through forge preparation, fleet deployment, auto-battle, settlement, and the next wave, with story and tutorial guidance. The README documents the Cocos module mapping and major capabilities; sampled implementation excerpts are from the web prototype, so Cocos-specific internal call edges are limited to documented relationships.

Main entry points: [`cocos/assets/scripts/core/flow.ts`](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/flow.ts) (Game Flow), [`cocos/assets/scripts/core/battle.ts`](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/battle.ts) (Auto Battle), [`cocos/assets/scripts/view/GameApp.ts`](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/GameApp.ts) (Game App View), [`cocos/assets/scripts/core/forge.ts`](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/forge.ts) (Forge & Merging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_progression["Progression &amp; UX"]
  node_flow["Game Flow<br/>[flow.ts]"]
  node_user["Commander Login<br/>[user.ts]"]
  node_menu["Menu &amp; Star Map<br/>[menu.ts]"]
  node_story["Story Cards<br/>[story.ts]"]
  node_storydata["Story Content<br/>[storyData.ts]"]
  node_tutorial["Tutorial Guidance<br/>[tutorial.ts]"]
end

subgraph group_gameplay["Battle Gameplay"]
  node_forge["Forge &amp; Merging<br/>[forge.ts]"]
  node_board["Fleet Deployment<br/>[board.ts]"]
  node_battle["Auto Battle<br/>[battle.ts]"]
  node_fleet["Fleet &amp; Enemies<br/>[fleet.ts]"]
  node_synergy["Faction Synergies<br/>[synergy.ts]"]
  node_economy["Rewards &amp; Recruiting<br/>[economy.ts]"]
  node_config["Game Configuration<br/>[config.ts]"]
  node_rng["Seeded Randomness<br/>[rng.ts]"]
end

subgraph group_services["Player Services"]
  node_save[("Progress Save<br/>[save.ts]")]
  node_ads["Rewarded Ads<br/>[ads.ts]"]
  node_platform["Platform Adapter<br/>[platform.ts]"]
end

subgraph group_presentation["Presentation"]
  node_gameapp["Game App View<br/>[GameApp.ts]"]
  node_tex["Texture Loader<br/>[Tex.ts]"]
  node_bgm["Music Player<br/>[Bgm.ts]"]
  node_audio["Music Mapping<br/>[bgm.ts]"]
end

node_player(("Player"))

node_player -->|"plays"| node_gameapp
node_gameapp -->|"routes flow"| node_flow
node_flow -->|"starts login"| node_user
node_flow -->|"opens menus"| node_menu
node_menu -->|"starts run"| node_flow
node_flow -->|"starts preparation"| node_forge
node_forge -->|"deploys fleet"| node_board
node_board -->|"starts battle"| node_battle
node_battle -->|"uses units"| node_fleet
node_battle -->|"applies synergies"| node_synergy
node_battle -->|"settles rewards"| node_economy
node_economy -->|"funds preparation"| node_forge
node_flow -->|"queues story"| node_story
node_story -->|"reads content"| node_storydata
node_tutorial -->|"shows guidance"| node_gameapp
node_flow -->|"persists progress"| node_save
node_economy -->|"offers rewards"| node_ads
node_ads -->|"uses adapter"| node_platform
node_gameapp -->|"loads artwork"| node_tex
node_audio -->|"selects music"| node_bgm
node_gameapp -->|"plays music"| node_bgm
node_battle -->|"draws gameplay randomness"| node_rng
node_forge -->|"draws drop randomness"| node_rng
node_battle -->|"uses rules"| node_config

click node_flow "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/flow.ts"
click node_user "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/user.ts"
click node_menu "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/menu.ts"
click node_story "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/story.ts"
click node_storydata "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/storyData.ts"
click node_tutorial "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/tutorial.ts"
click node_forge "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/forge.ts"
click node_board "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/board.ts"
click node_battle "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/battle.ts"
click node_fleet "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/fleet.ts"
click node_synergy "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/synergy.ts"
click node_economy "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/economy.ts"
click node_config "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/config.ts"
click node_rng "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/rng.ts"
click node_save "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/save.ts"
click node_ads "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/ads.ts"
click node_platform "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/platform.ts"
click node_gameapp "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/GameApp.ts"
click node_tex "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/Tex.ts"
click node_bgm "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/Bgm.ts"
click node_audio "https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/bgm.ts"

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_flow,node_user,node_menu,node_story,node_storydata,node_tutorial toneBlue
class node_forge,node_board,node_battle,node_fleet,node_synergy,node_economy,node_config,node_rng toneAmber
class node_save,node_ads,node_platform toneMint
class node_gameapp,node_tex,node_bgm,node_audio toneRose
class node_player toneIndigo
```

## Components

### Progression & UX

- [Game Flow](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/flow.ts): `cocos/assets/scripts/core/flow.ts`
- [Commander Login](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/user.ts): `cocos/assets/scripts/core/user.ts`
- [Menu & Star Map](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/menu.ts): `cocos/assets/scripts/core/menu.ts`
- [Story Cards](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/story.ts): `cocos/assets/scripts/core/story.ts`
- [Story Content](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/storyData.ts): `cocos/assets/scripts/core/storyData.ts`
- [Tutorial Guidance](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/tutorial.ts): `cocos/assets/scripts/core/tutorial.ts`

### Battle Gameplay

- [Forge & Merging](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/forge.ts): `cocos/assets/scripts/core/forge.ts`
- [Fleet Deployment](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/board.ts): `cocos/assets/scripts/core/board.ts`
- [Auto Battle](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/battle.ts): `cocos/assets/scripts/core/battle.ts`
- [Fleet & Enemies](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/fleet.ts): `cocos/assets/scripts/core/fleet.ts`
- [Faction Synergies](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/synergy.ts): `cocos/assets/scripts/core/synergy.ts`
- [Rewards & Recruiting](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/economy.ts): `cocos/assets/scripts/core/economy.ts`
- [Game Configuration](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/config.ts): `cocos/assets/scripts/core/config.ts`
- [Seeded Randomness](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/rng.ts): `cocos/assets/scripts/core/rng.ts`

### Player Services

- [Progress Save](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/save.ts): `cocos/assets/scripts/core/save.ts`
- [Rewarded Ads](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/ads.ts): `cocos/assets/scripts/core/ads.ts`
- [Platform Adapter](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/platform.ts): `cocos/assets/scripts/core/platform.ts`

### Presentation

- [Game App View](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/GameApp.ts): `cocos/assets/scripts/view/GameApp.ts`
- [Texture Loader](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/Tex.ts): `cocos/assets/scripts/view/Tex.ts`
- [Music Player](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/view/Bgm.ts): `cocos/assets/scripts/view/Bgm.ts`
- [Music Mapping](https://github.com/aydanli/starship-forge/blob/main/cocos/assets/scripts/core/bgm.ts): `cocos/assets/scripts/core/bgm.ts`

### Other components

- **Player**

## Connections

- Player → Game App View: plays (evidence: `README.md`)
- Game App View → Game Flow: routes flow (evidence: `README.md`)
- Game Flow → Commander Login: starts login (evidence: `README.md`)
- Game Flow → Menu & Star Map: opens menus (evidence: `README.md`)
- Menu & Star Map → Game Flow: starts run (evidence: `README.md`)
- Game Flow → Forge & Merging: starts preparation (evidence: `README.md`)
- Forge & Merging → Fleet Deployment: deploys fleet (evidence: `README.md`)
- Fleet Deployment → Auto Battle: starts battle (evidence: `README.md`)
- Auto Battle → Fleet & Enemies: uses units (evidence: `README.md`)
- Auto Battle → Faction Synergies: applies synergies (evidence: `README.md`)
- Auto Battle → Rewards & Recruiting: settles rewards (evidence: `README.md`)
- Rewards & Recruiting → Forge & Merging: funds preparation (evidence: `README.md`)
- Game Flow → Story Cards: queues story (evidence: `README.md`)
- Story Cards → Story Content: reads content (evidence: `README.md`)
- Tutorial Guidance → Game App View: shows guidance (evidence: `README.md`)
- Game Flow → Progress Save: persists progress (evidence: `README.md`)
- Rewards & Recruiting → Rewarded Ads: offers rewards (evidence: `README.md`)
- Rewarded Ads → Platform Adapter: uses adapter (evidence: `README.md`)
- Game App View → Texture Loader: loads artwork (evidence: `README.md`)
- Music Mapping → Music Player: selects music (evidence: `README.md`)
- Game App View → Music Player: plays music (evidence: `README.md`)
- Auto Battle → Seeded Randomness: draws gameplay randomness (evidence: `README.md`)
- Forge & Merging → Seeded Randomness: draws drop randomness (evidence: `README.md`)
- Auto Battle → Game Configuration: uses rules (evidence: `README.md`)
