Minecraft Versions

A complete list of all Minecraft versions and their metadata, for Java and Bedrock, releases and snapshots.

Install

Minecraft-Versions is available on npm.

Install locally using npm install minecraft-vers@latest-0.x to use in a Node project.

Install globally using npm install -g minecraft-vers@latest-0.x to use the CLI.

Usage

Node:

1const versionData = require('minecraft-vers') // old import syntax
2/*or*/
3import versionData from 'minecraft-vers' // modern import syntax

Command-line:

1mcdata [--full] <edition> <phase> [<version>] [<index>] [<param>]

Output format

1{
2  "<edition>": { // Java | Bedrock | ...
3    "<phase>":  { // Release | Beta | ....
4      "<version>": [ // 1.17 | 1.16.5-rc1 | ...
5        {
6          "name": "<in-game name>",
7          "type": "release|snapshot",
8          "parent": "null|<parent>|{phase:<phase>,version:<parent>}", // null | '1.16.3' | {phase: Release, version: 1.0.0} | ...
9          "date": "<timestamp>",
10        }
11      ]
12    }
13  }
14}

Examples

Command-line:

1$ mcdata Java Beta 1.8
2[{ "name": "Beta 1.8", "type": "release", "parent": null, "date": 2011-09-14 }]

Node:

1const versionData = require('minecraft-vers')
2
3console.log(versionData.Java.Release['1.17'])
4// [{ "name": "1.17", "type": "release", "parent": null, "date": 2021-06-08 }]
5
6console.log(versionData.Java.Beta['1.8-pre1'][0])
7// { "name": "Beta 1.8 Pre-release", "type": "snapshot", "parent": "Beta 1.8", "date": 2011-09-08 }
8
9console.log(versionData.Java.Release['1.6.3'][1].type)
10// "snapshot"

Data source

Omniarchive index, excluding speculative (yellow-shaded) versions.

Contributing

Version information is stored in the data folder.

Use node script/add to add an entry to the files.

License

This data is released into the public domain and can be used for any purpose.