Componentsedit
- Desktop application: Tauri v2 with the system WebView.
- Backend: Rust on Tokio, with a workspace of internal crates.
- Interface: Svelte 5 + SvelteKit + TypeScript, compiled as a static site.
The frontend sends commands to the backend through Tauri IPC. The backend responds with app-event events and log streams; the UI consumes them to update downloads, instances, launch status and the console.
Workspace cratesedit
| Crate | Responsibility |
|---|---|
aqua | Downloading Minecraft versions, loaders and JREs; manifests, assets, libraries and download providers. |
zellkern | Manifest models, version resolution, Forge utilities, argument building and LaunchConfig. |
launchwerk | Preparing and launching the Java process, extracting natives and handling the lifecycle. |
cubrinth | Installing .mrpack modpacks and related utilities. |
communicator | Discord RPC client. |
ablage | Local repository with a versioned cache for serialized data. |
src-tauri | Tauri application: commands, instance services, settings, authentication, download queue and events. |
Repository structureedit
plaintext
src/ # Frontend interface, state and services
src-tauri/ # Tauri app, commands and native services
src/tests/ # Application backend tests
src/services/ # Instances, downloads, Java, launcher, authentication
crates/ # Internal crates of the Rust workspace
<crate>/src/tests/ # Unit tests per crate
tests/frontend/ # Frontend tests
static/ # Static assets
dist/ # Packaging for distributions
.github/ # CI and publishing workflowsLaunch flowedit
- The UI invokes the
launchcommand. - The
Launcherservice locks the instance files and marks the status asStarting. - Version dependencies are checked; if any are missing, they are queued in
DownloadQueueandVersionNotFoundis returned. aquadownloads version, loader and JRE as needed.zellkernresolves manifest inheritance (Vanilla → loader) and builds the arguments.- The account token is refreshed and
LaunchConfigis assembled with RAM, JVM arguments, environment variables, authentication and Quick Play. launchwerkextracts the natives and launches the Java process; stdout/stderr is sent to the logs and the UI.- When it ends, the status returns to
Off. If the process exits with a non-zero code without being stopped from the launcher, a crash is detected and a log snapshot is saved for one hour.
Events and IPCedit
- Commands are exposed from
src-tauri/src/commands/. - Events are published on the application bus as
app-eventand consumed from the frontend. - Downloads emit progress, completion and error separately.
- The console combines live lines, per-instance history and crash snapshots.
On-disk dataedit
By default, everything lives under ~/.cubic/:
instances/<name>/— data for each instance and itsinstance.cubfile.shared/—versions,libraries,assets,nativesandruntimes.settings/settings.cub— settings, accounts and preferences.themes/— user-installed themes.skins/— skin closet.
The instances and shared paths can be changed from Settings → Storage. The configuration for those paths is stored in settings.cub.
Updatesedit
The Tauri updater queries the project endpoints according to the configured channel:
- Stable — published releases.
- Pre-release — alpha, beta or rc versions.
Each push to develop generates CI artifacts, but not a public release. Publishing follows the Versioning and releases flow.