{"id":16330360,"url":"https://github.com/nixinova/minecraft-versions","last_synced_at":"2026-04-02T01:54:25.441Z","repository":{"id":42033176,"uuid":"374218144","full_name":"Nixinova/Minecraft-Versions","owner":"Nixinova","description":"A complete list of all Minecraft versions and metadata, Java and Bedrock, release and snapshot.","archived":false,"fork":false,"pushed_at":"2024-04-09T11:48:31.000Z","size":119,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-09T15:35:03.305Z","etag":null,"topics":["minecraft","minecraft-data","minecraft-java","minecraft-versions","nixinova","versions"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nixinova.png","metadata":{"files":{"readme":"readme.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-06-05T21:48:55.000Z","updated_at":"2024-04-15T10:55:19.157Z","dependencies_parsed_at":"2024-04-15T10:55:15.162Z","dependency_job_id":null,"html_url":"https://github.com/Nixinova/Minecraft-Versions","commit_stats":{"total_commits":37,"total_committers":4,"mean_commits":9.25,"dds":0.5135135135135135,"last_synced_commit":"884851432b61f6a298b01b13e4158c5965d03643"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nixinova%2FMinecraft-Versions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nixinova%2FMinecraft-Versions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nixinova%2FMinecraft-Versions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nixinova%2FMinecraft-Versions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nixinova","download_url":"https://codeload.github.com/Nixinova/Minecraft-Versions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245028692,"owners_count":20549565,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft","minecraft-data","minecraft-java","minecraft-versions","nixinova","versions"],"created_at":"2024-10-10T23:19:04.179Z","updated_at":"2026-04-02T01:54:25.400Z","avatar_url":"https://github.com/Nixinova.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Latest version](https://img.shields.io/github/v/release/Nixinova/Minecraft-Versions?label=latest%20version\u0026style=flat-square)](https://github.com/Nixinova/Minecraft-Versions/releases)\n[![Last updated](https://img.shields.io/github/release-date/Nixinova/Minecraft-Versions?label=updated\u0026style=flat-square)](https://github.com/Nixinova/Minecraft-Versions/releases)\n[![npm downloads](https://img.shields.io/npm/dt/minecraft-vers?logo=npm)](https://www.npmjs.com/package/minecraft-vers)\n\n# Minecraft Versions\n\nA complete list of all Minecraft versions and their metadata, for Java and Bedrock, releases and snapshots.\n\n## Install\n\nMinecraft-Versions is available [on npm](https://npmjs.com/package/minecraft-vers).\n\nInstall locally using `npm install minecraft-vers@latest-0.x` to use in a Node project.\n\nInstall globally using `npm install -g minecraft-vers@latest-0.x` to use the CLI.\n\n## Usage\n\nNode:\n\n```js\nconst versionData = require('minecraft-vers') // old import syntax\n/*or*/\nimport versionData from 'minecraft-vers' // modern import syntax\n```\n\nCommand-line:\n\n```cmd\nmcdata [--full] \u003cedition\u003e \u003cphase\u003e [\u003cversion\u003e] [\u003cindex\u003e] [\u003cparam\u003e]\n```\n\n### Output format\n\n```jsonc\n{\n  \"\u003cedition\u003e\": { // Java | Bedrock | ...\n    \"\u003cphase\u003e\":  { // Release | Beta | ....\n      \"\u003cversion\u003e\": [ // 1.17 | 1.16.5-rc1 | ...\n        {\n          \"name\": \"\u003cin-game name\u003e\",\n          \"type\": \"release|snapshot\",\n          \"parent\": \"null|\u003cparent\u003e|{phase:\u003cphase\u003e,version:\u003cparent\u003e}\", // null | '1.16.3' | {phase: Release, version: 1.0.0} | ...\n          \"date\": \"\u003ctimestamp\u003e\",\n        }\n      ]\n    }\n  }\n}\n```\n\n### Examples\n\nCommand-line:\n\n```cmd\n$ mcdata Java Beta 1.8\n[{ \"name\": \"Beta 1.8\", \"type\": \"release\", \"parent\": null, \"date\": 2011-09-14 }]\n```\n\nNode:\n\n```js\nconst versionData = require('minecraft-vers')\n\nconsole.log(versionData.Java.Release['1.17'])\n// [{ \"name\": \"1.17\", \"type\": \"release\", \"parent\": null, \"date\": 2021-06-08 }]\n\nconsole.log(versionData.Java.Beta['1.8-pre1'][0])\n// { \"name\": \"Beta 1.8 Pre-release\", \"type\": \"snapshot\", \"parent\": \"Beta 1.8\", \"date\": 2011-09-08 }\n\nconsole.log(versionData.Java.Release['1.6.3'][1].type)\n// \"snapshot\"\n```\n\n## Data source\n\n[Omniarchive index](https://docs.google.com/spreadsheets/d/1OCxMNQLeZJi4BlKKwHx2OlzktKiLEwFXnmCrSdAFwYQ/htmlview), excluding speculative (yellow-shaded) versions.\n\n## Contributing\n\nVersion information is stored in the [data](data/) folder.\n\nUse `node script/add` to add an entry to the files.\n\n## License\n\nThis data is released into the public domain and can be used for any purpose.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnixinova%2Fminecraft-versions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnixinova%2Fminecraft-versions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnixinova%2Fminecraft-versions/lists"}