Authentication library for Microsoft, Xbox Live, and Minecraft with caching support
npm install prismarine-authQuickly and easily obtain auth tokens to authenticate with Microsoft/Xbox/Minecraft/Mojang
shell
npm install prismarine-auth
`Usage
$3
Parameters
- username? {String} - Username for authentication
- cacheDirectory? {String | Function} - Where we will store your tokens (optional) or a factory function that returns a cache.
- options {Object?}
- [flow] {enum} Required if options is specified - see API.md for options
- [forceRefresh] {boolean} - Clear all cached tokens for the specified username to get new ones on subsequent token requests
- [password] {string} - If passed we will do password based authentication.
- [authTitle] {string} - See the API.md
- [deviceType] {string} - See the API.md
- onMsaCode {Function} - (For device code auth) What we should do when we get the code. Useful for passing the code to another function.$3
$3
`js
const { Authflow, Titles } = require('prismarine-auth')const userIdentifier = 'unique identifier for caching'
const cacheDir = './' // You can leave this as undefined unless you want to specify a caching directory
const flow = new Authflow(userIdentifier, cacheDir)
// Get a auth token, then log it
flow.getMsaToken().then(console.log)
`Note: By default, this library will authenticate as Minecraft for Nintendo Switch, with a
flow set to live. For non-Minecraft applications you should
register for Microsoft Azure Oauth token. See https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app#register-an-application for more information on obtaining an Azure token. You then use it with the msal flow like this:`js
const flow = new Authflow(userIdentifier, cacheDir, { flow: 'msal', authTitle: '000-000-000-000' })
`If
flow is live, the default, then you can only specify existing Microsoft client IDs. This library exposes some default Microsoft client IDs under the exported Titles object. See the types for more information.$3
See docs/API.md
$3
`js
const { Authflow, Titles } = require('prismarine-auth')const userIdentifier = 'any unique identifier'
const cacheDir = './' // You can leave this as undefined unless you want to specify a caching directory
const flow = new Authflow(userIdentifier, cacheDir)
// Get a Minecraft Java Edition auth token, then log it
flow.getMinecraftJavaToken({ fetchProfile: true }).then(console.log)
`$3
`json
{
"token": "ey....................",
"entitlements": {},
"profile": {
"id": "b945b6ed99b548675309473a69661b9a",
"name": "Usname",
"skins": [ [Object] ],
"capes": []
}
}
`$3
See docs/API.md and example.$3
`js
const { Authflow, Titles } = require('prismarine-auth')const userIdentifier = 'any unique identifier'
const cacheDir = './' // You can leave this as undefined unless you want to specify a caching directory
const flow = new Authflow(userIdentifier, cacheDir)
// Get a Minecraft Services token, then log it
flow.getMinecraftBedrockServicesToken().then(console.log)
`$3
`json
{
"mcToken": "MCToken eyJ...",
"validUntil": "1970-01-01T00:00:00.000Z",
"treatments": [
"mc-enable-feedback-landing-page",
"mc-store-enableinbox",
"mc-nps-freeorpaid-paidaug24",
// and more
],
"configurations": {
"validation": {
"id": "Validation",
"parameters": {
"minecraftnetaatest": "false"
}
},
"minecraft": {
"id": "Minecraft",
"parameters": {
"with-spongebobadd-button-noswitch": "true",
"sfsdfsdfsfss": "true",
"fsdfd": "true",
"mc-maelstrom-disable": "true",
// and more
}
}
},
"treatmentContext": "mc-sunsetting_5:31118471;mc-..."
}
`$3
View more examples here.See the types to checkout the full API.
API
See docs/API.md
Debugging
You can enable some debugging output using the
DEBUG enviroment variable. Through node.js, you can add process.env.DEBUG = 'prismarine-auth' at the top of your code.
Testing
Simply run
npm test or yarn test`