lighty-loaders

Mod loader support for Minecraft: Vanilla, Fabric, Quilt, Forge, NeoForge, OptiFine, and custom loaders.

Overview

Version: 0.8.6 Part of: LightyLauncher

Provides a unified trait-based API for managing different Minecraft mod loaders with smart caching and metadata resolution.

Quick Start

use lighty_launcher::prelude::*;

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

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Initialize AppState
    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 mut instance = VersionBuilder::new(
        "my-instance",
        Loader::Fabric,
        "0.16.9",      // Fabric loader version
        "1.21.1",      // Minecraft version
        launcher_dir
    );

    // Get metadata (automatically fetched and cached)
    let metadata = instance.get_metadata().await?;

    trace_info!("Loaded {} with {} libraries", metadata.id, metadata.libraries.len());

    Ok(())
}

Supported Loaders

Loader	Feature Flag	Status	MC Versions
Vanilla	vanilla	Stable	All
Fabric	fabric	Stable	1.14+
Quilt	quilt	Stable	1.14+
NeoForge	neoforge	Stable	1.20.2+
Forge	forge	In Progress	1.13+
Forge Legacy	forge_legacy	In Progress	1.7-1.12
LightyUpdater	lighty_updater	Stable	Custom
OptiFine	(vanilla feature)	Experimental	Most

Features

• Trait-based system: VersionInfo and LoaderExtensions for extensibility

• Smart caching: Dual-layer cache (raw + query) with configurable TTL

• Query system: Flexible metadata queries (full, libraries only, etc.)

• Event integration: Progress tracking via lighty-event

• Feature flags: Compile only what you need

Installation

[dependencies]
# With all loaders
lighty-loaders = { version = "0.8.6", features = ["all-loaders"] }

# With specific loaders
lighty-loaders = { version = "0.8.6", features = ["vanilla", "fabric", "quilt"] }

Core Traits

VersionInfo

Defines version information for any instance:

use lighty_launcher::loaders::VersionInfo;

// Already implemented by VersionBuilder
let instance = VersionBuilder::new("name", Loader::Vanilla, "", "1.21.1", launcher_dir);

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

LoaderExtensions

Extension methods for fetching loader metadata:

use lighty_launcher::loaders::LoaderExtensions;

// Get full metadata
let metadata = instance.get_metadata().await?;

// Or get specific parts
let libraries = instance.get_libraries().await?;
let assets = instance.get_assets().await?;

Exports

In lighty_loaders

use lighty_loaders::{
    // Types
    types::{Loader, VersionInfo, LoaderExtensions, InstanceSize},

    // Loaders modules (feature-gated)
    loaders::{vanilla, fabric, quilt, neoforge, forge, lighty_updater, optifine},

    // Utils
    utils::{cache, error, manifest, query},
};

In lighty_launcher (re-exports)

use lighty_launcher::prelude::*;
// or
use lighty_launcher::loaders::{Loader, VersionInfo, LoaderExtensions, InstanceSize};

Documentation

📚 Complete Documentation

Guide	Description
How to Use	Simple guide with practical examples
Overview	Architecture and design
Traits	VersionInfo and LoaderExtensions explained
Query System	How queries work
Cache System	Caching architecture
Events	LoaderEvent types
Exports	All exports and re-exports
Loaders
Vanilla	Pure Minecraft
Fabric	Lightweight mod loader
Quilt	Fabric fork
NeoForge	Modern Forge fork
Forge	Traditional mod loader
LightyUpdater	Custom loader system
OptiFine	Graphics optimization

Related Crates

• lighty-launcher - Main package

• lighty-version - VersionBuilder implementation

• lighty-launch - Launch system

• lighty-event - Event system

License

MIT