Data pack

This article is about the data pack system. For the command, see Commands/datapack. For the resource pack system, see Resource pack.

The data pack system provides a way for players to further customize their Minecraft experience. Data packs can be used to override or add new advancements, functions, loot tables, structures, recipes and tags without any code modification.

Usage

Data packs can be placed in the .minecraft/saves/(world)/datapacks folder of a world. Each data pack is either a sub-folder or a .zip file within the datapacks folder. After it is in the folder, a data pack will be enabled for that world.

Data packs will load their data based on the load order. This order can be seen and altered by using the /datapack command.

Contents

Folder structure

(data pack name) pack.mcmeta data (namespace) advancements (advancement).json functions (function).mcfunction loot_tables (loot_table).json recipes (recipe).json structures (structure).nbt tags blocks (tag).json items (tag).json functions (tag).json

pack.mcmeta

A data pack is identified by Minecraft based on the presence of the pack.mcmeta file in the root directory of the data pack, which contains data in JSON format.

• •  pack: Holds the data pack information.
    •  pack_format: Pack version. Can be any number.
    •  description: A description. This string must exist but can be empty. This description will show when hovering over the data pack in the data pack list.

data

This folder contains all the data under one or multiple "namespaces". It can contain advancements, functions, loot_tables, structures, recipes and/or tags folders. A namespace is used to identify the data and like all file and folder names inside the data folder it should only contain lowercase alphanumerical characters, -, _, and .. It is advised to use a unique namespace to prevent clashes between multiple datapacks. The minecraft namespace should only be used when overwriting default data.

Each advancement, function, loot table, structure, recipe and tag file can be placed directly in their respective folder but sub-folders are also allowed.

History

upcoming
1.13 {{Extension DPL}}<ul><li>[[Mushroom Stew|Mushroom Stew]]<br/>{{Item | title = Mushroom Stew | image = Mushroom Stew.png | renewable = Yes | heals = {{hunger|6}} | stackable = No }} '''Mushroom stew''' is a [[food]] item. == Obtaining == === Harvesting === Mushroom stew can be obtained by “milking” a [[mooshroom]] with an empty [[bowl]]. This is accomplished by {{Control|using}} a bowl on a mooshroom. The bowl gets replaced by the mushroom stew item. There is no cooldown for doing so. If a stack of more than one bowl is used on a mooshroom, only one bowl is consumed, and the mushroom stew goes into an empty inventory slot, or is dropped if the player's inventory is full. === Crafting === {{Crafting |Red Mushroom |Brown Mushroom |Bowl |Output= Mushroom Stew |type= Foodstuff }} == Usage == === Food === {{see also|Tutorials/Hunger management|title1=Hunger management}} To eat mushroom stew, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|6}} [[hunger]] and 7.2 hunger [[Hunger#Mechanics|saturation]]. The bowl is returned to the player empty after the mushroom stew has been eaten, and can be reused to craft more, similarly to [[Rabbit Stew|rabbit stew]] and [[Beetroot Soup|beetroot soup]]. == Sounds == === Generic === {{Sound table/Entity/Food}} === Unique === {{Edition|Java}}: {{Sound table |sound=Mooshroom milk1.ogg |sound2=Mooshroom milk2.ogg |sound3=Mooshroom milk3.ogg |subtitle=Mooshroom gets milked |source=neutral |description=When a mooshroom is milked with a bowl |id=entity.mooshroom.milk |translationkey=subtitles.entity.mooshroom.milk |volume=1.0 |pitch=''varies'' <ref group=sound name=milkpitch>Can be 1.0, 0.9, or 1.1 for each sound</ref> |distance=16 |foot=1}} {{Edition|Bedrock}}: {{Sound table |type=bedrock |sound=Mooshroom milk1.ogg |sound2=Mooshroom milk2.ogg |sound3=Mooshroom milk3.ogg |subtitle=Mooshroom gets milked |source=Friendly Creatures |description=When a mooshroom is milked with a bowl |id=mob.mooshroom.suspicious_milk |volume=1.0/0.9/1.1 |pitch=1.0 |foot=1}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Mushroom Stew |spritetype=item |nameid=mushroom_stew |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Mushroom Stew |spritetype=item |nameid=mushroom_stew |id=260 |form=item |foot=1}} == Advancements == {{load advancements|Husbandry;A Balanced Diet}} == History == {{History|java indev}} {{History||0.31|snap=20100130|[[File:Mushroom Stew JE1 BE1.png|32px]] Added mushroom stew. |Restores {{hp|8}} [[health]].}} {{History||20100206|Mushroom stew now restores {{hp|10}} health.}} {{History|java beta}} {{History||1.6|snap=Test Build 3|[[Mushroom]] spreading mechanic added, making mushroom stew [[renewable]].}} {{History||1.8|snap=Pre-release|Now restores {{hunger|8}} [[hunger]].}} {{History|java}} {{History||1.0.0|snap=Beta 1.9 Prerelease|More fungi sources have now been introduced with the addition of the [[Mushroom Fields|mushroom biome]]. |A [[mooshroom]] can now be "milked" with a [[bowl]] to obtain mushroom stew.}} {{History|||snap=Beta 1.9 Prerelease 3|Mushroom stew can now be crafted in the [[2×2 crafting grid]] in the [[inventory]]. Previously, the crafting recipe was shaped, now it's shapeless.}} {{History||1.2.5|snap=release|The [[player]] milking a [[mooshroom]] with a stack of [[bowl]]s no longer results in receiving back a single bowl of mushroom stew.}} {{History||1.4.2|snap=?|Mushroom stew now restores {{Hunger|6}} instead of {{Hunger|8}}.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 282.}} {{History||1.14|snap=18w43a|[[File:Mushroom Stew JE2 BE2.png|32px]] The texture of mushroom stew has now been changed.}} {{History||1.16|snap=Pre-release 1|Mooshrooms can now be milked for mushroom stew in Creative mode.<ref>{{Cite bug|MC|90969|Cannot get mushroom stew from mooshrooms / milk from cows in creative mode|date=October 19, 2015}}</ref>}} {{History|pocket alpha}} {{History||v0.4.0|[[File:Mushroom Stew JE1 BE1.png|32px]] Added mushroom stew.}} {{History||v0.5.0|Mushroom stew now restores {{hp|8}} instead of {{hp|4}}.}} {{History||v0.9.0|snap=build 1|A mooshroom can now be "milked" with a [[bowl]] to obtain mushroom stew.}} {{History||v0.12.1|snap=build 1|Mushroom stew now restores [[hunger]] instead of [[health]].}} {{History|bedrock}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Mushroom Stew JE2 BE2.png|32px]] The texture of mushroom stew has now been changed.}} {{History|console}} {{History||xbox=TU1|xbone=CU1|ps=1.0|switch=1.0.1|wiiu=Patch 1|[[File:Mushroom Stew JE1 BE1.png|32px]] Added mushroom stew.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Mushroom Stew JE2 BE2.png|32px]] The texture of mushroom stew has now been changed.}} {{History|new3ds}} {{History||0.1.0|[[File:Mushroom Stew JE1 BE1.png|32px]] Added mushroom stew.}} {{History|foot}} == Issues == {{Issue list}} == References == {{reflist}} == External Links == *[https://www.minecraft.net/en-us/article/taking-inventory--mushroom-stew Taking Inventory: Mushroom Stew] – Minecraft.net on September 1, 2022 {{items}} [[de:Pilzsuppe]] [[es:Estofado de champiñones]] [[fr:Soupe de champignons]] [[hu:Gombaragu]] [[ja:キノコシチュー]] [[ko:버섯 스튜]] [[nl:Paddenstoelenstoofpot]] [[pl:Zupa grzybowa]] [[pt:Ensopado de cogumelos]] [[ru:Тушёные грибы]] [[zh:蘑菇煲]] [[Category:Food]] [[Category:Renewable resources]] <references /></li><li>[[Emerald|Emerald]]<br/>{{About|the item|the currency in ''Minecraft Dungeons''|MCD:Emerald|the skin|MCD:Emerald (skin)|the ore|Emerald Ore|the mineral block|Block of Emerald}} {{Item | image = Emerald.png | renewable = Yes | stackable = Yes (64) | rarity = Common}} '''Emeralds''' are rare minerals that are used primarily as the currency for [[trading]] with [[villager]]s and [[wandering trader]]s. Naturally-occurring emeralds are rarer than [[diamond]]s. == Obtaining == === Trading (how emerald is renewable) === {{main|Trading}} Emeralds can be obtained by trading with [[villager]]s, since they are the currency that villagers use for trading. Villagers either buy or sell specific goods for emeralds. Some villagers trade stuff that is renewable with emerald. === Mining === [[Emerald ore]] drops one emerald when mined using an iron or better [[pickaxe]]. If the pickaxe is enchanted with [[Fortune]], it may drop an extra emerald per level of Fortune, up to a maximum of 4 emeralds with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops itself in ore form instead of an emerald. === Crafting === {{Crafting |Block of Emerald |Output= Emerald,9 |type= Material }} === Smelting === {{Smelting |Emerald Ore; Deepslate Emerald Ore |Emerald |1 }} === Natural generation === {{see also|Emerald Ore#Natural generation}} Emeralds can generate in [[chest]]s in some [[village]] houses or other generated [[Generated structures|structures]]. {{needs update|inaccurate=1|section=1}} {{LootChestItem|emerald}} === Drops === [[Vindicator]]s and [[evoker]]s drop 0–1 emeralds upon death. [[Looting]] increases the maximum emerald drop by one per level, for a maximum of 4 emeralds with Looting III. [[Fox]]es that are holding emeralds also have a chance of 100% to drop the emerald they are holding upon death. Alternatively, the player can drop a food item to entice the fox to drop the emerald without killing it. {{IN|bedrock}}, vindicators and [[pillager]]s spawned from [[raids]] can drop 0–1 emeralds. Depending on difficulty, vindicators and pillagers spawned from raids also have a chance of dropping additional emeralds. There is a 65% chance of dropping on easy and normal, and an 80% chance of dropping on hard. If this additional drop condition is met, different emerald counts can drop with different chances. There is a {{frac|10|39}} chance to drop an additional 0–1 emeralds, a {{frac|5|39}} chance to drop an additional 2–3, and a {{frac|2|39}} chance to drop an additional 4–5. {{IN|bedrock}}, with Looting III, it is possible for a vindicator in a raid to drop up to 16 emeralds upon death (vindicator drops + raid drops + an additional drop<!-- emerald from 2/39 chance-->). == Usage == === Trading === {{main|Trading}} Emeralds are primarily used as currency for [[trading]] with villagers and wandering traders. Trading is typically a faster way to obtain emeralds than by mining, as an emerald ore is rarer than a diamond ore. === Crafting ingredient === {{crafting usage}} ===Beacons=== Emeralds can be used to select powers from a [[beacon]]. The player must select one of the available powers and then insert an emerald into the item slot. An emerald can be substituted for an [[iron ingot]], a [[gold ingot]], a [[diamond]] or a [[netherite ingot]] in a beacon. === Smithing ingredient === {{Smithing |head=1 |ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Emerald |Any Armor Trim Smithing Template |Netherite Chestplate |Emerald |Emerald Trim Netherite Chestplate |showdescription=1 |description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example. |tail=1 }} ;Trim color palette The following color palette is shown on the designs on trimmed armor: *{{TrimPalette|emerald}} == Achievements == {{load achievements|The Haggler;Buy Low;Master Trader}} == Advancements == {{load advancements|What a Deal!}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showitemtags=y |showforms=y |generatetranslationkeys=y |displayname=Emerald |spritetype=item |nameid=emerald |itemtags=beacon_payment_items |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Emerald |spritetype=item |nameid=emerald |id=512 |form=item |foot=1}} == History == {{History|java indev}} {{History||0.31|snap=20100129|Added [[diamond]]s, referred to as emeralds in the code.}} {{History|java}} {{History||May 21, 2012|link={{tweet|jeb_|204619936616808451}}|[[File:Ruby pJE20120521.png|32px]] [[Jens Bergensten|Jeb]] released a screenshot of himself testing the [[trading]] system. At this time, what would become emeralds were [[History_of_textures/Unused_textures#Ruby|rubies]].<ref>http://www.minecraftforum.net/topic/1621716-15-new-blocksitems/#entry19977082</ref>}} {{History||1.3.1|snap=12w21a|[[File:Emerald JE1 BE1.png|32px]] Added emeralds and [[emerald ore]]. |Emeralds can be [[trading|traded]] with [[villager]]s in exchange for different [[item]]s. |Added [[desert temple]]s, with a hidden [[chest]] room and loot containing emeralds. |[[File:Ruby JE1 BE1.png|32px]] The texture of [[History_of_textures/Unused_textures#Ruby|rubies]] can be found in the (at this time unused) file {{cd|items.png}}.<ref name="en_US 12w21">Snapshot 12w21a/b ''lang/en_US.lang'': '''item.ruby.name=Ruby'''</ref>}} {{History|||snap=12w22a|[[Block of emerald]] has now been added, which is [[crafting|crafted]] from nine emeralds and can be placed as a decorative [[block]]. |Added [[jungle temple]]s, which contain loot [[chest]]s with emeralds.}} {{History||1.4.2|snap=12w32a|As [[zombie villager]]s can now spawn and be cured, emeralds can now still be obtained in [[trading|trades]] even if [[generated structures]] are disabled.}} {{history||1.9|snap=15w31a|Emeralds now generate in [[end city]] ship [[chest]]s.}} {{history|||snap=15w43a|Emeralds now generate in [[igloo]] basement chests.}} {{history|||snap=15w44a|The average yield of emeralds in [[desert temple]] chests has now been increased.}} {{History||1.11|snap=16w39a|Added [[vindicator]]s and [[evoker]]s, which drop emeralds if killed by a player.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 388.}} {{History|||snap=18w09a|Emeralds can now generate in the loot [[chest]]s of [[underwater ruins]].}} {{History|||snap=18w10a|Emeralds can now generate in [[buried treasure]] chests.}} {{History|||snap=18w11a|Emeralds can now generate in the chests of [[shipwreck]]s.}} {{History||1.14|snap=18w43a|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed. |Added [[pillager]]s, which can [[drops|drop]] emeralds.}} {{History|||snap=18w46a|Pillagers no longer drop emeralds.}} {{History|||snap=18w48a|Emeralds now generate in chests in [[village]] tanneries, fisher cottages and plains village houses.}} {{History|||snap=18w49a|Emeralds now generate in chests in [[village]] shepherd houses, mason houses, butcher shops, and savanna and snowy village houses.}} {{History|||snap=18w50a|Emeralds now generate in chests in [[village]] fletcher houses, temples, and desert and taiga village houses.}} {{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with emeralds in their mouths.}} {{History|||snap=19w08a|[[File:Emerald JE3 BE3.png|32px]] The texture of emeralds has now been changed, once again and it looks smaller.}} {{History||1.17|snap=21w13a|The unused [[History_of_textures/Unused_textures#Ruby|rubies]] texture was removed.}} {{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Emeralds can now be used as an armor trim material.}} {{History|||snap=23w07a|Emeralds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s or [[desert well]]s.}} {{History||1.20|snap=23w12a|The probability for the emerald to generate in the [[suspicious sand]] in [[desert temple]] and in [[desert well]] has been changed from 1/7 to 1/8.|Emerald can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}} {{History|||snap=23w16a|Emerald no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; emerald now is in the common loot.}} {{History|pocket alpha}} {{History||v0.9.0|snap=build 1|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}} {{History|||snap=build 5|Emeralds can now be used to craft [[blocks of emerald]].}} {{History||v0.13.0|snap=build 1|Emeralds can now be found inside [[desert temple]] [[chest]]s.}} {{History||v0.15.0|snap=build 1|Added [[jungle temple]]s, which contain loot chests with emeralds.}} {{History||v0.16.0|snap=build 1|Emeralds can now be used to power [[beacon]]s.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|Emeralds can now be found in [[end city]] ship [[chest]]s. |Emeralds can now be found in [[igloo]] basement chests.}} {{History||1.0.4|snap=alpha 1.0.4.0|Emeralds are now used as "currency" for [[villager]] [[trading]].}} {{History||1.1.0|snap=alpha 1.1.0.0|Added [[evoker]]s and [[vindicator]]s, which [[drops|drop]] emeralds when killed.}} {{History|bedrock}} {{History||1.4.0|snap=beta 1.2.14.2|Emeralds can now be found in some [[shipwreck]] [[chest]]s.}} {{History|||snap=beta 1.2.20.1|Emeralds can now be found inside [[underwater ruins]] chests.}} {{History||1.10.0|snap=beta 1.10.0.3|Emeralds can now be used to [[trading|buy]] items from [[wandering trader]]s. |Emeralds can now be found in [[plains]] [[village]] house and tannery [[chest]]s. |[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.}} {{History||1.11.0|snap=beta 1.11.0.1|Emeralds can now be found in [[village]] [[chest]]s other than [[plains]].}} {{History|||snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn from [[raid]]s can now [[drops|drop]] bonus emeralds.}} {{History|||snap=beta 1.11.0.5|[[File:Emerald JE3 BE3.png|32px]] The texture of emeralds has now been changed, once again.}} {{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can [[drops|drop]] emeralds.}} {{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Emeralds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s or [[desert well]]s.}} {{History|||snap=beta 1.19.80.21|Emeralds can now be used as an armor trim material.}} {{History|console}} {{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}} {{History|Ps4}} {{History||1.90|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.}} {{History|new3DS}} {{History||0.1.0|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}} {{History|foot}} == Issues == {{issue list}} == Gallery == <gallery> Villager trading preview.png|The first image of the trading system released by [[Jeb]]. What would become emeralds can be seen in the [[inventory]] space. Emerald Ore 12w21a.png|A wall of [[emerald ore]] utilizing a previous texture in snapshot [[12w21a]]. Room of Emeralds.png|All forms of emeralds in one photo: emerald (in the form of [[emerald block|block]], [[emerald ore|ore]] and the emerald itself). </gallery> ==Trivia== *The [[History_of_textures/Unused_textures#Ruby|ruby]] was going to be the [[villager]] currency but was changed to emeralds before the update's release. == References == {{Reflist}} {{Items}} [[Category:Renewable resources]] [[cs:Smaragd]] [[de:Smaragd]] [[es:Esmeralda]] [[fr:Émeraude]] [[hu:Smaragd]] [[it:Smeraldo]] [[ja:エメラルド]] [[ko:에메랄드]] [[nl:Smaragd]] [[pl:Szmaragd]] [[pt:Esmeralda]] [[ru:Изумруд]] [[th:มรกต]] [[tr:Zümrüt]] [[uk:Смарагд]] [[zh:绿宝石]]</li></ul>		17w43a			Added data packs.
		17w46a			Added /datapack, a command to control loaded data packs.
		17w48a			Datapacks can now load custom recipes.
		17w49a			Tags can now be created with data packs.
		17w49b			Tags can now be created for functions.
					Functions tagged in minecraft:tick now run every tick at the beginning of the tick.
		18w01a			Added set_name function to loot tables.
					Functions tagged in minecraft:load will now run once after a (re)load.
					Crash reports now list what data packs are enabled.

See also

• Advancements
• Function
• Loot table
• Recipe
• Structure
• Tag
• Tutorials/Installing a data pack
• Tutorials/Creating a data pack