lighty-auth

Multi-provider authentication system for Minecraft launchers with OAuth2 and CMS integrations.

Overview

Part of: LightyLauncher

lighty-auth provides a unified trait-based authentication system supporting multiple providers:

• Offline Mode - Local authentication without network, generates deterministic UUIDs
• Microsoft Account - OAuth 2.0 Device Code Flow via Microsoft/Xbox Live/Minecraft Services
• Azuriom CMS - Server authentication with 2FA support, roles, and permissions
• Custom Providers - Implement the Authenticator trait for your own auth system

Quick Start

cargo add lighty-auth

Offline Authentication

use lighty_auth::{offline::OfflineAuth, Authenticator};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let mut auth = OfflineAuth::new("PlayerName");

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

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

    println!("Username: {}", profile.username);
    println!("UUID: {}", profile.uuid);

    Ok(())
}

Microsoft Authentication

Azure AD setup required — your client ID must also be approved by Mojang before it can call Minecraft Services. Follow the full step-by-step guide with screenshots in docs/application-id-microsoft.md.

use lighty_auth::{microsoft::MicrosoftAuth, Authenticator};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let mut auth = MicrosoftAuth::new("your-azure-client-id");

    // Display device code to user
    auth.set_device_code_callback(|code, url| {
        println!("Please visit: {}", url);
        println!("And enter code: {}", code);
    });

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

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

    println!("Logged in as: {}", profile.username);

    Ok(())
}

Authentication Providers

Features

• Trait-based - Implement Authenticator for custom providers
• Event integration - Track authentication progress with events
• 2FA support - Azuriom two-factor authentication
• Offline UUIDs - Deterministic UUID generation
• Role system - User roles with colors and permissions

Documentation

📚 Complete Documentation

Related Crates

• lighty-launcher - Main package
• lighty-event - Event system (for AuthEvent)
• lighty-core - Hash utilities for offline UUID
• lighty-launch - Uses UserProfile for launching

License

MIT