https://github.com/nixinova/minecraft-versions

A complete list of all Minecraft versions and metadata, Java and Bedrock, release and snapshot.
https://github.com/nixinova/minecraft-versions

minecraft minecraft-data minecraft-java minecraft-versions nixinova versions

Last synced: 19 days ago
JSON representation

A complete list of all Minecraft versions and metadata, Java and Bedrock, release and snapshot.

• Host: GitHub
• URL: https://github.com/nixinova/minecraft-versions
• Owner: Nixinova
• License: other
• Created: 2021-06-05T21:48:55.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-04-09T11:48:31.000Z (7 months ago)
• Last Synced: 2024-04-09T15:35:03.305Z (7 months ago)
• Topics: minecraft, minecraft-data, minecraft-java, minecraft-versions, nixinova, versions
• Language: TypeScript
• Homepage:
• Size: 116 KB
• Stars: 8
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • Changelog: changelog.md
  • License: license.md

Awesome Lists containing this project

README

        
[![Latest version](https://img.shields.io/github/v/release/Nixinova/Minecraft-Versions?label=latest%20version&style=flat-square)](https://github.com/Nixinova/Minecraft-Versions/releases)

[![Last updated](https://img.shields.io/github/release-date/Nixinova/Minecraft-Versions?label=updated&style=flat-square)](https://github.com/Nixinova/Minecraft-Versions/releases)

[![npm downloads](https://img.shields.io/npm/dt/minecraft-vers?logo=npm)](https://www.npmjs.com/package/minecraft-vers)

# 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](https://npmjs.com/package/minecraft-vers).

Install locally using `npm install [email protected]` to use in a Node project.

Install globally using `npm install -g [email protected]` to use the CLI.

## Usage

Node:

```js

const versionData = require('minecraft-vers') // old import syntax

/*or*/

import versionData from 'minecraft-vers' // modern import syntax

```

Command-line:

```cmd

mcdata [--full]   [] [] []

```

### Output format

```jsonc

{

  "": { // Java | Bedrock | ...

    "":  { // Release | Beta | ....

      "": [ // 1.17 | 1.16.5-rc1 | ...

        {

          "name": "",

          "type": "release|snapshot",

          "parent": "null||{phase:,version:}", // null | '1.16.3' | {phase: Release, version: 1.0.0} | ...

          "date": "",

        }

      ]

    }

  }

}

```

### Examples

Command-line:

```cmd

$ mcdata Java Beta 1.8

[{ "name": "Beta 1.8", "type": "release", "parent": null, "date": 2011-09-14 }]

```

Node:

```js

const versionData = require('minecraft-vers')

console.log(versionData.Java.Release['1.17'])

// [{ "name": "1.17", "type": "release", "parent": null, "date": 2021-06-08 }]

console.log(versionData.Java.Beta['1.8-pre1'][0])

// { "name": "Beta 1.8 Pre-release", "type": "snapshot", "parent": "Beta 1.8", "date": 2011-09-08 }

console.log(versionData.Java.Release['1.6.3'][1].type)

// "snapshot"

```

## Data source

[Omniarchive index](https://docs.google.com/spreadsheets/d/1OCxMNQLeZJi4BlKKwHx2OlzktKiLEwFXnmCrSdAFwYQ/htmlview), excluding speculative (yellow-shaded) versions.

## Contributing

Version information is stored in the [data](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.