npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@nymph-ai/minecraft-data

v3.102.4

Published

Provide easy access to minecraft data in node.js

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

nymphainymphai

Keywords

minecraftdatanode.js

Readme

minecraft-data

Discord Gitter Irc Build Status

Language independent module providing minecraft data for minecraft clients, servers and libraries.

Supports

  • Minecraft PC version 0.30c (classic), 1.7.10, 1.8.8, 1.9 (15w40b, 1.9, 1.9.1-pre2, 1.9.2, 1.9.4), 1.10 (16w20a, 1.10-pre1, 1.10, 1.10.1, 1.10.2), 1.11 (16w35a, 1.11, 1.11.2), 1.12 (17w15a, 17w18b, 1.12-pre4, 1.12, 1.12.1, 1.12.2), 1.13 (17w50a, 1.13, 1.13.1, 1.13.2-pre1, 1.13.2-pre2, 1.13.2), 1.14 (1.14, 1.14.1, 1.14.3, 1.14.4), 1.15 (1.15, 1.15.1, 1.15.2), 1.16 (20w13b, 20w14a, 1.16-rc1, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5), 1.17, 1.17.1, 1.18 (1.18, 1.18.1, 1.18.2), 1.19 (1.19, 1.19.2, 1.19.3, 1.19.4), 1.20 (1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6), 1.21 (1.21, 1.21.1, 1.21.3), 1.21.8
  • Minecraft bedrock version 0.14, 0.15, 1.0, 1.16.201, 1.16.210, 1.16.220, 1.17.0, 1.17.10, 1.17.30, 1.17.40, 1.18.0, 1.18.11, 1.18.30, 1.19.1, 1.19.10, 1.19.20, 1.19.21, 1.19.30, 1.19.40, 1.19.50, 1.19.60, 1.19.62, 1.19.63, 1.19.70, 1.19.80, 1.20.0, 1.20.10, 1.20.30, 1.20.40, 1.20.50, 1.20.61, 1.20.71, 1.20.80, 1.21.0, 1.21.2, 1.21.20, 1.21.30, 1.21.42, 1.21.50, 1.21.60, 1.21.70, 1.21.80, 1.21.90, 1.21.93, 1.21.100, 1.21.111, 1.21.120, 1.21.124, 1.21.130

Wrappers

Minecraft-data is language independent, you can use it with these language specific modules :

| Wrapper name | Language | Data provided | | --- | --- | --- | | node-minecraft-data | Node.js | everything | | python-minecraft-data | python | everything | | minebase | python | everything | | McData | Elixir | protocol | | ProtocolGen | java | generated java files from protocol.json to read and write minecraft packets | | mcdata | Go | everything | | minecraft-data-rs | Rust | everything |

If you want to use minecraft-data in a new language, we advise you to create a new wrapper

Data

Data provided:

| Data | Description | | --- | --- | | Biomes | | | Blocks | | | Enchantment | | | Effect | Status/Potion effects | | Entities | | | Language | language code and their english strings | | Instruments | sounds emitted by blocks | | Items | | | Map icons | Provides all available map icons as used by (crafted) maps | | Materials | to be used with blocks data. Provides tool speed multipliers against material types. | | Particles | Id and names of minecraft particles | | Protocol | a complete description of the protocol, can be used to automatically implement the protocol, see protodef doc | | Protocol Versions | the whole list of minecraft protocol versions | | Recipes | to be used with blocks and items data | | Windows | the different kind of windows and their characteristics | | Version | | | Versions | all the versions supported in minecraft-data | | Block collision shapes | | | Foods | list of foods each with there id, saturation, foodpoints and more | | Commands | a tree structure for vanilla minecraft server commands, and some info needed to implement sub-parsers. | Legacy | mappings between legacy (1.12) and post-flattening (1.13+) blocks and items ids | Skin data | (bedrock edition) Skin geometry and texture data for steve skin | Features | This can be used to check is a specific feature is available in the current Minecraft version. This is usually only required for handling version-specific functionality. | Sounds | For versions that use a sound id over the network (1.9+) this provides mappings between network sound id and sound name.

See more information about this data in the documentation

Documentation

Projects using minecraft-data

These are the projects that use minecraft-data:

| Project name | Language | Project type | Data used | | --- | --- | --- | --- | | mineflayer | Node.js | bot library | biomes, blocks, entities, instruments, items, materials, recipes | | node-minecraft-protocol | Node.js | protocol serialization | protocol | | flying-squid | Node.js | server library | biomes, blocks, materials | | SpockBot | Python | bot library | biomes, blocks, items, materials, windows, recipes | | PhaseBot | Java | bot | blocks, items, materials | | McEx | Elixir | server | blocks | | VoxelGamesLib | Java | minigames server library | blocks, items | | Phpcraft | PHP | all-around library | blocks, items, entities, protocol | | MineSharp | C# | Bots | Protocol, Blocks, Items, Entities, Biomes, Recipes, Enchantments |

Extraction

Java Edition

The recommended way to extract the data is documented at add-data-new-version.md.

The minecraft-data-auto-updater calls minecraft-data-generator-server.

Bedrock Edition

See bedrock.md for information on updating data.

Specifically, minecraft-data-auto-updater calls minecraft-data-generator-server

Projects that provide data:

| Project name | Language | Source | Data provided | | --- | --- | --- | --- | | minecraft-wiki-extractor | Node.js | minecraft wiki | blocks, items, entities, recipes | | mcdevs-wiki-extractor | Node.js | wiki.vg | a partial protocol, entities | | node-minecraft-extractor | Node.js | merge between wiki.vg and mcwiki | a complete entities file | | minecraft-jar-extractor | Node.js | minecraft server jar | a very partial but completely up to date protocol | | minecraft-jar-extractor in python | Python | minecraft server jar | about the same protocol information as minecraft-jar-extractor in node.js | | burger with burger-extractor | Node.js | minecraft server jar | used to provide items, blocks, biomes and recipes | | burger 1.16 | --//-- | --// -- | --//-- | | command-generator | Python | Minecraft data generator | Data used for parsing all vanilla server commands. | | minecraft-data-generator | Java | minecraft client | biomes, block collision shapes, blocks, effects, enchantments, entities, foods, items, particles, tints. Required Fabric updated to the provided minecraft version. |

Pages interesting to manually update the data if necessary:

| Page | Data | | ---- | ---- | | wiki.vg Inventory page | windows | | wiki.vg | instruments | | a mineflayer PR | biomes | | mcwiki effects page | effects | | wiki.vg protocol version numbers | protocolVersions |

Data quality

Minecraft data provides scripts to audit the data, they can be useful to check the data is correct :

Minecraft data also provides json schemas in enums_schemas/ that are used in test/test.js to check the json file are valid relative to these schemas. These schemas can also be used to understand better how the json files are formatted in order to use it.

Contribute

Please read https://github.com/PrismarineJS/prismarine-contribute

License

MIT

Some of the data was extracted manually or automatically from wiki.vg and minecraft.gamepedia.com. If required by one of the sources the license might change to something more appropriate.

Related project

minecraft-assets which provide minecraft assets along with json files that help to use them.