dev.nozyx.craft4j

Class Launcher

java.lang.Object

dev.nozyx.craft4j.Launcher

public class Launcher
extends java.lang.Object

The Launcher class is part of the Craft4J library and provides an abstraction layer to simplify authentication, game configuration, update, and launch processes for Minecraft launchers.

This class supports Microsoft authentication (via refresh token or webview), offline authentication, version updating (vanilla and modded), and game launching using OpenLauncherLib and FlowUpdater.

Constructor Summary

Constructors

Constructor and Description
Launcher(java.lang.String launcherName) Constructs a new Launcher instance.

Method Summary

Modifier and Type	Method and Description
void	authOffline(java.lang.String username, java.lang.String uuid) Authenticates the launcher in offline mode using the provided username and UUID.
java.lang.String	authWithRefreshToken(java.lang.String refreshToken) Authenticates the launcher using a Microsoft refresh token.
java.lang.String	authWithWebview() Authenticates the launcher using a Microsoft webview flow.
void	clearAuthInfos() Clears the current authentication information.
fr.theshark34.openlauncherlib.minecraft.AuthInfos	getAuthInfos() Returns the current authentication information.
GameConfiguration	getGameConfiguration() Returns the current game configuration.
java.lang.String	getLauncherName() Returns the name of the launcher.
void	setGameConfiguration(GameConfiguration gameConfiguration) Sets the current game configuration to be used for updates and launching.
java.lang.Process	startGame() Launches the Minecraft game using OpenLauncherLib's NoFramework.
void	update(fr.flowarg.flowupdater.download.IProgressCallback callback) Updates the game files using FlowUpdater according to the current game configuration.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Launcher

public Launcher(java.lang.String launcherName)

Constructs a new Launcher instance.

Parameters:

launcherName - The name of the launcher instance.

Method Detail

authWithRefreshToken

public java.lang.String authWithRefreshToken(java.lang.String refreshToken)
                                      throws fr.litarvan.openauth.microsoft.MicrosoftAuthenticationException

Authenticates the launcher using a Microsoft refresh token.

Parameters:

refreshToken - The Microsoft refresh token.

Returns:

The new refresh token returned by Microsoft.

Throws:

fr.litarvan.openauth.microsoft.MicrosoftAuthenticationException - If authentication fails.

java.lang.IllegalStateException - If the launcher is already authenticated.

authWithWebview

public java.lang.String authWithWebview()
                                 throws fr.litarvan.openauth.microsoft.MicrosoftAuthenticationException

Authenticates the launcher using a Microsoft webview flow.

Returns:

The refresh token obtained after authentication.

Throws:

fr.litarvan.openauth.microsoft.MicrosoftAuthenticationException - If authentication fails.

java.lang.IllegalStateException - If the launcher is already authenticated.

authOffline

public void authOffline(java.lang.String username,
                        java.lang.String uuid)

Authenticates the launcher in offline mode using the provided username and UUID.

Parameters:

username - The offline username.

uuid - The user UUID.

Throws:

java.lang.IllegalStateException - If the launcher is already authenticated.

update

public void update(fr.flowarg.flowupdater.download.IProgressCallback callback)
            throws java.lang.Exception

Updates the game files using FlowUpdater according to the current game configuration. Supports both vanilla and modded Minecraft versions.

Parameters:

callback - The progress callback used during the update.

Throws:

java.lang.Exception - If the update fails or configuration is missing.

java.lang.IllegalStateException - If the game configuration is not set.

startGame

public java.lang.Process startGame()
                            throws java.lang.Exception

Launches the Minecraft game using OpenLauncherLib's NoFramework.

Returns:

The Process of the launched game.

Throws:

java.lang.Exception - If the game fails to launch.

java.lang.IllegalStateException - If authentication or configuration is missing.

clearAuthInfos

public void clearAuthInfos()

Clears the current authentication information.

getAuthInfos

public fr.theshark34.openlauncherlib.minecraft.AuthInfos getAuthInfos()

Returns the current authentication information.

Returns:

The AuthInfos object, or null if not authenticated.

setGameConfiguration

public void setGameConfiguration(GameConfiguration gameConfiguration)

Sets the current game configuration to be used for updates and launching.

Parameters:

gameConfiguration - The GameConfiguration to set.

getGameConfiguration

public GameConfiguration getGameConfiguration()

Returns the current game configuration.

Returns:

The GameConfiguration, or null if not set.

getLauncherName

public java.lang.String getLauncherName()

Returns the name of the launcher.

Returns:

The launcher name.