yggdrasil

yggdrasil

A Node.js client for doing requests to yggdrasil, the Mojang authentication system, used for Minecraft and Scrolls. There's already one other client out there (at the time of writing) but I don't like it, so I wrote this one.

Usage

$ npm install yggdrasil

Client

//init
var ygg = require('yggdrasil')({
    //Optional settings object
    host: 'https://authserver.mojang.com' //Optional custom host. No trailing slash.
});

//Authenticate a user
ygg.auth({
    token: '', //Optional. Client token.
    agent: '', //Agent name. Defaults to 'Minecraft'
    version: 1, //Agent version. Defaults to 1
    user: '', //Username
    pass: '' //Password
}, function(err, data){});

//Refresh an accessToken
ygg.refresh(oldtoken, clienttoken, function(err, newtoken, responce body){});

//Validate an accessToken
ygg.validate(token, function(isvalid, err){});

//Invalidate all accessTokens
ygg.signout(username, password, function(worked, err));

Server

//todo Read the source code for now.

Further Reading

• Authentication protocol documentation
• node-minecraft-protocol, a Minecraft client and server in Node.js
• prismarine-yggdrasil, another yggdrasil client that node-yggdrasil will be replacing.