Skip to content
Go to file


Failed to load latest commit information.


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) and 1.16 (20w13b, 20w14a, 1.16-rc1, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4)
  • Minecraft PE version 0.14, 0.15 and 1.0


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

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
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
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 collison 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.

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
Minecraft Item Browser (Repo) Javascript Web-based recipe search tool blocks, items, recipes


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.

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.



You can’t perform that action at this time.