# yusufcanesener/emsalclient architecture

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

- Interactive diagram: https://gitdiagram.com/yusufcanesener/emsalclient
- Repository: https://github.com/yusufcanesener/emsalclient

## Overview

EmsalClient is an Electron desktop client for managing Minecraft AFK/Skyblock bots. The main user flow is selecting a saved profile and starting its bot; the bot connects to the server, navigates to the island, and runs enabled honey, minion, and storage automation while publishing live status and inventory to the desktop UI. Profiles and credentials, settings, release checking, tray controls, and harvest analytics are supporting capabilities. The graph follows documented features and visible imports/calls; some IPC wiring and unsampled module interactions are not expanded.

Main entry points: [`electron-main.js`](https://github.com/yusufcanesener/emsalclient/blob/main/electron-main.js) (Electron shell), [`src/bot/bot-manager.js`](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/bot-manager.js) (Bot manager), [`src/bot/bot-instance.js`](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/bot-instance.js) (Bot instance), [`src/bot/modules/module-registry.js`](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/module-registry.js) (Module registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_ui["Desktop UI<br/>[renderer.js]"]
  node_electron["Electron shell<br/>[electron-main.js]"]
  node_tray["System tray<br/>[tray-manager.js]"]
end

subgraph group_bot["Bot runtime"]
  node_manager["Bot manager<br/>[bot-manager.js]"]
  node_instance["Bot instance<br/>[bot-instance.js]"]
  node_navigation["Island navigation"]
  node_skyblock["Skyblock automation<br/>[auto-skyblock.js]"]
  node_inventory["Inventory service"]
end

subgraph group_automation["Automation modules"]
  node_modulemanager["Module manager<br/>[module-manager.js]"]
  node_registry["Module registry<br/>[module-registry.js]"]
  node_base["Module lifecycle<br/>[base-module.js]"]
  node_honey["Honey harvesting<br/>[honey-module.js]"]
  node_minions["Minion tracking<br/>[minions-module.js]"]
  node_storage["Chest storage<br/>[storage-module.js]"]
end

subgraph group_data["Profiles and state"]
  node_analytics[("Harvest analytics<br/>[harvest-tracker.js]")]
  node_profiles[("Profile store<br/>[profile-store.js]")]
  node_credentials[("Credential store")]
  node_settings[("Settings store<br/>[settings-store.js]")]
  node_paths["User data paths<br/>[paths.js]"]
end

subgraph group_updates["Updates and support"]
  node_release[("Release manager<br/>[release-manager.js]")]
  node_updater["Auto updater<br/>[updater-manager.js]"]
  node_logger["Logger<br/>[logger.js]"]
end

node_user(("User"))
node_github["GitHub Releases"]

node_user -->|"controls"| node_ui
node_ui -.->|"sends commands"| node_electron
node_electron -->|"routes bot actions"| node_manager
node_electron -->|"manages profiles"| node_profiles
node_electron -->|"loads settings"| node_settings
node_electron -->|"checks updates"| node_updater
node_electron -->|"initializes tray"| node_tray
node_manager -->|"reads profiles"| node_profiles
node_manager -->|"reads credentials"| node_credentials
node_manager -->|"updates selection"| node_settings
node_manager -->|"creates instances"| node_instance
node_instance -->|"uses navigation"| node_navigation
node_instance -->|"uses inventory"| node_inventory
node_instance -->|"runs automation"| node_skyblock
node_instance -->|"dispatches lifecycle"| node_modulemanager
node_modulemanager -->|"loads definitions"| node_registry
node_modulemanager -->|"creates modules"| node_base
node_registry -->|"registers module"| node_honey
node_registry -->|"registers module"| node_minions
node_registry -->|"registers module"| node_storage
node_honey -->|"extends lifecycle"| node_base
node_minions -->|"extends lifecycle"| node_base
node_storage -->|"extends lifecycle"| node_base
node_honey -->|"records harvest"| node_analytics
node_minions -->|"records activity"| node_analytics
node_storage -->|"records deposits"| node_analytics
node_storage -->|"returns to AFK"| node_navigation
node_profiles -->|"stores passwords"| node_credentials
node_profiles -->|"normalizes modules"| node_registry
node_analytics -->|"gets data path"| node_paths
node_profiles -->|"gets data path"| node_paths
node_settings -->|"gets data path"| node_paths
node_updater -->|"reads channel"| node_settings
node_updater -->|"checks releases"| node_release
node_release -->|"fetches releases"| node_github
node_tray -->|"reads preferences"| node_settings
node_instance -->|"logs runtime"| node_logger
node_manager -->|"logs bot events"| node_logger
node_updater -->|"logs updates"| node_logger
node_logger -->|"writes log files"| node_paths

click node_ui "https://github.com/yusufcanesener/emsalclient/blob/main/ui/renderer.js"
click node_electron "https://github.com/yusufcanesener/emsalclient/blob/main/electron-main.js"
click node_tray "https://github.com/yusufcanesener/emsalclient/blob/main/src/tray/tray-manager.js"
click node_manager "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/bot-manager.js"
click node_instance "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/bot-instance.js"
click node_navigation "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/services/navigation-service.js"
click node_skyblock "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/services/auto-skyblock.js"
click node_inventory "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/services/inventory-service.js"
click node_modulemanager "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/module-manager.js"
click node_registry "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/module-registry.js"
click node_base "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/base-module.js"
click node_honey "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/honey/honey-module.js"
click node_minions "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/minions/minions-module.js"
click node_storage "https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/storage/storage-module.js"
click node_analytics "https://github.com/yusufcanesener/emsalclient/blob/main/src/analytics/harvest-tracker.js"
click node_profiles "https://github.com/yusufcanesener/emsalclient/blob/main/src/profiles/profile-store.js"
click node_credentials "https://github.com/yusufcanesener/emsalclient/blob/main/src/profiles/credential-store.js"
click node_settings "https://github.com/yusufcanesener/emsalclient/blob/main/src/settings/settings-store.js"
click node_release "https://github.com/yusufcanesener/emsalclient/blob/main/src/releases/release-manager.js"
click node_updater "https://github.com/yusufcanesener/emsalclient/blob/main/src/updater/updater-manager.js"
click node_logger "https://github.com/yusufcanesener/emsalclient/blob/main/src/utils/logger.js"
click node_paths "https://github.com/yusufcanesener/emsalclient/blob/main/src/utils/paths.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_ui,node_electron,node_tray,node_user toneBlue
class node_manager,node_instance,node_navigation,node_skyblock,node_inventory toneAmber
class node_modulemanager,node_registry,node_base,node_honey,node_minions,node_storage toneMint
class node_analytics,node_profiles,node_credentials,node_settings,node_paths toneRose
class node_release,node_updater,node_logger,node_github toneIndigo
```

## Components

### Desktop app

- [Desktop UI](https://github.com/yusufcanesener/emsalclient/blob/main/ui/renderer.js): `ui/renderer.js`
- [Electron shell](https://github.com/yusufcanesener/emsalclient/blob/main/electron-main.js): `electron-main.js`
- [System tray](https://github.com/yusufcanesener/emsalclient/blob/main/src/tray/tray-manager.js): `src/tray/tray-manager.js`

### Bot runtime

- [Bot manager](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/bot-manager.js): `src/bot/bot-manager.js`
- [Bot instance](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/bot-instance.js): `src/bot/bot-instance.js`
- [Island navigation](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/services/navigation-service.js): `src/bot/services/navigation-service.js`
- [Skyblock automation](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/services/auto-skyblock.js): `src/bot/services/auto-skyblock.js`
- [Inventory service](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/services/inventory-service.js): `src/bot/services/inventory-service.js`

### Automation modules

- [Module manager](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/module-manager.js): `src/bot/module-manager.js`
- [Module registry](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/module-registry.js): `src/bot/modules/module-registry.js`
- [Module lifecycle](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/base-module.js): `src/bot/modules/base-module.js`
- [Honey harvesting](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/honey/honey-module.js): `src/bot/modules/honey/honey-module.js`
- [Minion tracking](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/minions/minions-module.js): `src/bot/modules/minions/minions-module.js`
- [Chest storage](https://github.com/yusufcanesener/emsalclient/blob/main/src/bot/modules/storage/storage-module.js): `src/bot/modules/storage/storage-module.js`

### Profiles and state

- [Harvest analytics](https://github.com/yusufcanesener/emsalclient/blob/main/src/analytics/harvest-tracker.js): `src/analytics/harvest-tracker.js`
- [Profile store](https://github.com/yusufcanesener/emsalclient/blob/main/src/profiles/profile-store.js): `src/profiles/profile-store.js`
- [Credential store](https://github.com/yusufcanesener/emsalclient/blob/main/src/profiles/credential-store.js): `src/profiles/credential-store.js`
- [Settings store](https://github.com/yusufcanesener/emsalclient/blob/main/src/settings/settings-store.js): `src/settings/settings-store.js`
- [User data paths](https://github.com/yusufcanesener/emsalclient/blob/main/src/utils/paths.js): `src/utils/paths.js`

### Updates and support

- [Release manager](https://github.com/yusufcanesener/emsalclient/blob/main/src/releases/release-manager.js): `src/releases/release-manager.js`
- [Auto updater](https://github.com/yusufcanesener/emsalclient/blob/main/src/updater/updater-manager.js): `src/updater/updater-manager.js`
- [Logger](https://github.com/yusufcanesener/emsalclient/blob/main/src/utils/logger.js): `src/utils/logger.js`

### Other components

- **User**
- **GitHub Releases**

## Connections

- User → Desktop UI: controls (evidence: `README.md`)
- Desktop UI → Electron shell: sends commands
- Electron shell → Bot manager: routes bot actions (evidence: `electron-main.js`)
- Electron shell → Profile store: manages profiles (evidence: `electron-main.js`)
- Electron shell → Settings store: loads settings (evidence: `electron-main.js`)
- Electron shell → Auto updater: checks updates (evidence: `electron-main.js`)
- Electron shell → System tray: initializes tray (evidence: `electron-main.js`)
- Bot manager → Profile store: reads profiles (evidence: `src/bot/bot-manager.js`)
- Bot manager → Credential store: reads credentials (evidence: `src/bot/bot-manager.js`)
- Bot manager → Settings store: updates selection (evidence: `src/bot/bot-manager.js`)
- Bot manager → Bot instance: creates instances (evidence: `src/bot/bot-manager.js`)
- Bot instance → Island navigation: uses navigation (evidence: `src/bot/bot-instance.js`)
- Bot instance → Inventory service: uses inventory (evidence: `src/bot/bot-instance.js`)
- Bot instance → Skyblock automation: runs automation (evidence: `src/bot/bot-instance.js`)
- Bot instance → Module manager: dispatches lifecycle (evidence: `src/bot/bot-instance.js`)
- Module manager → Module registry: loads definitions (evidence: `src/bot/module-manager.js`)
- Module manager → Module lifecycle: creates modules (evidence: `src/bot/module-manager.js`)
- Module registry → Honey harvesting: registers module (evidence: `src/bot/modules/module-registry.js`)
- Module registry → Minion tracking: registers module (evidence: `src/bot/modules/module-registry.js`)
- Module registry → Chest storage: registers module (evidence: `src/bot/modules/module-registry.js`)
- Honey harvesting → Module lifecycle: extends lifecycle (evidence: `src/bot/modules/honey/honey-module.js`)
- Minion tracking → Module lifecycle: extends lifecycle (evidence: `src/bot/modules/minions/minions-module.js`)
- Chest storage → Module lifecycle: extends lifecycle (evidence: `src/bot/modules/storage/storage-module.js`)
- Honey harvesting → Harvest analytics: records harvest (evidence: `src/bot/modules/honey/honey-module.js`)
- Minion tracking → Harvest analytics: records activity (evidence: `src/bot/modules/minions/minions-module.js`)
- Chest storage → Harvest analytics: records deposits (evidence: `src/bot/modules/storage/storage-module.js`)
- Chest storage → Island navigation: returns to AFK (evidence: `src/bot/modules/storage/storage-module.js`)
- Profile store → Credential store: stores passwords (evidence: `src/profiles/profile-store.js`)
- Profile store → Module registry: normalizes modules (evidence: `src/profiles/profile-store.js`)
- Harvest analytics → User data paths: gets data path (evidence: `src/analytics/harvest-tracker.js`)
- Profile store → User data paths: gets data path (evidence: `src/profiles/profile-store.js`)
- Settings store → User data paths: gets data path (evidence: `src/settings/settings-store.js`)
- Auto updater → Settings store: reads channel (evidence: `src/updater/updater-manager.js`)
- Auto updater → Release manager: checks releases (evidence: `src/updater/updater-manager.js`)
- Release manager → GitHub Releases: fetches releases (evidence: `src/releases/release-manager.js`)
- System tray → Settings store: reads preferences (evidence: `src/tray/tray-manager.js`)
- Bot instance → Logger: logs runtime (evidence: `src/bot/bot-instance.js`)
- Bot manager → Logger: logs bot events (evidence: `src/bot/bot-manager.js`)
- Auto updater → Logger: logs updates (evidence: `src/updater/updater-manager.js`)
- Logger → User data paths: writes log files (evidence: `src/utils/logger.js`)
