lighty-launch

Minecraft launch system for LightyLauncher.

Overview

Version: 0.8.6 Part of: LightyLauncher

lighty-launch handles the complete Minecraft launch process, from downloading assets to managing running instances.

Features

Game Launching - Launch Minecraft with optimized JVM arguments
Asset Installation - Download and install game assets, libraries, and natives
Process Management - Manage Minecraft process lifecycle
Instance Control - Track, monitor, and control running instances
Console Streaming - Real-time console output via events
Instance Size Calculation - Calculate disk space usage
Mod Support - Automatic mod installation and management

Quick Start

[dependencies]
lighty-launch = "0.8.6"

Basic Launch

use lighty_core::AppState;
use lighty_launcher::prelude::*;
use lighty_java::JavaDistribution;

const QUALIFIER: &str = "com";
const ORGANIZATION: &str = "MyLauncher";
const APPLICATION: &str = "";

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Initialize app state
    let _app = AppState::new(
        QUALIFIER.to_string(),
        ORGANIZATION.to_string(),
        APPLICATION.to_string(),
    )?;

    let launcher_dir = AppState::get_project_dirs();

    // Create instance
    let mut instance = VersionBuilder::new(
        "my-instance",
        Loader::Fabric,
        "0.16.9",
        "1.21.1",
        launcher_dir
    );

    // Authenticate
    let mut auth = OfflineAuth::new("Player123");

    #[cfg(not(feature = "events"))]
    let profile = auth.authenticate().await?;

    #[cfg(feature = "events")]
    let profile = auth.authenticate(None).await?;

    // Launch the game
    instance.launch(&profile, JavaDistribution::Temurin)
        .run()
        .await?;

    Ok(())
}

With Custom JVM Options

use lighty_launch::InstanceControl; // Import trait

// Launch with custom JVM settings
instance.launch(&profile, JavaDistribution::Temurin)
    .with_jvm_options()
        .set("Xmx", "4G")      // Max memory
        .set("Xms", "2G")      // Initial memory
        .done()
    .run()
    .await?;

Instance Control

use lighty_launch::InstanceControl; // Import trait

// Get running instance PID
if let Some(pid) = instance.get_pid() {
    println!("Running with PID: {}", pid);

    // Kill the instance
    instance.close_instance(pid).await?;
}

// Calculate instance size
let metadata = instance.get_metadata().await?;
let size = instance.size_of_instance(&metadata);
println!("Total: {} MB", size.total / 1_000_000);

// Delete instance
instance.delete_instance().await?;