node-minecraft-versions

Queries the Official Minecraft Versions JSON API provided by Mojang.

$ npm install minecraft-versions

1var mcversions = require("minecraft-versions");
2
3mcversions.query(function (err, data) {
4    /**
5     * data => {
6     *   versions: [
7     *     {
8     *       id: "1.6.2",
9     *       time: "2013-08-06T13:00:00+02:00",
10     *       releaseTime: "2013-07-05T15:09:02+02:00",
11     *       type: "release"
12     *     },
13     *     // ...
14     *   ],
15     *   latest: {
16     *     snapshot: "1.6.2",
17     *     release: "1.6.2"
18     *   }
19     * }
20     */
21});

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