# minecraft-data

> Provide easy access to minecraft data in node.js

Latest version **3.116.0** (published 2026-09-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install minecraft-data
pnpm add minecraft-data
yarn add minecraft-data
bun add minecraft-data
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support; large bundle.

## Facts

| | |
|---|---|
| Version | 3.116.0 |
| Published | 2026-09-05 |
| First published | 2015-03-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 427.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 127 |
| Author | Romain Beaumont |
| Maintainers | rom1504 |
| Keywords | minecraft, data, node.js |

## Links

- npm: https://www.npmjs.com/package/minecraft-data
- Repository: https://github.com/PrismarineJS/node-minecraft-data
- Homepage: https://github.com/PrismarineJS/node-minecraft-data#readme
- Issues: https://github.com/PrismarineJS/node-minecraft-data/issues
- npm.io page: https://npm.io/package/minecraft-data

## Alternatives

- [gamedig](https://npm.io/package/gamedig.md) — 29.3K weekly downloads
- [join-monster](https://npm.io/package/join-monster.md) — 12.8K weekly downloads
- [masked](https://npm.io/package/masked.md) — 5.5K weekly downloads
- [@comunica/actor-query-process-explain-logical](https://npm.io/package/@comunica/actor-query-process-explain-logical.md) — 4.7K weekly downloads
- [@veracity/vui](https://npm.io/package/@veracity/vui.md) — 4.6K weekly downloads

## Recent versions

- 3.116.0 (latest) — 2026-09-05
- 3.115.0 — 2026-08-31
- 3.114.0 — 2026-08-27
- 3.113.2 — 2026-08-15
- 3.113.1 — 2026-08-11
- 3.113.0 — 2026-08-07
- 3.112.0 — 2026-07-28
- 3.111.0 — 2026-06-18
- 3.110.2 — 2026-05-13
- 3.110.1 — 2026-05-12
- 3.110.0 — 2026-05-09
- 3.109.1 — 2026-04-26
- 3.109.0 — 2026-03-30
- 3.108.0 — 2026-03-30
- 3.107.0 — 2026-03-30
- … 350 more at https://npm.io/package/minecraft-data/versions

## README

# node-minecraft-data

[![NPM version](https://badge.fury.io/js/minecraft-data.svg)](http://badge.fury.io/js/minecraft-data)
[![Tonic](https://img.shields.io/badge/tonic-try%20it-blue.svg)](https://tonicdev.com/npm/minecraft-data)
[![Build Status](https://github.com/PrismarineJS/node-minecraft-data/workflows/CI/badge.svg)](https://github.com/PrismarineJS/node-minecraft-data/actions?query=workflow%3A%22CI%22)
[![Try it on gitpod](https://img.shields.io/badge/try-on%20gitpod-brightgreen.svg)](https://gitpod.io/#https://github.com/PrismarineJS/node-minecraft-data)

`node-minecraft-data` provides easy access to [minecraft-data](https://github.com/PrismarineJS/minecraft-data) in node.js.

The objective of this module is to make easier to look for information in `minecraft-data` in node.

## Features

This package allows the lookup of blocks, items, entities, etc. by name, id, etc., and for the easy lookup of other data.

## Example

```js
const minecraftData = require('minecraft-data')
// or for es6: import minecraftData from 'minecraft-data';

const mcData = minecraftData('1.19')

console.log(mcData.blocksByName['stone']) // Information for "Stone"
console.log(mcData.windows['minecraft:brewing_stand']) // Information for the "Brewing Stand" GUI
console.log(mcData.version) // Information about the current version
console.log(mcData.effectsByName['Haste']) // Information for the "Haste" effect
```

## Documentation

* See [doc/api.md](doc/api.md)
* See [doc/history.md](doc/history.md)

---
_Source: https://npm.io/package/minecraft-data · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._