minecraft data raw code

2026-03-22 19:49:37 +01:00
parent 2d1e8ef4f6
commit f7401a287e
1130 changed files with 14385838 additions and 0 deletions
@@ -0,0 +1,54 @@
+## minecraft bedrock edition data
+
+### Obtaining data
+
+| file name | info | how to get | schema |
+|-|-|-|-|
+| blockStates.json | Contains the global block palette for a Minecraft version. <br>Contains all of the possible block states. <br><br><br>The index of a Block State instance here is the paletted ID, <br>which can be used to idenfify this block state<br>instead of a string. | [bedrock-extractor][1] ("BlockStates.json" file) |  |
+| steve.json | Skin data for clients connecting to BE servers, for default Steve character | [bedrock-protocol][2] (capture from proxy) |  |
+| blockMappings.json | Output of bedrock-extractor |
+| language.json | Translation keys and their English string values. | [extract-minecraft-lang][3] (run for new version, then copy the JSON file to minecraft-data) | |
+
+### Updating protocol data
+
+* To update bedrock protocol data, open `data/bedrock/latest` (or replace "latest" with some older version) and update the `proto.yml` and `types.yml` files.
+* Go to `tools/js`, run `npm install` then `npm run build` to update the protodef JSON files
+
+To update to a new protocol version:
+* Copy `data/bedrock/latest` files into the old version's folder.
+* Open `data/bedrock/latest` and update the `proto.yml` and `types.yml` files and update the `!version` part at the top
+* Go to `tools/js`, run `npm install` then `npm run build` to update the protodef JSON files
+
+
+then run `npm test` to test validity
+
+### Status of data
+
+<!--StartFragment-->
+file name | have? | how to get it | notes
+-- | -- | -- | --
+protocol.json | ✔ | manual updated | wip
+blocks.json | ✔ | bedrock-extractor | &nbsp;
+items.json | ✔ | bedrock-extractor | &nbsp;
+entities.json | ✔ | bedrock-extractor  | &nbsp;
+recipes.json | ✔ |  bedrock-protocol dumper | new schema: adds furnace and other special recipes. <br/> Some recipes can have multiple outputs, also allow for recipe ingredients with damage values and specific counts.
+blockCollisionShapes.json | ✔ | (from pc data) | New schema: block IDs map to an array of block state indexes, to get the block stateID, minStateId + index of array. This way different copies of the block with different state IDs can have unique collisions. 
+commands.json | ❌ | bedrock-protocol + dumper | must be custom schema, current JE schema too low level
+biomes.json | ✔ | bedrock-extractor (via Amulet) | 
+instruments | ✔ | manual | &nbsp;
+materials.json | 🔵 | (from pc data) | &nbsp;
+windows.json | ✔ | manual obtained via proxy | &nbsp;
+version.json | ✔ | from bedrock-protocol | 
+effects.json | ❌ | (from pc data) | &nbsp;
+enchantments.json | ✔ | bedrock-extractor (via Geyser -> pc data) | &nbsp;
+language.json | ✔ | [extract-minecraft-lang][3] (extract from dedicated server) | &nbsp;
+particles.json | 🔵 | bedrock-protocol docs | IDs not needed, handled in protocol
+blockLoot.json | 🔵 | manual data for 1.18 | &nbsp;
+entityLoot.json | 🔵 | manual data for 1.18 | &nbsp;
+mapIcons.json | 🔵 | ? | ?
+
+<!--EndFragment-->
+
+[1]: https://github.com/extremeheat/minecraft-data-extractor/tree/master/bedrock
+[2]: https://github.com/PrismarineJS/bedrock-protocol
+[3]: https://github.com/CreeperG16/extract-minecraft-lang