Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Discord Gitter Irc Build Status

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


  • 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)
  • 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


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
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 provided:

Data Description
Effect Status/Potion effects
Language language code and their english strings
Instruments sounds emitted by blocks
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
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.

See more information about this data in the 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


The recommended way to extract the data is documented at 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 a partial protocol, entities
node-minecraft-extractor Node.js merge between 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 Inventory page windows instruments
a mineflayer PR biomes
mcwiki effects page effects 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.


Please read



Some of the data was extracted manually or automatically from and 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.


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






Sponsor this project