lighty-version

Version management and builders for LightyLauncher.

Overview

Version: 0.8.6 Part of: LightyLauncher

lighty-version provides version builders that implement the VersionInfo trait from lighty-loaders, enabling version management for Minecraft instances.

Features

• VersionBuilder - Standard version builder for all loaders

• LightyVersionBuilder - Custom server version builder for LightyUpdater

• VersionInfo Implementation - Implements core version trait

• Directory Management - Configurable game and Java directories

• Type Safety - Strongly typed version information

Quick Start

[dependencies]
lighty-version = "0.8.6"

VersionBuilder (Standard Loaders)

use lighty_core::AppState;
use lighty_version::VersionBuilder;
use lighty_loaders::types::Loader;

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

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

    let launcher_dir = AppState::get_project_dirs();

    // Create instance with Fabric loader
    let instance = VersionBuilder::new(
        "my-instance",         // Instance name
        Loader::Fabric,        // Loader type
        "0.16.9",             // Loader version
        "1.21.1",             // Minecraft version
        launcher_dir
    );

    println!("Instance: {}", instance.name());
    println!("Game dir: {}", instance.game_dirs().display());

    Ok(())
}

LightyVersionBuilder (Custom Server)

use lighty_core::AppState;
use lighty_version::LightyVersionBuilder;

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

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

    let launcher_dir = AppState::get_project_dirs();

    // Create instance for custom server with LightyUpdater
    let instance = LightyVersionBuilder::new(
        "my-modpack",                  // Instance name
        "https://myserver.com/api",    // Server API URL
        launcher_dir
    );

    println!("Server: {}", instance.loader_version());

    Ok(())
}

With Custom Directories

use std::path::PathBuf;

// Custom game and Java directories
let instance = VersionBuilder::new(
    "custom",
    Loader::Vanilla,
    "",
    "1.21.1",
    launcher_dir
)
.with_custom_game_dir(PathBuf::from("/opt/minecraft/instances/custom"))
.with_custom_java_dir(PathBuf::from("/usr/lib/jvm/java-21"));

Core Types

Type	Description
VersionBuilder	Standard version builder for all loaders
LightyVersionBuilder	Custom server builder for LightyUpdater

Both implement VersionInfo from lighty-loaders.

Documentation

📚 Complete Documentation

Guide	Description
How to Use	Practical usage guide with examples
Overview	Architecture and design
Exports	Complete export reference
VersionBuilder	Standard version builder details
LightyVersionBuilder	Custom server builder details

Related Crates

• lighty-launcher - Main package

• lighty-loaders - VersionInfo trait and loaders

• lighty-core - AppState for project directories

• lighty-launch - Uses VersionBuilder for launching

License

MIT