Launcher

Cross-platform Flutter application for managing KYBER game sessions

The KYBER Launcher is a modern, cross-platform desktop application built with Flutter that provides a user-friendly interface for managing Star Wars Battlefront II game sessions, mods, and servers.

Overview

The Launcher serves as the primary interface for players to:

• Browse and join multiplayer servers
• Manage game modifications
• Download and configure game files
• Track player statistics and events
• Connect with the KYBER community

Tech Stack

Framework

Flutter 3.11+ (master channel)

Language

Dart SDK 3.11+

UI Library

Fluent UI (Windows-style design)

FFI Bridge

Rust via flutter_rust_bridge

Key Dependencies

• State Management: BLoC pattern with flutter_bloc
• Networking: gRPC, GraphQL, WebSockets
• Storage: Hive (local database)
• UI Components: Fluent UI, custom Star Wars themed widgets
• Media: Video playback, audio, cached images
• Error Tracking: Sentry for crash reporting

Architecture

The Launcher follows clean architecture principles with clear separation of concerns:

lib/
├── core/              # Core utilities and configuration
├── features/          # Feature modules
│   ├── server_browser/   # Server browsing and filtering
│   ├── mod_browser/      # Mod discovery and installation
│   ├── maxima/           # EA backend integration
│   ├── kyber/            # KYBER API integration
│   └── stats/            # Player statistics
├── shared/            # Shared UI components
└── gen/               # Generated code (assets, rust bindings)

Key Features Implementation

lib/main.dart

import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:fluent_ui/fluent_ui.dart';
import 'package:kyber_launcher/core/routing/app_router.dart';
import 'package:kyber_launcher/features/server_browser/providers/server_list_cubit.dart';
import 'package:kyber_launcher/features/maxima/providers/maxima_cubit.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Initialize Rust FFI bindings
  await RustLib.init();
  
  // Initialize Hive storage
  await Hive.initFlutter();
  
  runApp(const KyberApp());
}

class KyberApp extends StatelessWidget {
  const KyberApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MultiBlocProvider(
      providers: [
        BlocProvider(create: (_) => ServerListCubit()),
        BlocProvider(create: (_) => MaximaCubit()),
        // Additional providers...
      ],
      child: FluentApp.router(
        routerConfig: appRouter,
        theme: FluentThemeData(
          // Custom Star Wars theme
        ),
      ),
    );
  }
}

Building

Prerequisites

1. Install Flutter

   Download and install Flutter (master channel)

   flutter channel master
   flutter upgrade
   
2. Install Rust

   Install Rust nightly toolchain

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   rustup toolchain install nightly
   
3. Install Protoc

   Download Protocol Buffers compiler and add to PATH

4. Bootstrap Workspace

   Install Melos and bootstrap dependencies

   dart pub global activate melos
   cd ~/workspace/source
   melos bootstrap
   

Generate FFI Bindings

Windows

cd Launcher
dart run tool/ffigen.dart

Linux

cd Launcher
dart run tool/ffigen.dart

Development Build

Run the launcher in debug mode:

cd Launcher
flutter run

Use flutter run -d windows or flutter run -d linux to specify the platform

Release Build

Windows

cd Launcher
flutter build windows --release

Output: build/windows/runner/Release/

Linux

cd Launcher
flutter build linux --release

Output: build/linux/x64/release/bundle/

Building the Installer

Windows

Use Inno Setup with the provided script:

# After building the release binary
cd Launcher/installer
iscc installer.iss

The installer will be created in the installer/Output directory.

Linux

Package the bundle directory:

cd build/linux/x64/release
tar -czf kyber-launcher-linux.tar.gz bundle/

Platform-Specific Features

Windows

• Native window management (minimize to tray, always on top)
• Discord Rich Presence integration
• Windows Registry integration for game detection
• Custom title bar with Fluent Design

Linux

• XDG desktop integration
• Native file picker
• System tray support

Project Structure

pubspec.yaml

name: kyber_launcher
version: 2.0.0-beta9+1

dependencies:
  flutter:
    sdk: flutter
  fluent_ui: ^3.0.0
  flutter_bloc: ^9.0.0
  grpc: ^5.0.0
  graphql_flutter: ^5.2.0
  hive_ce: latest
  sentry_flutter: ^9.5.0
  window_manager: ^0.5.1
  flutter_rust_bridge: latest
  # Additional dependencies...

Code Generation

The Launcher uses several code generation tools:

Generate All

cd Launcher
flutter pub run build_runner build --delete-conflicting-outputs

Development Tips

Hot Reload

Flutter’s hot reload works great for UI changes, but requires a restart for:

• Changes to Rust code
• Changes to generated code
• Changes to native plugins

Debugging gRPC

Enable gRPC logging:

GrpcOrGrpcWebClientChannel.enableLog = true;

Theme Customization

All theme colors and styles are defined in lib/core/config/colors.dart. The launcher uses a custom Star Wars inspired theme based on Fluent Design.

Common Issues

If you encounter FFI binding errors, ensure you’ve run dart run tool/ffigen.dart after any Rust code changes.

The Launcher requires the Module DLL to be present at C:/ProgramData/Kyber/Module/Kyber.dll for game launching functionality.

Related Components

• Module - C++ game module that the Launcher injects
• API - Backend API for server data
• CLI - Command-line alternative to the Launcher