node-minecraft-versions

Queries the Official Minecraft Versions JSON API provided by Mojang.

$ npm install minecraft-versions

var mcversions = require("minecraft-versions");

mcversions.query(function (err, data) {
    /**
     * data => {
     *   versions: [
     *     {
     *       id: "1.6.2",
     *       time: "2013-08-06T13:00:00+02:00",
     *       releaseTime: "2013-07-05T15:09:02+02:00",
     *       type: "release"
     *     },
     *     // ...
     *   ],
     *   latest: {
     *     snapshot: "1.6.2",
     *     release: "1.6.2"
     *   }
     * }
     */
});

In actuality, this is a simple wrapper for downloading a static file hosted on S3 by Mojang. As they add more versions to their launcher, this will become more complete.

API

mcversions.version

This property is just a String containing the URL for the versions.json file.

mcversions.query(callback)

This function just downloads the version listing and returns it via callback.

mcversions.downloadUrl(version)

This function simply returns a URL pointing to the minecraft_server.jar file corresponding to the supplied version number.

mcversions.download(version)

This function initiates a download of the corresponding minecraft_server.jar and returns a Stream (via the request module) for you to pipe wherever you see fit.

Upcoming Features:

• Conversion of time / releaseTime into Date objects
• Grouping of versions by type
• A "download latest of type" function
• A "download to file" function