How fluxloader-team/fluxloader works
Sandustry Fluxloader is a cross-platform Electron modloader. The main user workflow is choosing manager or game launch, then browsing or creating mods, queueing install/update/removal actions, and loading the resulting mods into Sandustry. Its runtime also manages configuration, dependency-aware actions, load order, game-file patching, worker/game mod entrypoints, and logs. The graph follows documented capabilities and sampled IPC ownership; unsampled details are represented only at their enclosing source path.
Main entry points: electron.js Electron runtime · manager.js Mod manager · game.js Game mod runtime · worker.js Worker mod runtime
Components 19
Desktop runtime
- Electron runtime
src/electron.js - Mod manager
src/manager/manager.js - Manager IPC bridge
src/manager/manager-preload.js - Manager interface
src/manager/manager.html - Manager logs
src/manager/manager.js
Mod management
- Mod discovery
src/manager/manager.js - Action queue
src/manager/manager.js - Installed mods
src/electron.js - Mod creation
src/manager/manager.js - Load order
src/electron.js - Mod configuration
src/electron.js
Game integration
- Game file patching
src/electron.js - Sandustry game
- Game mod runtime
src/game.js - Worker mod runtime
src/worker.js
Shared services
- Dependency solver
src/common.js - Events and logging
src/common.js
Other components
- User
- Mod service
Connections 33
- User → Electron runtime: launches
- Electron runtime → Mod manager: opens manager
- Electron runtime → Sandustry game: launches
- Manager interface → Mod manager: renders
- Mod manager → Manager IPC bridge: invokes IPC
- Manager IPC bridge → Electron runtime: forwards IPC
- Mod manager → Mod discovery: browses
- Mod discovery → Electron runtime: fetches mods
- Electron runtime → Mod service: requests catalog
- Mod service → Electron runtime: returns metadata
- Mod manager → Action queue: queues actions
- Action queue → Electron runtime: requests actions
- Electron runtime → Dependency solver: calculates actions
- Dependency solver → Mod service: fetches version data
- Electron runtime → Installed mods: installs and scans
- Mod manager → Installed mods: renders installed mods
- Mod manager → Mod creation: submits mod details
- Mod manager → Load order: edits load order
- Electron runtime → Load order: calculates dependencies
- Mod manager → Mod configuration: edits configuration
- Electron runtime → Mod configuration: validates and persists
- Electron runtime → Game file patching: patches files
- Game file patching → Sandustry game: runs patched game
- Sandustry game → Game mod runtime: loads runtime
- Game mod runtime → Electron runtime: requests loaded mods
- Game mod runtime → Mod configuration: reads and writes config
- Sandustry game → Worker mod runtime: starts workers
- Game mod runtime → Worker mod runtime: sends messages
- Worker mod runtime → Game mod runtime: sends messages
- Game mod runtime → Events and logging: emits events and logs
- Worker mod runtime → Events and logging: emits events
- Electron runtime → Manager logs: forwards game logs
- Manager logs → Mod manager: displays logs