Minecraft-auth is a package to authenticate and get minecraft access tokens.
Authentication Types:
- Mojang Authentication - standard mojang authentication using username and password
- Microsoft Authentication - new Microsoft oauth authentication to login to new accounts / migrated to microsoft. Read how to setup it here
- Cracked Authentication - non premium offline mode authentication. Requires only username.
Mojang API:
Package contains MojangApi class which can be used to fetch other users skins, uuids, check server status and more.
Version 2.0.0 changes how Microsoft Authentication works.
- Azure application should be registered with
Mobile and desktop applications
type - parameters in Setup and listenForCode functions changed
All authentication errors are thrown by using AuthenticationError or OwnershipError classes they all extend Error class.
AuthenticationError also contains additionalInfo: string
npm i --save minecraft-auth
Importing:
import * as minecraftAuth from "./src/index";
//or
const minecraftAuth = require("./src/index.ts");
- Mojang Authentication:
let account = new minecraftAuth.MojangAccount();
await account.Login("email","password");
- Microsoft Authentication:
const MicrosoftAuth = minecraftAuth.MicrosoftAuth;
let account = new minecraftAuth.MicrosoftAccount();
MicrosoftAuth.setup({appID:"747bf062-ab9c-4690-842d-a77d18d4cf82"});
let code = await MicrosoftAuth.listenForCode();
if(code !== undefined){
await account.authFlow(code);
}
- Cracked Authentication:
let account = new minecraftAuth.CrackedAccount("username");
//any type of authentication eg. from above examples
console.log(account.accessToken);
await account.getProfile();
console.log(account.username); //Username of the account
console.log(account.uuid); //UUID of the account (without dashes)
console.log(account.ownership); //Does account even have minecraft
console.log(account.profile) //User profile - skins, capes, uuid, username
console.log(account.profile.skins[0].url) //URL of the 1st skin.
AccountsStorage is a storage for your accounts.
You can add new account with AccountsStorage::addAccount(account)
You can remove account with AccountsStorage::removeAccount(account)
You can get accounts with:
getAccount(index)
getAccountByName(name)
getAccountByUUID(uuid)
serialize
converts storage to JSON string to save in filedeserialize
converts string to AccountStorage object