Function (Java Edition)

Functions allow players to run lists of commands using text files with the extension .mcfunction. It is recommended to use UTF-8 encoding (without BOM) for function files to prevent any problems.

Usage

To utilize functions, the text files must first be placed into a top-level folder within [WORLD_NAME]/datapacks/[DATA_PACK_NAME]/data/[NAMESPACE]/functions. For single player, the world folders can be found in .minecraft/saves. For multiplayer, functions must be placed in every world folder that wants to utilize them (In 1.12 you MUST place the functions inside the main world folder (the one specified in the server.properties, level-name=(world-name here)), otherwise it will NOT work.). The name of the new top-level folder will be the namespace used when running the functions inside. Functions can also be placed into subfolders within the top-level folder.

For example, running the function custom:example/test will refer to the file located at data/custom/functions/example/test.mcfunction. If the namespace is left out when trying to call a function, it will default to the minecraft: namespace. Using a custom namespace is recommended in order to prevent unintended behavior in the case of future additions to the default namespace.

Functions, being text files, are easily modifiable and less likely than command blocks to induce lag when used in large quantities. If a function is modified or added, using the /reload command will reload the function files from disk. This allows Minecraft to recognize any changes to the function files, without the need to quit and re-enter the world.

Upon successfully running a function, a message will display in the chat: Executed [amount] command(s) from function '[function file directory]'. The successful output of the commands inside a function cannot be measured with a comparator (although the same effect could be accomplished with the use of /stats and /scoreboard commands).

Function syntax

Testing the function system. Three /tellraw messages and one /give command were used in this simple function.

Within the .mcfunction file, one valid command is placed per line, without the usual forward slash (/). Players can add comments within the function text file by preceding them with a #.

Individual commands in functions can be longer than the 32,500 character limit in command blocks but the total number of commands run inside a function will still obey /gamerule maxCommandChainLength, which is 65,536 commands by default; any commands beyond this limit will be ignored.

Running a function

Functions will run all of their commands in a single tick and functions called from within other functions will also run their commands in the same tick as their parent. Functions will use the command environment of whatever called the function. This includes command sender, position, rotation, etc.

Changes to the command environment that happen within a function will not affect the command environment used by the other commands within that same function (or within its child functions) until the next iteration, regardless of the order of commands. The /execute command is an exception and will update the command environment.

For example:

1.12

execute @a ~ ~ ~ function foo:bar

foo:bar

teleport @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute @s ~ ~ ~ setblock ~ ~-1 ~ diamond_block

1.13

execute as @a at @s run function foo:bar

foo:bar

teleport @s ~ ~5 ~
setblock ~ ~-1 ~ emerald_block
execute at @s run setblock ~ ~-1 ~ diamond_block

When called through a player this function will teleport that player 5 blocks up, place an emerald block one block below their original position before the teleport, and place a diamond block one block below their new position after the teleport. This behavior does not affect target selector arguments.

There are several methods of running a function file in-game:

Commands

/function

• Allows players to run a function once.
• The commands in the function are run through the entity or command block that ran the /function command.
• The optional arguments if and unless will make the function only run when the selector was found or not found in the world respectively.
• Usage: /function <name>

Advancements

Advancements can run a function once as a reward for completing them. The commands in the function are run through the player who completed the advancement.

Reward functions are called within advancement JSON files using the following format:

{
    "rewards": {
        "function": "namespace:path/to/function/file"
    }
}

Tags

Functions can be grouped together using tags in data packs. These tags can then be called to run all the functions inside that tag with /function #(namespace):tag.

Functions tagged in minecraft:tick will automatically run every tick at the beginning of the tick. Functions tagged in minecraft:load will run after (re)loading the datapack.

History

release
1.12 {{Extension DPL}}<ul><li>[[Shovel|Shovel]]<br/>{{Item | image = <gallery> Wooden Shovel.png | Wooden Stone Shovel.png | Stone Iron Shovel.png | Iron Golden Shovel.png | Golden Diamond Shovel.png | Diamond Netherite Shovel.png | Netherite </gallery> | rarity = Common | renewable = '''Netherite''': No<br>'''All others''': Yes | durability = * Wood: 59 * Stone: 131 * Iron: 250 * Golden: 32 * Diamond: 1561 * Netherite: 2031 | stackable = No }} '''Shovels''' are [[tool]]s used to hasten the process of breaking [[dirt]], [[sand]], [[gravel]] and other soil blocks, as well as to convert [[Dirt (disambiguation)|dirt]] blocks into [[Dirt Path|dirt paths]]. == Obtaining == === Crafting === {{Crafting |head=1 |showname=0 |showdescription=1 |name=[[Shovel]]s |B1= {Any Planks}; Iron Ingot; Gold Ingot; Diamond |B2= Stick |B3= Stick |Output= Wooden Shovel; Iron Shovel; Golden Shovel; Diamond Shovel |type= Tool }} {{Crafting |name=[[Stone Shovel]] |B1=Any stone-tier block |B2=Stick |B3=Stick |Output=Stone Shovel |description=Can use any variant of cobblestone |type=Tool }} {{Crafting |foot=1 |ignoreusage=1 |name=[[Shovel]] |ingredients=Damaged Matching [[Shovel]] |Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel |Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel |Output=Wooden Shovel; Stone Shovel; Iron Shovel; Golden Shovel; Diamond Shovel; Netherite Shovel |description= The durability of the two shovels is added together, plus an extra 5% durability. |type= Tool }} === Upgrading === Like other diamond tools, a diamond shovel can be upgraded to a netherite shovel, although increased durability and resistance to fire/lava in item form are the only benefits. The shovel's performance as a digging tool or a weapon is unchanged by the upgrade. {{Smithing |Netherite Upgrade |Diamond Shovel |Netherite Ingot |Netherite Shovel |description= |tail=1 }} === Repairing === ==== Grinding ==== {{Grinding |showdescription=1 |ingredients=2x Damaged [[Wooden Shovel]] or<br>2x Damaged [[Stone Shovel]] or<br>2x Damaged [[Iron Shovel]] or<br>2x Damaged [[Golden Shovel]] or<br>2x Damaged [[Diamond Shovel]] or<br>2x Damaged [[Netherite Shovel]] |Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel |Damaged Wooden Shovel; Damaged Stone Shovel; Damaged Iron Shovel; Damaged Golden Shovel; Damaged Diamond Shovel; Damaged Netherite Shovel |Wooden Shovel; Stone Shovel; Iron Shovel; Golden Shovel; Diamond Shovel; Netherite Shovel |description=The durability of the two shovels is added together, plus an extra 5% durability. }} ==== [[Anvil mechanics#Unit repair|Unit repair]] ==== {{/Repairing with Anvils}} A shovel can be repaired in an [[anvil]] by adding units of the [[tiers]]' repair material, with each repair material restoring 25% the shovel's maximum durability, rounded down. It also keeps the shovel's [[Enchanting|enchantments]]. === Chest loot === On <code>ancient_city/city_center/city_center_2</code>, they generate a furnace with a wooden shovel inside of it. {{LootChestItem|iron-shovel,level-enchanted-iron-shovel,random-enchanted-golden-shovel,diamond-shovel,level-enchanted-diamond-shovel,damaged-random-enchanted-diamond-shovel,damaged-random-enchanted-diamond-shovel-2}} === Mob loot === ==== Equipment ==== {{Main|Drops#Equipped items}} [[Zombie]]s and [[husk]]s have a 0.67% (3.33% in Hard [[difficulty]]) chance of spawning with an iron shovel. They have an 8.5% (9.5% with [[Looting]] I, 10.5% with Looting II and 11.5% with Looting III) chance of dropping that shovel if they are killed by the player. The dropped shovel is usually badly damaged, and may be enchanted: 0%–25% on Normal difficulty and 3.125%–25% on Hard difficulty, varying with [[regional difficulty]], and enchanted as if on an enchanting table at level 5–22. ==== Raids ==== Vindicators and pillagers that spawn from raids have a 4.1% chance(5.12% on hard) to drop a badly-damaged iron shovel that is sometimes enchanted with a random enchantment.{{only|bedrock}} === Trading === Novice-level toolsmith villagers have a 25% chance to sell stone shovels for one emerald, journeyman-level toolsmith villagers have a 25% chance to sell enchanted iron shovels for 2 emeralds, and expert-level toolsmith villagers have a 50% chance to sell enchanted diamond shovels for 5 emeralds as part of their trades.{{only|bedrock}} Novice-level toolsmith villagers have a 40% chance to sell stone shovels for one emerald, journeyman-level tool smiths have a 40% chance to sell an enchanted iron shovel for 7-22 emeralds, and expert-level tool smiths have a {{frac|2|3}} chance to sell an enchanted diamond shovel for 11-27 emeralds.{{only|java}} The enchantments are the same as the ones obtained from an [[enchanting table]] at levels 5–19. === Villager gifts === {{in|java}}, toolsmith [[villager]]s occasionally throw stone shovels at players with the [[Hero of the Village]] effect. == Usage == === Digging === A shovel can be used to break some materials faster. When breaking a block, it uses 1 durability. For blocks that break instantly, it uses 0 durability. ==== Durability ==== Each different tier of shovel has a different durability: {| class="wikitable sortable" ! Material ! [[Durability]] |- | {{itemLink|Wooden Shovel|Wood|link=Shovel}} | 59 |- | {{itemLink|Stone Shovel|Stone|link=Shovel}} | 131 |- | {{itemLink|Iron Shovel|Iron|link=Shovel}} | 250 |- | {{itemLink|Diamond Shovel|Diamond|link=Shovel}} | 1561 |- | {{itemLink|Golden Shovel|Golden|link=Shovel}} | 32 |- | {{itemLink|Netherite Shovel|Netherite|link=Shovel}} | 2031 |} ==== Speed ==== The following table summarizes the speed at which different quality shovels perform on different block types. Values with a red background indicate that no resource is dropped when the block is destroyed without a shovel. {{breaking row|Clay|simple=1}} {{breaking row|Coarse Dirt}} {{Breaking row|Concrete Powder}} {{breaking row|Dirt}} {{breaking row|Dirt Path}} {{breaking row|Farmland}} {{breaking row|Grass Block}} {{breaking row|Gravel}} {{breaking row|Mud}} {{breaking row|Muddy Mangrove Roots}} {{breaking row|Mycelium}} {{breaking row|Podzol}} {{breaking row|Red Sand}} {{breaking row|Rooted Dirt}} {{breaking row|Sand}} {{breaking row|Snow|Wooden}} {{breaking row|Snow Block|Wooden}} {{breaking row|Soul Sand}} {{breaking row|Soul Soil}} {{breaking row|Suspicious Gravel}} {{breaking row|Suspicious Sand|foot=1}} === Dirt paths === A shovel can be used to create a [[dirt path]] by {{control|using}} (not digging) the shovel on any one of the following blocks, losing one durability point: * {{BlockLink|Grass Block}} * {{BlockLink|Dirt}} * {{BlockLink|Coarse Dirt}} * {{BlockLink|Rooted Dirt}} * {{BlockLink|Podzol}} * {{BlockLink|Mycelium}} === Campfire === A shovel can be used to extinguish a [[campfire]]. ===Weapon=== Hitting a mob while holding a shovel is a stronger attack than barehanded. Shovels take 2 damage when used as a weapon. ====Java Edition==== [[Category:Java Edition specific information]] Shovels have an attack speed modifier of -3, meaning they take 1 second to [[Damage#Attack cooldown|recover]]. Shovels deal different damage based on the type: {| class="wikitable" style="text-align:center" data-description="Attack damage" !Shovel type ! Attack damage ! Attack speed !Damage per<br>second (DPS) |- |{{ItemLink|Wooden Shovel}}<br>{{ItemLink|Golden Shovel}}||{{hp|2.5}}|| rowspan="5" |1||2.5 |- |{{ItemLink|Stone Shovel}}||{{hp|3.5}}||3.5 |- |{{ItemLink|Iron Shovel}}||{{hp|4.5}}||4.5 |- |{{ItemLink|Diamond Shovel}}||{{hp|5.5}}||5.5 |- |{{ItemLink|Netherite Shovel}}||{{hp|6.5}}||6.5 |} ====Bedrock Edition==== {{IN|bedrock}}, shovels always attack instantly and do the following damage: {| class="wikitable" style="text-align:center" data-description="Attack damage" ! colspan="5" |Attack damage |- |{{ItemSprite|Wooden Shovel}}{{ItemSprite|Golden Shovel}} {{hp|2}} |{{ItemSprite|Stone Shovel}} {{hp|3}} |{{ItemSprite|Iron Shovel}} {{hp|4}} |{{ItemSprite|Diamond Shovel}} {{hp|5}} |{{ItemSprite|Netherite Shovel}} {{hp|6}} |} ===Enchantments=== A shovel can receive, or be found in an [[End City]] with the following [[enchantment]]s: {| class="wikitable col-2-center col-3-right" |+ !Name !Max Level ![[Enchanting|Method]] |- |[[Fortune]]<ref group="note" name="exc">Silk Touch and Fortune are mutually exclusive</ref> |III |{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}} |- |[[Silk Touch]]<ref group="note" name="exc" /> |I |{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}} |- |[[Efficiency]] |V |{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}} |- |[[Unbreaking]] |III |{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}} |- |[[Mending]] |I |{{Inventory slot|Anvil}} |- |[[Curse of Vanishing]] |I |{{Inventory slot|Anvil}} |} {{notelist}} === Fuel=== Wooden shovels can be used as a fuel in [[furnace]]s, smelting 1 item per shovel. ===Smelting ingredient=== {{Smelting|showname=1|Iron Shovel;Golden Shovel|Iron Nugget;Gold Nugget|0,1}} ===Piglins === If a {{EntityLink|Piglin}} see a golden shovel, it will set off to reach it, then stare at it for 120 — 160 ticks, putting it in their inventory, and continue to perform the action it was taking before being attracted by the golden shovel. == Sounds == {{edition|java}}: {{Sound table |sound=Shovel flatten1.ogg |sound2=Shovel flatten2.ogg |sound3=Shovel flatten3.ogg |sound4=Shovel flatten4.ogg |subtitle=Shovel flattens |source=block |description=When a shovel creates a [[dirt path]] |id=item.shovel.flatten |translationkey=subtitles.item.shovel.flatten |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |sound=Random break.ogg |subtitle=Item breaks |source=player |description=When a shovel's durability is exhausted |id=entity.item.break |translationkey=subtitles.entity.item.break |volume=0.8 |pitch=0.8-1.2 |distance=16 |foot=1}} {{edition|bedrock}}: {{Sound table |type=bedrock |sound=Grass hit1.ogg |sound2=Grass hit2.ogg |sound3=Grass hit3.ogg |sound4=Grass hit4.ogg |sound5=Grass hit5.ogg |sound6=Grass hit6.ogg |source=block |description=When a shovel creates a dirt path <ref group=sound>{{Bug|MCPE-114390}}</ref> |id=use.grass |volume=1.0 |pitch=0.8}} {{Sound table |sound=Random break.ogg |source=player |description=When a shovel's durability is exhausted |id=random.break |volume=1.0 |pitch=0.9 |foot=1}} ==Data values== ===ID=== {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Wooden Shovel |spritetype=item |nameid=wooden_shovel |form=item}} {{ID table |displayname=Stone Shovel |spritetype=item |nameid=stone_shovel |form=item}} {{ID table |displayname=Iron Shovel |spritetype=item |nameid=iron_shovel |form=item}} {{ID table |displayname=Diamond Shovel |spritetype=item |nameid=diamond_shovel |form=item}} {{ID table |displayname=Golden Shovel |spritetype=item |nameid=golden_shovel |form=item}} {{ID table |displayname=Netherite Shovel |spritetype=item |nameid=netherite_shovel |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Wooden Shovel |spritetype=item |nameid=wooden_shovel |id=309 |form=item}} {{ID table |displayname=Stone Shovel |spritetype=item |nameid=stone_shovel |id=313 |form=item}} {{ID table |displayname=Iron Shovel |spritetype=item |nameid=iron_shovel |id=296 |form=item}} {{ID table |displayname=Diamond Shovel |spritetype=item |nameid=diamond_shovel |id=317 |form=item}} {{ID table |displayname=Golden Shovel |spritetype=item |nameid=golden_shovel |id=323 |form=item}} {{ID table |displayname=Netherite Shovel |spritetype=item |nameid=netherite_shovel |id=605 |form=item |foot=1}} ==Achievements== {{load achievements|MOAR Tools ;Oooh, shiny!}} ==Advancements== {{load advancements|Oh Shiny}} == Video== <div style="text-align:center">{{yt|U4X-4S4neYM}}</div> ==History== {{Missing information|there are so many missing blocks that need shovel to break}} {{History|java indev}} {{History||0.31|snap=20091231-2|[[File:Iron Shovel JE1.png|32px]] Added iron shovels which are located in the player's [[inventory]]. |Shovels cannot be crafted yet and are not functional in this version.}} {{History|||snap=20100110|Shovels are now functional and can now be used to gather [[material]]s like [[dirt]], [[sand]] and [[gravel]] 400% faster than by hand.}} {{History|||snap=20100124|A complete [[tool]] set is no longer given to the [[player]] on starting a new world. Instead, there are multiple [[chest]]s in the later called "[[Indev House]]" containing a stack of most accessible [[blocks]]/[[items]] including [[tools]].}} {{History|||snap=20100128|[[File:Wooden Shovel JE1 BE1.png|32px]] [[File:Stone Shovel JE1 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] [[Tools]] now have tiers. Shovels made from wood, stone, and diamond have been added. |[[File:Iron Shovel JE2 BE1.png|32px]] The texture of iron shovels has been changed. |A shovel held by the player is now rendered to appear more 3D.|They cannot be crafted yet, but have been added to the item chest in the Indev house.}} {{History|||snap=20100129|Wood, stone, iron, and diamond shovels can now be [[craft]]ed.}} {{History|||snap=20100130|[[File:Golden Shovel JE1.png|32px]] Shovels can now be made out of gold.}} {{History|||snap=20100201-1|[[Tools]], including shovels, now take [[damage]] when being used. |Better tools, including shovels, now last longer.}} {{History||20100206|[[File:Golden Shovel JE2 BE1.png|32px]] The texture of golden shovels has been changed.}} {{History|java alpha}} {{History||1.0.5_01|Shovels are now used to get snowballs out of snow layers.}} {{History|java beta}} {{History||April 9, 2011|link=https://www.youtube.com/watch?v=qy882ILYJMM&t=154s|[[File:Iron Shovel (pre-release).png|32px]] Alternate iron shovel texture was shown in [[Mojang]] test video.}} {{History|java}} {{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft wooden shovels.}} {{History||1.3.1|snap=12w18a|Wooden shovels can now be used as [[fuel]] in a [[furnace]].}} {{History|||snap=12w21a|Blacksmith [[villager]]s now [[trading|sell]] diamond shovels for 7 [[emerald]]s, and iron shovels for 4–5 emeralds.}} {{History||1.6.1|snap=13w21a|Instead of replacing the barehanded [[damage]] ({{hp|1}}), shovels now add their damage onto the barehanded damage, which results in all shovels doing {{hp|1}} more damage than before.}} {{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft wooden shovels.}} {{History||1.8|snap=14w02a|Tool smith villagers now [[trading|sell]] enchanted iron shovels for 5–7 emeralds. The previous trades are now unavailable, making diamond shovels [[non-renewable resource|non-renewable]].}} {{History||1.9|snap=15w31a|A shovel can now be used on a [[grass block]] to create [[grass path]] blocks. |[[Enchanting|Enchanted]] iron or diamond shovels can now be found in [[end city]] chests.}} {{History|||snap=15w34a|Shovels now use the "attack strength" combat mechanic meter. The time it takes for the meter to fill up for a shovel is 0.8 seconds.}} {{History|||snap=15w34c|Shovels now do more [[damage]] and take longer to recover.}} {{History|||snap=15w35a|The damage of shovels has been reduced.}} {{History|||snap=15w41a|Wooden shovels are now used to craft [[boat]]s.}} {{History|||snap=15w50a|The [[sound]] <code>item.shovel.flatten</code> has been added to shovels.}} {{History|||snap=16w04a|Wooden shovels are no longer used to [[crafting|craft]] boats.}} {{History||1.11.1|snap=16w50a|Golden and iron shovels now [[smelting|smelt]] down into one of their respective [[nugget]]s.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 269, 273, 256, 277 and 284.}} {{History||1.14|snap=18w43a|[[File:Wooden Shovel JE2 BE2.png|32px]] [[File:Stone Shovel JE2 BE2.png|32px]] [[File:Iron Shovel JE3 BE2.png|32px]] [[File:Golden Shovel JE3 BE2.png|32px]] [[File:Diamond Shovel JE2 BE2.png|32px]] The textures of all shovels have been changed.}} {{History|||snap=18w50a|Iron shovels can now be found in chests in [[village]] toolsmith houses.}} {{History|||snap=19w11a|Toolsmith [[villager]]s now [[trading|sell]] stone shovels and enchanted diamond shovels, making diamond shovels [[renewable resource|renewable]] again.}} {{History|||snap=19w13a|Toolsmith villagers now give stone shovels to players under the [[Hero of the Village]] effect.}} {{History||1.15|snap=19w37a|Shovels can now be used to extinguish [[campfire]]s.}} {{History||1.16|snap=20w06a|[[File:Netherite Shovel JE1.png|32px]] Added netherite shovels. |Netherite shovels are obtained by combining one diamond shovel and one netherite ingot in a crafting table. |[[Crimson planks]] and [[warped planks]] can now be used to craft wooden shovels.}} {{History|||snap=20w09a|[[File:Diamond Shovel JE3 BE3.png|32px]] The texture of diamond shovels has been changed. |Shovels can now break soul soil quickly.}} {{History|||snap=20w10a|[[File:Netherite Shovel JE2 BE1.png|32px]] The texture of netherite shovels has been changed. |Netherite shovels can no longer be crafted. |Netherite shovels are now obtained by combining one diamond shovel and one netherite ingot in a smithing table.}} {{History|||snap=20w15a|Stone shovels can now be crafted using [[blackstone]].}} {{History|||snap=20w16a|Netherite shovels now generate randomly enchanted in [[bastion remnants]] chests. |Golden shovels now generate randomly enchanted in [[ruined portal]] chests.}} {{History|||snap=20w17a|Diamonds shovels now generate in place of netherite shovels in bastion remnant chests.}} {{History||1.16.2|snap=20w30a|Increases the chance of finding randomly enchanted diamond shovels in bastion remnant chests. |Unenchanted, undamaged diamond shovels can also be found in bastion remnant chests.}} {{History||1.17|snap=21w08a|Stone shovels can now be crafted using [[cobbled deepslate]].}} {{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft wooden shovels.}} {{History|||snap=22w13a|Wooden shovels may now be found in [[ancient city]] [[furnace]]s.}} {{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond shovels to netherite shovels now requires the netherite upgrade [[smithing template]].}} {{History||1.20|snap=23w14a|Shovel now breaks [[suspicious sand]] and [[suspicious gravel]] quickly.}} {{History|upcoming java}} {{History||Combat Tests|snap=1.14.3 - Combat Test|The attack speed for all shovels has been increased to 2.|The [[damage]] for all shovels has been decreased by {{hp|1}}.}} {{History|pocket alpha}} {{History||v0.2.0|[[File:Stone Shovel JE1 BE1.png|32px]] Added stone shovels.}} {{History||v0.3.0|[[File:Wooden Shovel JE1 BE1.png|32px]] Added wooden shovels. |Survival players no longer start out with an infinite durability stone shovel in the inventory.}} {{History||v0.3.2|[[File:Iron Shovel JE2 BE1.png|32px]] [[File:Golden Shovel JE2 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] Added iron, gold, and diamond shovels.}} {{History||v0.4.0|Removed stone shovels from the creative inventory.}} {{History||v0.11.0|snap=build 1|Wooden shovels are now used to craft [[boat]]s. |Iron shovels are now available in the [[creative]] [[inventory]]. |A shovel can now be used on a [[grass block]] to create [[grass path]] blocks.}} {{History|||snap=build 11|Wooden, stone, golden, and diamond shovels are now available in the [[creative]] inventory.}} {{History|||snap=build 12|All shovels have been removed from creative.}} {{History|||snap=build 13|Shovel have been re-added to creative mode.}} {{History||v0.12.1|snap=build 1|Shovels can now be [[enchanting|enchanted]]. |[[Zombie]]s now have a small chance to spawn holding an iron shovel.}} {{History||v0.15.0|snap=build 1|Added [[husk]]s, which have a small chance to spawn holding an iron shovel.}} {{History|pocket}} {{History||1.0.0|snap=alpha 0.17.0.1|[[Enchanting|Enchanted]] iron and diamond shovels can now be found inside [[end city]] chests.}} {{History||1.0.4|snap=alpha 1.0.4.0|Enchanted iron shovels are now [[trading|sold]] by toolsmith [[villager]]s for 4-5 [[emerald]]s.}} {{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden shovels are now [[smelting|smeltable]].}} {{History|bedrock}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Wooden Shovel JE2 BE2.png|32px]] [[File:Stone Shovel JE2 BE2.png|32px]] [[File:Iron Shovel JE3 BE2.png|32px]] [[File:Golden Shovel JE3 BE2.png|32px]] [[File:Diamond Shovel JE2 BE2.png|32px]] The textures of all shovels have been changed.}} {{History||1.11.0|snap=beta 1.11.0.1|Iron shovels can now be found in [[village]] toolsmith houses.}} {{History|||snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn in [[raid]]s can now drop iron shovels upon [[death]]. |[[Trading]] has been changed, toolsmith [[villager]]s now have a 25% chance to [[trading|sell]] enchanted iron shovels for 2 [[emerald]]s as part of their third tier trades. |Stone shovels and [[enchanting|enchanted]] diamond shovels can now be [[trading|bought]] from toolsmith villagers.}} {{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Shovel JE2 BE1.png|32px]] Added netherite shovels.|Netherite shovels are obtained by combining one diamond shovel and one netherite ingot in a crafting table. |[[File:Diamond Shovel JE3 BE3.png|32px]] The texture of diamond shovels has been changed.}} {{History|||snap=beta 1.16.0.57|Netherite shovels can no longer be crafted. |Netherite shovels are now obtained by combining one diamond shovel and one netherite ingot in a smithing table. |Stone shovels can now be crafted using [[blackstone]]. |Netherite shovels now generate randomly enchanted in [[bastion remnants]] chests. |Golden shovels now generate randomly enchanted in [[ruined portal]] chests.}} {{History|||snap=beta 1.16.0.63|Diamonds shovels now generate in place of netherite shovels in bastion remnant chests.}} {{History||1.20.10|snap=beta 1.20.10.20|The [[wooden shovel]] in the crafting recipe has been removed for all boat types except the bamboo raft.}} {{History|||snap=beta 1.20.10.21|The bamboo raft recipe no longer needs a wooden shovel.}} {{History|console}} {{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Wooden Shovel JE1 BE1.png|32px]] [[File:Stone Shovel JE1 BE1.png|32px]] [[File:Iron Shovel JE2 BE1.png|32px]] [[File:Golden Shovel JE2 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] Added shovels (all five types).}} {{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden shovels are now [[smelting|smeltable]].}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Wooden Shovel JE2 BE2.png|32px]] [[File:Stone Shovel JE2 BE2.png|32px]] [[File:Iron Shovel JE3 BE2.png|32px]] [[File:Golden Shovel JE3 BE2.png|32px]] [[File:Diamond Shovel JE2 BE2.png|32px]] The textures of all shovels have been changed.}} {{History|New Nintendo 3DS Edition}} {{History||0.1.0|[[File:Wooden Shovel JE1 BE1.png|32px]] [[File:Stone Shovel JE1 BE1.png|32px]] [[File:Iron Shovel JE2 BE1.png|32px]] [[File:Golden Shovel JE2 BE1.png|32px]] [[File:Diamond Shovel JE1 BE1.png|32px]] Added shovels.}} {{History|foot}} ==Issues== {{issue list}} ==Gallery== <gallery> Shovel JINX.jpg|Official shovel T-shirt made by JINX. Stone Shovel SDGP.png|Stone shovel in the [[Super Duper Graphics Pack]]. Adventure Shovel.png|An "adventure shovel" that can break blocks in [[adventure mode]]. </gallery> ===Enchanted shovels=== <gallery> Enchanted_Wooden_Shovel.gif Enchanted_Stone_Shovel.gif Enchanted_Iron_Shovel.gif Enchanted_Golden_Shovel.gif Enchanted_Diamond_Shovel.gif Enchanted_Netherite_Shovel.gif </gallery> ==References== {{reflist}} == External Links == *[https://www.minecraft.net/en-us/article/taking-inventory-shovel Taking Inventory: Shovel] – Minecraft.net on November 16, 2018 {{items}} [[Category:Combat]] [[cs:Lopata]] [[de:Schaufel]] [[es:Pala]] [[fr:Pelle]] [[hu:Ásó]] [[ja:シャベル]] [[ko:삽]] [[nl:Schep]] [[pl:Łopata]] [[pt:Pá]] [[ru:Лопата]] [[uk:Лопата]] [[zh:锹]]</li><li>[[Shears|Shears]]<br/>{{Item | image = Shears.png | rarity = Common | renewable = Yes | durability = 238 | stackable = No }} '''Shears''' are tools required to obtain some organic blocks or otherwise mine them faster as well as to shear certain entities and blocks. ==Obtaining== ===Crafting=== {{Crafting |head=1 |showdescription=1 |B2= Iron Ingot |A3= Iron Ingot |Output= Shears |type= Tool }} {{crafting |foot=1 |ignoreusage=1 |Damaged Shears |Damaged Shears |Output= Shears |description= The durability of the two shears is added together, plus an extra 5% durability. |type= Tool }} Despite using [[Iron Ingot|iron]] in its crafting recipe, shears cannot be smelted into [[iron nugget]]s.<ref>{{bug|MC-111738}}</ref> ===Trading=== Novice-level Shepherd [[villager]]s have a 40% chance to sell shears for 2 [[emerald]]s in Java Edition. This trade is always offered in Bedrock Edition. ===Chest loot=== {{LootChestItem|shears}} ==Usage== ===Shearing=== Shears lose 1 [[durability]] when used to shear something. Shears can be {{Control|use|text=used}} on a [[sheep]] to remove its coat and drop 1–3 [[wool]] of the corresponding color. The same sheep can be sheared again after it eats from a [[grass block]] to regenerate its coat. Shearing a [[mooshroom]] drops 5 [[mushroom]]s of the corresponding color and irreversibly turns it into a normal [[cow]]. Shearing a [[snow golem]] irreversibly removes its pumpkin, dropping it and revealing its face. Shearing either a [[beehive]] or [[bee nest]] that is full of honey makes it drop 3 [[honeycomb]]s and resets it to honey level 0. The same beehive or bee nest can be sheared again if it is able to reach full honey again. If sheared by hand without a [[campfire]] below the hive or nest all bees within will exit and all nearby bees will attack the offending player. [[Dispenser]]s can use shears in any of the above listed ways, interacting with any valid block or entity in front of the dispenser's face. This decreases the shears' [[durability]]. A dispenser shearing a beehive or bee nest will not anger bees or cause them to leave even if there is not a campfire below it. Shearing a [[pumpkin]] turns it into a [[carved pumpkin]], dropping 4 [[pumpkin seeds]] {{in|java}} or 1-3 pumpkin seeds {{in|bedrock}}. {{IN|java}}, shearing the tip of [[cave vines]], [[kelp]], [[weeping vines]], or [[twisting vines]] sets its age value to 25 and stops further growth. ===Breaking blocks=== Shears use 1 [[durability]] when is used to break any block, even if it [[instant mining|breaks instantly]] by hand. Shears can be used to harvest [[cobweb|cobwebs]], [[leaves]], [[grass|grass, tall grass]], [[seagrass|seagrass, tall seagrass]], [[fern|ferns, large fern]]s, [[dead bush]]es, [[nether sprouts]], [[vines]], [[glow lichen]] or [[hanging roots]] and obtain them in item form. They can also be used to break [[tripwire]] connected to a [[tripwire hook]] without activating it. When shears are used to break [[Weeping Vines|weeping vines]] or [[Twisting Vines|twisting vines]] they are guaranteed to drop in item form instead of the usual 33% chance. This only applies to vines directly broken by shears and not vines that are broken due to the destruction of their supporting vines. The following table shows information about blocks that can be broken with shears. Colors indicate what gets dropped when the block is broken: *White: The original block. *Blue: The block's normal drop (i.e. string, sticks, seeds, saplings, apples). *Red: Nothing. {| class="wikitable" style="text-align:center" data-description="Blocks broken with shears" ! !No shears breaking time !Shears breaking time |- ! style="text-align:left" |{{BlockLink|Cobweb}} | {{tc|no|20 s}}<ref group="note">Breaking cobwebs with a sword is as fast as breaking with shears, and yields string. This costs double durability.</ref> |0.4 s |- ! style="text-align:left" |{{BlockLink|Dead Bush}} | {{tc|planned|0 s}} |0 s |- ! style="text-align:left" |{{BlockLink|id=fern|Grass|Fern}} | {{tc|planned|0 s}} |0 s |- ! style="text-align:left" |{{BlockLink|Grass}} | {{tc|planned|0 s}} | 0 s |- ! style="text-align:left" |{{BlockLink|Nether Sprouts}} | {{tc|no|0 s}}<ref group="note">{{IN|bedrock}}, the item drops when breaking it with fists.</ref> |0 s |- ! style="text-align:left" |{{BlockLink|Leaves}} | {{tc|planned|0.35 s}} |0.05 s |- ! style="text-align:left" |{{BlockLink|id=tripwire|String#Tripwire|Tripwire}} |0 s |0 s<ref group="note">Using shears does not trigger a redstone pulse.</ref> |- ! style="text-align:left" |{{BlockLink|Vines}} | {{tc|no|0.35 s}} |0.35 s |- ! style="text-align:left" |{{BlockLink|Wool}} |1.25 s |0.25 s |- ! style="text-align:left" |{{BlockLink|Seagrass}} | {{tc|no|0 s}} |0 s |- ! style="text-align:left" | {{BlockLink|Glow Lichen}} | {{tc|no|0.3 s}} |0.3 s |- ! style="text-align:left" |{{BlockLink|Hanging Roots}} | {{tc|no|0 s}} |0 s |- ! style="text-align:left" |{{BlockSprite|Twisting Vines Plant}}{{BlockLink|Twisting Vines}}<br> {{BlockSprite|Weeping Vines Plant}}{{BlockLink|Weeping Vines}} |0 s |0 s<ref group="note">Using shears will increase the chance of dropping from 33% to 100%.</ref> |} {{notelist}} ===Enchantments=== Shears can receive the following [[Enchanting|enchantments]]: {| class="wikitable col-2-center col-3-right" |+ !Name ! Max Level ![[Enchanting|Method]] |- |[[Efficiency]] |V |{{Inventory slot|Anvil}} |- |[[Unbreaking]] | III |{{Inventory slot|Anvil}} |- |[[Mending]] |I |{{Inventory slot|Anvil}} |- |[[Curse of Vanishing]] |I |{{Inventory slot|Anvil}} |- |[[Silk Touch]]{{only|be|short=1}} |I |{{Inventory slot|Anvil}} |} {{notelist}} == Sounds == {{edition|java}}: {{Sound table |rowspan=4 |sound=Shear.ogg |subtitle=Shears click |source=player |description=When a mooshroom is sheared |id=entity.mooshroom.shear |translationkey=subtitles.item.shears.shear |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Shears click |source=player |description=When a sheep is sheared |id=entity.sheep.shear |translationkey=subtitles.item.shears.shear |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Shears click |source=player |description=When a snow golem is sheared |id=entity.snow_golem.shear |translationkey=subtitles.item.shears.shear |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Plant cropped |source=block |description=When a growing plant is cropped |id=block.growing_plant.crop |translationkey=subtitles.block.growing_plant.crop |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |sound=Beehive shear.ogg |source=block |subtitle=Shears scrape |description=When honeycombs are harvested from a beehive |id=block.beehive.shear |translationkey=subtitles.block.beehive.shear |volume=0.8 |pitch=1.0/0.8/0.9 |distance=16}} {{Sound table |sound=Pumpkin carve1.ogg |sound2=Pumpkin carve2.ogg |source=block |subtitle=Shears carve |description=When a pumpkin is carved |id=block.pumpkin.carve |translationkey=subtitles.block.pumpkin.carve |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |sound=Random break.ogg |subtitle=Item breaks |source=player |description=When a pair of shears' durability is exhausted |id=entity.item.break |translationkey=subtitles.entity.item.break |volume=0.8 |pitch=0.8-1.2 |distance=16 |foot=1}} {{edition|bedrock}}:<br> Pumpkins do not have carve sounds. {{Sound table |type=bedrock |sound=Shear.ogg |source=player |description=When something is sheared |id=mob.sheep.shear |volume=1.0 |pitch=1.0}} {{Sound table |sound=Beehive shear.ogg |source=block |description=When honeycombs are harvested from a beehive |id=block.beehive.shear |volume=0.8 |pitch=0.8-1.0}} {{Sound table |sound=Random break.ogg |source=player |description=When a pair of shears' durability is exhausted |id=random.break |volume=1.0 |pitch=0.9 |foot=1}} ==Data values== ===ID=== {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Shears |spritetype=item |nameid=shears |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Shears |spritetype=item |nameid=shears |id=421 |form=item |foot=1}} ==Achievements== {{load achievements|Have a Shearful Day}}<div style="text-align:center"></div> ==History== {{History||June 3, 2011|link=https://twitter.com/jeb_/status/76570646074765312|Shears were first mentioned by [[Jeb]] on [[wikipedia:Twitter|Twitter]]. The tweet revealing Jeb's work on shears was written in Swedish (''Jag jobbar på shears nu''), which translates to "I'm working on shears now".}} {{History||June 7, 2011|link=https://twitter.com/jeb_/status/78154891637436416|Jeb tweets about how shears were originally planned as a way to defuse [[TNT]], but he dropped this shortly after deciding TNT would detonate only with [[redstone]] or [[fire]].}} {{History|java beta}} {{History||1.7|[[File:Shears JE1 BE1.png|32px]] Added shears. |Before [[Beta 1.7]], [[sheep]] would drop 1-3 [[wool]] blocks at most when hit, but shears can harvest up to 4 wool blocks per sheep.}} {{History||1.8|snap=Pre-release|Shears can now be used to harvest a [[fern]], [[vines]] and [[grass]].}} {{History|java}} {{History||1.0.0|snap=Beta 1.9 Prerelease|Shears now harvest [[red mushroom]]s from a [[mooshroom]] and turn it back into a normal [[cow]].}} {{History||1.1|snap=11w49a|[[Sheep]] now drop only 1-3 wool blocks when sheared, but they can also regrow their wool by eating [[grass block|grass]], which is part of a plan to have [[animal]]s stay in the game longer.<ref>{{Tweet|jeb|76647002317930496}}</ref>}} {{History||1.2.1|snap=12w05a|Shears can now be used to harvest [[dead bush]]es.}} {{History|||snap=12w06a|Shears are now [[renewable]], due to [[zombie]]s occassionally dropping iron ingots.}} {{History||1.3.1|snap=12w21a|Shears can now be [[trading|bought]] from farmer [[villager]]s for 3 [[emerald]]s each.}} {{History|||snap=12w22a|Shears can now be used to break [[tripwire]] string and not set it off.}} {{History||1.4.2|snap=12w38a|Added a [[sound]] when using shears on [[sheep]].}} {{History||1.4.6|snap=12w50a|Shears can now be [[enchanting|enchanted]].}} {{History||1.8|snap=14w02a|[[Trading]] has been changed: Shepherd [[villager]]s now [[trading|sell]] shears for 3–4 [[emerald]]s each. |Farmers no longer trade shears.}} {{History|||snap=pre1|Shears now lose [[item durability|durability]] when breaking [[wool]] blocks. In previous versions, shears would take [[item durability|durability]] [[damage]] only when destroyed or when breaking [[tall grass]] or [[leaves]], the damage remaining the same for all other [[block]]s.<ref>{{bug|MC-5313}}</ref>}} {{History||1.9|snap=15w34a|Shears may now be used in a crafting grid to zoom in [[map]]s.}} {{History|||snap=15w45a|Shears no longer zoom in maps.}} {{History|||snap=15w47b|Shears can no longer be enchanted with [[Silk Touch]]. |Shears now lose durability when used to break any block (formerly lost durability only from [[leaves]], [[web]], [[grass]], [[vines]], [[tripwire]] and [[wool]]).}} {{History|||snap=15w47c|Shears now harvest [[cobweb]] without requiring [[Silk Touch]].}} {{History|||snap=15w49a|[[Snow golem]]'s [[pumpkin]] can now be removed with shears.}} {{History||1.13|snap=17w47a|When shears are {{control|used}} on an un-carved [[pumpkin]], it now turns into a carved pumpkin and drops 4 [[pumpkin seeds]]. |Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 359.}} {{History||1.14|snap=18w43a|Shears placed in a [[dispenser]] can now shear [[sheep]]. |[[File:Shears JE2 BE2.png|32px]] The texture of shears has been changed.}} {{History|||snap=18w49a|Shears can now be found in [[chest]]s in [[village]] shepherd houses.}} {{History||1.15|snap=19w34a|Shears can now be used on [[bee nest]]s and [[beehive]]s to harvest [[honeycomb]].}} {{History||1.16|snap=20w15a|Shears placed in a dispenser can now shear [[mooshrooms]] and [[snow golem]]s.}} {{History||1.16.2|snap=pre1|Shears are now required in order to pick up [[roots]].}} {{History||1.16.2|snap=pre2|Shears are no longer required to pick up [[roots]].}} {{History||1.17|snap=?|Shears are now required in order to pick up [[hanging roots]].}} {{History||1.18|snap=21w37a|Shears can now stop [[cave vines]], [[kelp]], [[weeping vines]], and [[twisting vines]] from aging.}} {{History||1.19|snap=22w11a|Shears are now required in order to pick up [[mangrove leaves]].}} {{History|pocket alpha}} {{History||v0.2.0|[[File:Shears JE1 BE1.png|32px]] Added shears.}} {{History||v0.3.2|Survival [[player]]s no longer start out with infinite durability shears in the [[inventory]].}} {{History||v0.4.0|Removed shears from the creative inventory.}} {{History||v0.8.0|snap=build 3|Re-added shears to [[creative]] mode.}} {{History||v0.9.0|snap=build 1|Shears can now be used to transform [[mooshroom]]s into [[cow]]s.}} {{History||v0.12.1|snap=build 3|Shearing a [[snow golem]] now removes its [[pumpkin]]. |Shears can now be [[enchanting|enchanted]] in an [[anvil]].}} {{History||v0.13.0|snap=build 1|Shears can now be used to break [[tripwire]] string without triggering it.}} {{History||v0.15.0|snap=build 1|Shears now lose durability when used to break any [[block]].}} {{History|pocket}} {{History||1.0.4|snap=alpha 1.0.4.0|Shears can now be [[trading|bought]] from shepherd [[villager]]s.}} {{History||1.1.0|snap=alpha 1.1.0.0|Breaking a [[melon|melon block]] with shears now always drop 9 [[melon slice|melons]].}} {{History|bedrock}} {{History||1.4.0|snap=beta 1.2.13.8|Shears can now be used to turn un-carved [[pumpkin]]s into [[carved pumpkin]] and spit out 4 [[pumpkin seeds]].}} {{History||?|Shears now harvest [[cobweb]] without requiring [[Silk Touch]].}} {{History||1.10.0|snap=beta 1.10.0.3|Shears placed in a [[dispenser]] can now shear [[sheep]]. |[[File:Shears JE2 BE2.png|32px]] The texture of shears has been changed.}} {{History||1.11.0|snap=beta 1.11.0.1|Shears can now be found in [[village]] shepherd houses.}} {{History|||snap=beta 1.11.0.4|Shears [[trading|sold]] by shepherd [[villager]]s now cost only 2 [[emerald]]s.}} {{History||1.14.0|snap=beta 1.14.0.1|Shears can now be used on [[bee nest]]s and [[beehive]]s to harvest [[honeycomb]].}} {{History|console}} {{History||xbox=TU3|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Shears JE1 BE1.png|32px]] Added shears.}} {{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|Shears can now be used to turn regular [[pumpkin]]s into [[carved pumpkin]]s.}} {{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Shears JE2 BE2.png|32px]] The texture of shears has been changed. |Shears placed in a [[dispenser]] can now shear [[sheep]].}} {{History|New 3DS}} {{History||0.1.0|[[File:Shears JE1 BE1.png|32px]] Added shears.}} {{History|foot}} ==Issues== {{issue list}} ==Gallery== <gallery> File:Enchanted Shears.gif|An enchanted pair of shears. </gallery> ==References== {{reflist}} ==External links== *[https://www.minecraft.net/en-us/article/taking-inventory--shears Taking Inventory: Shears] – Minecraft.net on November 20, 2019 {{Items}} [[cs:Nůžky]] [[de:Schere]] [[es:Tijeras]] [[fr:Cisailles]] [[hu:Metszőolló]] [[it:Cesoie]] [[ja:ハサミ]] [[ko:가위]] [[nl:Schaar]] [[pl:Nożyce]] [[pt:Tesoura]] [[ru:Ножницы]] [[zh:剪刀]] [[Category:Renewable resources]]</li></ul>		pre1			Added functions.
		pre3			Commands are no longer allowed to begin with a / (forward slash)
					Comments can now only be preceded with #; using // is no longer allowed
		pre4			Added new arguments to the /function command: [if|unless] [selector]
		pre6			Skipped functions (when a conditional fails) are now considered failures when used in commands.
1.13 {{Extension DPL}}<ul><li>[[Glowstone Dust|Glowstone Dust]]<br/>{{Item | image = Glowstone Dust.png |type= | renewable = Yes | stackable = Yes (64) }} '''Glowstone dust''' is an [[item]] obtained from mining [[glowstone]], and is mainly used to create [[potion]]s with increased strength and decreased duration. == Obtaining == === Mining === When broken using anything other than a [[Silk Touch]]-enchanted [[tool]], a [[glowstone]] block drops 2-4 glowstone dust. A [[Fortune]] enchantment increases the chances of higher drops, with Fortune III allowing an average yield of 3.5 glowstone dust per block. === Mob loot === [[Witch]]es have a chance of dropping 0–6 glowstone dust upon death. This is increased by 3 per level of [[Looting]], for a maximum of 0-15 glowstone dust. <!-- Do not add the blaze as it is in violation of MCW:UPTODATE due to the Legacy Console Edition being discontinued. Any edit that adds the blaze to this section will be immediately reverted. --> === Trading === {{IN|bedrock}}, journeyman-level cleric [[villager]]s sell one glowstone dust for 4 [[emerald]]s as part of their trades. == Usage == === Crafting ingredient === {{crafting usage}} === Brewing ingredient === {{brewing |showname=1 |head=1 |Glowstone Dust |Thick Potion |base=Water Bottle }} {{brewing |name=Increased Potency |showbase=1 |Glowstone Dust |base=[Potion of Healing II]Potion of Healing;[Potion of Regeneration II]Potion of Regeneration;[Potion of Strength II]Potion of Strength;[Potion of Swiftness II]Potion of Swiftness;[Potion of Harming II]Potion of Harming;[Potion of Poison II]Potion of Poison;[Potion of Leaping II]Potion of Leaping |foot=1 }} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showforms=y |generatetranslationkeys=y |displayname=Glowstone Dust |spritetype=item |nameid=glowstone_dust |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Glowstone Dust |spritetype=item |nameid=glowstone_dust |id=394 |form=item |foot=1}} == History == {{History|java alpha}} {{History||v1.2.0|snap=preview|[[File:Glowstone Dust JE1 BE1.png|32px]] Added glowstone dust. |Glowstone dust currently uses nine dust to [[crafting|craft]] 1 [[glowstone]] block. |Also, each glowstone block drops only one glowstone dust.}} {{History|java beta}} {{History||1.6.6|The crafting recipe for glowstone blocks has been changed from 9 glowstone dust to 4. |Each glowstone block now drops 2-4 glowstone dust when broken.}} {{History|java}} {{History||1.0.0|snap=Beta 1.9 Prerelease 3|Glowstone dust can now be [[brewing|brewed]] in a [[water bottle]] to create a [[thick potion]]. |Glowstone dust now strengthens the [[potion]]s of [[Swiftness]], [[Healing]], [[Harming]], [[Poison]], [[Regeneration]] and [[Strength]].}} {{History|||snap=Beta 1.9 Prerelease 4|Glowstone dust now strengthens the new potion of [[Regeneration]].}} {{History||1.3.1|snap=12w21a|Glowstone dust has become a renewable resource, as priest [[villager]]s now sell glowstone blocks.}} {{History||1.4.2|snap=12w38b|[[Witch]]es now have a chance of [[drops|dropping]] glowstone dust.}} {{History||1.4.6|snap=12w49a|Glowstone dust can now be used to [[crafting|craft]] a [[firework star]] with a twinkle effect.}} {{History||1.8|snap=14w27a|Glowstone dust now strengthens the new [[potion of Leaping]].}} {{History||1.9|snap=15w31a|Glowstone dust is now used to craft [[spectral arrow]]s. |Glowstone dust can no longer be added to extended [[potion]]s.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 348.}} {{History|||snap=18w07a|Glowstone dust now strengthens the new [[potion of the Turtle Master]].}} {{History||1.14|snap=18w43a|[[File:Glowstone Dust JE2 BE2.png|32px]] The texture of glowstone dust has been changed.}} {{History||1.16|snap=20w07a|Glowstone dust has a {{frac|2|109}} (~1.83%) chance of being offered by [[piglin]]s when [[bartering]], in a stack size of 2–4.}} {{History|||snap=20w09a|Glowstone dust now has a {{frac|10|226}} (~4.42%) chance of being offered by piglins when bartering, in a stack size of 1–5.}} {{History||1.16.2|snap=20w28a|Glowstone dust can no longer be obtained from bartering with piglins.}} {{History|pocket alpha}} {{History||v0.2.0|[[File:Glowstone Dust JE1 BE1.png|32px]] Added glowstone dust. It is currently unobtainable and serves no purpose.}} {{History||v0.5.0|Glowstone dust is now obtainable through the [[nether reactor]]. |Glowstone dust can be used to craft [[glowstone]] blocks.}} {{History||v0.12.1|snap=build 1|Glowstone dust can now be obtained through [[the Nether]] instead of the nether reactor. |Glowstone dust is now available in the [[creative]] [[inventory]].|Glowstone dust can now be used to [[brewing|brew]] thick [[potion]]s and to strengthen potions.}} {{History||v0.14.0|snap=build 1|Added [[witch]]es, which have a chance of [[drops|dropping]] glowstone dust upon [[death]].}} {{History|bedrock}} {{History||1.2.0|snap=beta 1.2.0.2|Glowstone dust can now be used to [[crafting|craft]] a [[firework star]] with a twinkle effect.}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Glowstone Dust JE2 BE2.png|32px]] The texture of glowstone dust has been changed.}} {{History||1.11.0|snap=beta 1.11.0.4|Glowstone dust can now be [[trading|bought]] from cleric [[villager]]s.}} {{History||1.16.0|snap=beta 1.16.0.57|Glowstone dust can now be obtained from [[bartering]] with [[piglin]]s.}} {{History||1.16.100|snap=beta 1.16.100.54|Glowstone dust can no longer be obtained from [[barter]]ing with [[piglin]]s.}} {{History|console}} {{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Glowstone Dust JE1 BE1.png|32px]] Added glowstone dust.}} {{History||xbox=TU8|0–2 glowstone dust is now [[drops|dropped]] when a [[blaze]] is killed.}} {{History|Ps4}} {{History||1.90|[[File:Glowstone Dust JE2 BE2.png|32px]] The texture of glowstone dust has been changed.}} {{History|New 3DS}} {{History||0.1.0|[[File:Glowstone Dust JE1 BE1.png|32px]] Added glowstone dust.}} {{History|foot}} == Issues == {{issue list}} {{Items}} [[Category:Renewable resources]] [[Category:Brewing recipe]] [[de:Glowstonestaub]] [[es:Polvo de piedra luminosa]] [[fr:Poudre lumineuse]] [[hu:Izzókő-por]] [[ja:グロウストーンダスト]] [[ko:발광석 가루]] [[nl:Gloeisteenstof]] [[pl:Jasnopył]] [[pt:Pó de pedra luminosa]] [[ru:Светокаменная пыль]] [[tr:Işık Taşı Tozu]] [[uk:Пил світлокаменю]] [[zh:荧石粉]]</li><li>[[Book and Quill|Book and Quill]]<br/>{{For|the item produced after a Book and Quill is signed|Written Book}} {{Item | image = Book and Quill.png | renewable = Yes | stackable = No }} A '''book and quill''' is an [[item]] used to write [[written book]]s. == Obtaining == === Crafting === {{Crafting |Book |Ink Sac |Feather |Output= Book and Quill |type= Miscellaneous }} === Natural generation === {{LootChestItem|book-and-quill}} == Usage == === Crafting ingredient === {{crafting usage}} === Writing === By pressing {{control|use item}} or long pressing screen anywhere{{only|bedrock}} while holding a book and quill in their hand, the [[player]] can open a text editor GUI. Using this GUI, the player can write a single book up to 100{{only|java}} or 50{{only|bedrock}} pages long, with up to 798 characters per page. The player can write up to 79,800{{only|java}} or 12,800{{only|bedrock}} characters inside the entire book. No page may be longer than 14 lines and each line can have a width of 114 pixels (see pixel width of each character [[Language#Font|here]]). The player has the ability to copy and paste into books. However, the paste does not work if the text being pasted is longer than a single page. Most Unicode characters are available in books, and they may be pasted in without issue. In singleplayer, the world pauses while a book is being edited.{{only|java}} === Lecterns === One can place a book and quill or a [[written book]] on an empty [[lectern]]. The lectern then emits a redstone signal depending on the displayed page in the book. On the last page, the lectern emits a signal strength of 15. This is why lecterns are listed in the "redstone" tab in the [[creative inventory]]. === Formatting codes === {{main|Formatting codes}} {{exclusive|bedrock|section=1}} Text in a book can be styled using codes starting with the {{key|§}} character (section sign). * {{key|§}} + {{key|k}} creates randomly changing characters. * {{key|§}} + {{key|l}} creates bold text. * {{key|§}} + {{key|m}} creates strikethrough text. * {{key|§}} + {{key|n}} creates underlined text. * {{key|§}} + {{key|o}} creates italic text. * {{key|§}} + {{key|0}} – {{key|f}} (hexadecimal) creates colored text. * {{key|§}} + {{key|r}} resets any of the previous styles so text after it appears normally. If the [[player]] uses multiple codes, and continue typing past the end of a line, the next line exhibits only the last formatting code used. === Signing === Books can be signed by pressing the "Sign" button while in the interface. {{IN|java}}, when signed, a book bears the name of the player who wrote it and a title chosen upon signing. {{IN|bedrock}}, the book doesn't display the name of the player as the author; instead, the author can be any text the player wants. After it has been signed, it cannot be edited again – it has turned into a [[written book]]. Special characters can be used in the title, if typed from a keyboard that supports them. Alt codes do not work, and the {{key|§}} character cannot be typed even using a keyboard that implements it, meaning titles cannot be colored or formatted in-game. However, on Linux using the compose key to produce special characters does work. The title of the book can be up to 16 characters long, and the player cannot paste into a title. A "workaround" for the 16-character limitation is to manually rename the book at an [[Anvil#Renaming|anvil]], which always costs 1 [[Experience|experience level]]. This can be done with either a written book or a book and quill – both versions will always display the changed name. If a custom name is removed from a written book, it will revert back to the title it was given during the signing process. === Chiseled bookshelf === {{control|Use|text=Using}} the [[chiseled bookshelf]] while having a book and quill in the main hand will put the book inside the chiseled bookshelf. === Trading === {{IN|bedrock}}, expert-level librarian [[villager]]s buy 2 books and quills for one [[emerald]]. Book and quill is offered in two item slots due to being non-stackable. {{IN|java}}, expert-level librarian villagers have a 50% chance to buy 2 books and quills for one emerald. The amount of books and quills needed is supposed to be 2, but due to the item being non-stackable, only one is needed for the trade.<ref>{{bug|MC-248042||Librarian's book and quill trade is always discounted to 1 since books are unstackable}}</ref> == Sounds == {{edition|java}}: {{Sound table |rowspan=2 |sound=Page turn1.ogg |sound2=Page turn2.ogg |sound3=Page turn3.ogg |subtitle=Page rustles |source=master |description=When the page of a book is turned |id=item.book.page_turn |translationkey=subtitles.item.book.page_turn |volume=2.0 |pitch=1.0 |distance=16}} {{Sound table |subtitle=Page rustles |source=block |description=When the page of a book is turned on a lectern |id=item.book.page_turn |translationkey=subtitles.item.book.page_turn |volume=2.0 |pitch=0.9-1.0 |distance=16}} {{Sound table |sound=Book thump1.ogg |sound2=Book thump2.ogg |subtitle=Book thumps |source=block |description=When a book is placed on a lectern |id=item.book.put |translationkey=subtitles.item.book.put |volume=1.0 |pitch=1.0 |distance=16}} {{Sound table |sound=Chiseled bookshelf insert1.ogg |sound2=Chiseled bookshelf insert2.ogg |sound3=Chiseled bookshelf insert3.ogg |sound4=Chiseled bookshelf insert4.ogg |subtitle=Book placed |source=block |description=When a book and quill is placed in a chiseled bookshelf |id=block.chiseled_bookshelf.insert |translationkey=subtitles.chiseled_bookshelf.insert |volume=0.8 |pitch=''varies'' <ref group=sound>Can be 1.0, 0.85, or 1.1 for each sound</ref> |distance=16}} {{Sound table |sound=Chiseled bookshelf pickup1.ogg |sound2=Chiseled bookshelf pickup2.ogg |sound3=Chiseled bookshelf pickup3.ogg |subtitle=Book taken |source=block |description=When a book and quill is removed from a chiseled bookshelf |id=block.chiseled_bookshelf.pickup |translationkey=subtitles.chiseled_bookshelf.take |volume=0.8 |pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 1.1 for each sound</ref> |distance=16 |foot=1}} {{edition|bedrock}}: {{Sound table |type=bedrock |sound=Page turn1.ogg |sound2=Page turn2.ogg |sound3=Page turn3.ogg |source=sound |description=When the page of a book is turned |id=item.book.page_turn |volume=2.0 |pitch=1.0}} {{Sound table |sound=Book thump1.ogg |sound2=Book thump2.ogg |source=block |description=When a book is placed on a lectern |id=item.book.put |volume=4.8 |pitch=1.0}} {{Sound table |type=bedrock |sound=Chiseled bookshelf insert1.ogg |sound2=Chiseled bookshelf insert2.ogg |sound3=Chiseled bookshelf insert3.ogg |sound4=Chiseled bookshelf insert4.ogg |source=block |description=When a book and quill is placed in a chiseled bookshelf |id=insert.chiseled_bookshelf |volume=0.8 |pitch=''varies'' <ref group=sound name=insertvaries>Can be 1.0, 0.85, or 1.1 for each sound</ref>}} {{Sound table |sound=Chiseled bookshelf pickup1.ogg |sound2=Chiseled bookshelf pickup2.ogg |sound3=Chiseled bookshelf pickup3.ogg |source=block |description=When a book and quill is removed from a chiseled bookshelf |id=pickup.chiseled_bookshelf |volume=0.8 |pitch=''varies'' <ref group=sound name=pickupvaries>Can be 1.0, 0.8, or 1.1 for each sound</ref> |foot=1}} == Data values == === ID === {{edition|java}}: {{ID table |edition=java |showitemtags=y |showforms=y |generatetranslationkeys=y |displayname=Book and Quill |spritetype=item |nameid=writable_book |itemtags=bookshelf_books, lectern_books |form=item |foot=1}} {{edition|bedrock}}: {{ID table |edition=bedrock |showitemtags=y |shownumericids=y |showforms=y |notshowbeitemforms=y |generatetranslationkeys=y |displayname=Book and Quill |spritetype=item |nameid=writable_book |id=510 |itemtags=minecraft:bookshelf_books, minecraft:lectern_books |form=item |foot=1}} === Item data === {{el|java}}: {{main|Player.dat format}} <div class="treeview" style="margin-top: 0;"> * {{nbt|compound|tag}}: The '''tag''' tag. {{:Player.dat_format/Writable Books}} </div> {{el|bedrock}}: : See [[Bedrock Edition level format/Item format]]. == Video == <div style="text-align:center">{{yt|DD_Z82wmGZA}}</div> == History == {{History|java}} {{History||1.3.1|snap=12w17a|[[File:Book and Quill JE1 BE1.png|32px]] Added books and quills.}} {{History||1.7.2|snap=13w36a|Books and quills can now be crafted with a [[written book]] to clone the written book.}} {{History||1.8|snap=14w05a|Copying written books now mark them as "Copy of Original" or "Copy of Copy". |The copying status of a book is now denoted in a separate line in the tooltip, beneath the author's name. |Copies of copies cannot be copied.}} {{History|||snap=14w25a|Books and quills now use JSON text components instead of plain text with the new <code>pages</code> tag |Book and quills are now capable of using the <code>clickEvent</code> and <code>hoverEvent</code> tags.}} {{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 386.}} {{History||1.14|snap=18w43a|[[File:Book and Quill JE2 BE2.png|32px]] The texture of books and quills has now been changed. |Added support for editing anywhere in the book and quill.<ref name="MC-1578">{{bug|MC-1578}}</ref> |Books and quills now have copy/paste support.<ref name="MC-1578"></ref> |The page limit of books and quills has now been increased from 50 to 100 pages.}} {{History|||snap=19w11a|Librarian [[villager]]s now [[trading|buy]] books and quills instead of written books.}} {{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Books and quills can now interact with [[chiseled bookshelves]].}} {{History|bedrock}} {{History||1.2.0|snap=beta 1.2.0.2|[[File:Book and Quill JE1 BE1.png|32px]] Added books and quills.}} {{History||1.4.0|snap=beta 1.2.14.2|Books and quills can now be found inside [[buried treasure]] [[chest]]s.}} {{History||1.6.0|snap=beta 1.6.0.1|Pages within books and quills can now be turned using the controller bumper buttons.}} {{History||1.10.0|snap=beta 1.10.0.3|[[File:Book and Quill JE2 BE2.png|32px]] The texture of books and quills has now been changed.}} {{History||1.11.0|snap=beta 1.11.0.4|Books and quills can now be [[trading|sold]] to librarian [[villager]]s.}} {{History|console}} {{History||xbox=TU25|xbone=CU14|ps=1.17|wiiu=Patch 1|switch=1.0.1|[[File:Book and Quill JE1 BE1.png|32px]] Added books and quills.}} {{History|PS4}} {{History||1.90|[[File:Book and Quill JE2 BE2.png|32px]] The texture of books and quills has now been changed.}} {{History|foot}} == Issues == {{issue list}} == Trivia == * The in-game restrictions on books are not hard limits. Third party editors or commands can make books have more than 100 pages{{only|java}} (2,147,483,639 pages), more than 256 characters per page (32,767 characters per page), can change author names, and can have colored titles, among other things. These books still function properly in vanilla ''Minecraft'', meaning the [[player]] may encounter such books on adventure maps or multiplayer servers.<ref>http://www.minecraftforum.net/topic/1189266-hacking-books</ref> * If the player renames a book and quill in an anvil before signing it, it retains the name from the anvil instead of taking the name from signing.{{only|java}} == Gallery == <gallery> Jeb book.png|The first image of a book seen.<ref>https://web.archive.org/web/20120427014334/https://www.mojang.com/2012/04/minecraft-snapshot-12w17a/</ref> Book and Quill Writing.png|The GUI of writing a book. Book and Quill Signing.png|The GUI of signing a book. Written Book tooltip.png|A signed book. BookandQuillOperators12w17a.png|Display of styles used in a book. "e" and "f" are difficult to see. Book and Quill in Pocket Edition.jpg|A book and quill {{in|be}}. Java book and quill example with text.png|An example of text in a book and quill in [[Java Edition]]. Better Together Book.jpg|A book and quill in ''Bedrock Edition''. </gallery> == References == {{Reflist}} == External links == * [http://www.minecraftforum.net/topic/1498339-132ssp-bookshop-your-books-anywhere/ Bookshop - Book Sharing And Editing Tool] * [http://fsymbols.com/generators/wide/ Full-Width Text Generator] * [http://fsymbols.com/generators/smallcaps/ Small Caps Text Generator] * [http://www.minecraftforum.net/topic/1202590-revise-edit-signed-books-w-more-options-all-os-12w17a/ Revise - External Book Editor] == See also == * [[Book]] * [[Bookshelf]] * [[Written Book]] {{Items}} [[Category:Renewable resources]] [[cs:Rozepsaná kniha s brkem]] [[de:Buch und Feder]] [[el:Βιβλίο και Πένα]] [[es:Libro y pluma]] [[fr:Livre vierge]] [[hu:Könyv és toll]] [[it:Libro e penna]] [[ja:本と羽根ペン]] [[ko:책과 깃펜]] [[nl:Boek en veer]] [[pl:Książka z piórem]] [[pt:Livro e pena]] [[ru:Книга с пером]] [[th:หนังสือกับปากกาขนนก]] [[uk:Книга з пером]] [[zh:书与笔]]</li></ul>		17w43a			Custom functions have been moved into data packs.
		17w45a			Functions are now completely parsed and cached on load.
		17w49b			Function can now be tagged.
					Functions tagged in minecraft:tick now run every tick in the beginning of the tick.

Issues

Issues relating to "Function (Java Edition)" are maintained on the bug tracker. Report issues there.