Authentication

You can authenticate users with different methods in your Launcher. You can use MicrosoftAuth to authenticate users with Microsoft, AzAuth to authenticate users with Azuriom, and CrackAuth to authenticate users with a crack account.

Microsoft authentication

import { MicrosoftAuth } from 'eml-lib'
import { app, BrowserWindow } from 'electron'

app.whenReady().then(auth)

async function auth() {
  // Create a simple window for demo.
  const mainWindow = new BrowserWindow()

  const auth = new MicrosoftAuth(mainWindow)

  try {
    const account = await auth.auth()
  } catch (err) {
    console.error(err)
  }
}

MicrosoftAuth constructor

Parameter	Type	Description	Required?
window	Electron.BrowserWindow	Your Electron application’s main window (to create a child window for the Microsoft login).	Yes
clientId	string	Your Microsoft application’s client ID.	No (default is Minecraft client ID)

MicrosoftAuth.auth() method

Authenticate a user with Microsoft. This method will open a child window to login.

Returns: Promise<Account> - The account information.

Throws: AUTH_ERROR - If the authentication fails.

MicrosoftAuth.validate() method

Validate a user with Microsoft. This method will check if the user’s token is still valid.

Parameter	Type	Description	Required?
user	Account	The user account to validate.	Yes

Returns: Promise<boolean> - true if the user is valid, false otherwise (then you should refresh the user).

MicrosoftAuth.refresh() method

Refresh a user with Microsoft. This method will renew the user’s token.

Parameter	Type	Description	Required?
user	Account	The user account to refresh.	Yes

Returns: Promise<Account> - The refreshed account information.

Throws: AUTH_ERROR - If the refresh fails.

Azuriom authentication

If you have a website running Azuriom, you can authenticate players with their account on your website, using AzAuth. To use AzAuth, you need to enable Auth API in your Azuriom website settings.

import { AzAuth } from 'eml-lib'

auth()

async function auth() {
  const auth = new AzAuth('https://my-azuriom-website.com')

  let account

  try {
    account = await auth.auth('GoldFrite', 'MyPassword123')
  } catch (err) {
    if (err.code === 'TWOFA_CODE_REQUIRED') {
      try {
        account = await auth.auth('GoldFrite', 'MyPassword123', '123456')
      } catch (err) {
        console.error(err)
      }
    }
    console.error(err)
  }
}

AzAuth constructor

Parameter	Type	Description	Required?
url	string	The URL of your Azuriom website.	Yes

AzAuth.auth() method

Authenticate a user with Azuriom.

Parameter	Type	Description	Required?
username	string	The username or email of the user.	Yes
password	string	The password of the user.	Yes
twoFACode	string	The two-factor authentication code.	No

Returns: Promise<Account> - The account information.

Throws: TWOFA_CODE_REQUIRED - If the two-factor authentication code is required. • AUTH_ERROR - If the authentication fails.

AzAuth.verify() method

Verify a user with Azuriom.

Parameter	Type	Description	Required?
user	Account	The user account to verify.	Yes

Returns: Promise<Account> - The account information.

Throws: AUTH_ERROR - If the verification fails.

AzAuth.logout() method

Logout a user from Azuriom.

Parameter	Type	Description	Required?
user	Account	The user account to logout.	Yes

Crack authentication

import { CrackAuth } from 'eml-lib'

const account = new CrackAuth().auth('GoldFrite')

CrackAuth.auth() method

Authenticate a user with a crack account.

Parameter	Type	Description	Required?
username	string	The username of the user.	Yes

Returns: Account - The account information.

Throws: AUTH_ERROR - If the username is invalid.