Authentication

1. Add the Dependency

Add minified-auth to your build.gradle file:

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.dervarex.minified:minified-auth:2.1.0'
}

---

2. Initialize the Auth Manager

Before using authentication, initialize the AuthManager with a directory where sessions can be stored.

Java

Path authDirectory = Path.of("<auth-directory>");

AuthManager.init(authDirectory);

Kotlin

val authDirectory = Path.of("<auth-directory>")

AuthManager.init(authDirectory)

---

3. Check for a Saved Session

Before starting a new login, check whether a saved session already exists.

Java

User user = null;

if (AuthManager.hasSessionSaved()) {
    user = AuthManager.loginWithSavedSession();
}

Kotlin

var user: User? = null

if (AuthManager.hasSessionSaved()) {
    user = AuthManager.loginWithSavedSession()
}

If the saved session is valid, loginWithSavedSession() returns the authenticated user.

---

4. Start Device Code Login

If no saved session exists, start the Microsoft device code login:

Java

AuthManager.startDeviceCodeLoginAsync();

Kotlin

AuthManager.startDeviceCodeLoginAsync()

The login runs asynchronously. You can access its current state using:

Java

LoginState state = AuthManager.getLoginState();

Kotlin

val state = AuthManager.getLoginState()

Wait until the user code becomes available:

Java

while (true) {
    LoginState state = AuthManager.getLoginState();

    if (state.userCode != null && state.verificationUri != null) {
        System.out.println(
                "Go to " + state.verificationUri
                + " and enter code " + state.userCode
        );
        break;
    }

    Thread.sleep(500);
}

Kotlin

while (true) {
    val state = AuthManager.getLoginState()

    if (state.userCode != null && state.verificationUri != null) {
        println(
            "Go to ${state.verificationUri} and enter code ${state.userCode}"
        )
        break
    }

    Thread.sleep(500)
}

The user can then open the verification URL and enter the displayed code.

---

5. Wait for Authentication

After displaying the login instructions, wait until authentication succeeds or fails:

Java

while (true) {
    LoginState state = AuthManager.getLoginState();

    if (state.status == AuthManager.LoginStatus.SUCCESS) {
        break;
    }

    if (state.status == AuthManager.LoginStatus.ERROR) {
        throw new IllegalStateException(state.message);
    }

    Thread.sleep(500);
}

Kotlin

while (true) {
    val state = AuthManager.getLoginState()

    if (state.status == AuthManager.LoginStatus.SUCCESS) {
        break
    }

    if (state.status == AuthManager.LoginStatus.ERROR) {
        throw IllegalStateException(state.message)
    }

    Thread.sleep(500)
}

After a successful login, get the authenticated user:

Java

User user = AuthManager.getUser();

System.out.println(
        "Logged in as "
        + user.getUsername()
        + " ("
        + user.getUuid()
        + ")"
);

Kotlin

val user = AuthManager.getUser()

println(
    "Logged in as ${user.username} (${user.uuid})"
)

---

Complete Example

Java

Path authDirectory = Path.of("<auth-directory>");

AuthManager.init(authDirectory);

User user = null;

if (AuthManager.hasSessionSaved()) {
    user = AuthManager.loginWithSavedSession();
}

if (user == null) {
    AuthManager.startDeviceCodeLoginAsync();

    boolean loginInstructionsShown = false;

    while (true) {
        LoginState state = AuthManager.getLoginState();

        if (!loginInstructionsShown
                && state.userCode != null
                && state.verificationUri != null) {

            System.out.println(
                    "Go to " + state.verificationUri
                    + " and enter code " + state.userCode
            );

            loginInstructionsShown = true;
        }

        if (state.status == AuthManager.LoginStatus.SUCCESS) {
            user = AuthManager.getUser();
            break;
        }

        if (state.status == AuthManager.LoginStatus.ERROR) {
            throw new IllegalStateException(state.message);
        }

        Thread.sleep(500);
    }
}

System.out.println(
        "Logged in as "
        + user.getUsername()
        + " ("
        + user.getUuid()
        + ")"
);

Kotlin

val authDirectory = Path.of("<auth-directory>")

AuthManager.init(authDirectory)

var user: User? = null

if (AuthManager.hasSessionSaved()) {
    user = AuthManager.loginWithSavedSession()
}

if (user == null) {
    AuthManager.startDeviceCodeLoginAsync()

    var loginInstructionsShown = false

    while (true) {
        val state = AuthManager.getLoginState()

        if (!loginInstructionsShown
            && state.userCode != null
            && state.verificationUri != null
        ) {
            println(
                "Go to ${state.verificationUri} and enter code ${state.userCode}"
            )

            loginInstructionsShown = true
        }

        if (state.status == AuthManager.LoginStatus.SUCCESS) {
            user = AuthManager.getUser()
            break
        }

        if (state.status == AuthManager.LoginStatus.ERROR) {
            throw IllegalStateException(state.message)
        }

        Thread.sleep(500)
    }
}

println(
    "Logged in as ${user!!.username} (${user.uuid})"
)

The returned User can now be passed directly to Minified Launch:

Java

Launcher.launchMinecraft(
        user,
        config
);

Kotlin

Launcher.launchMinecraft(
    user,
    config
)