lighty-launch

Minecraft launch system for LightyLauncher.

Overview

Version: 26.5.1 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 = "26.5.1"

Basic Launch

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

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Initialize app state
    AppState::init("MyLauncher")?;

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

    // 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?;

Core Components

Documentation

📚 Complete Documentation

Related Crates

• lighty-launcher - Main package
• lighty-event - Event system (for LaunchEvent)
• lighty-core - AppState and utilities
• lighty-java - Java runtime management
• lighty-version - VersionBuilder
• lighty-loaders - Loader metadata
• lighty-auth - UserProfile for launching

License

MIT