Minecraft Wiki
Don't have an account?
Register
Advertisement
Register
Minecraft Wiki
Minecraft Wiki
7,425
pages
in: Gameplay
English

Scoreboard

Revision as of 18:49, 2 July 2014 by WolfieMario (talk | contribs) (→‎Command reference: Exception for ><, which actually *does* change selector's score.)
 Sign in to edit

The scoreboard system is a complex gameplay mechanic intended mostly for map makers. It is used via commands and command blocks.

Objectives

Objectives are a combination of name, display name, and criteria, and track an integer number of points for players. The full score range is -2,147,483,648 to 2,147,483,647, and does not support decimals.

An objective's name is used internally when referenced in commands, target arguments, and in the file format. It is case-sensitive and must be a single word.

Conversely, the display name can be multiple words, and is displayed publicly in various situations. It is also case-sensitive, and does not have to be unique.

An objective's criteria determines its behavior:

Criteria Description Can be Modified?
dummy Score is only changed by commands, and not by game events such as death. This is useful for event flags, state mappings, and currencies. Yes
trigger Score is only changed by commands, and not by game events such as death. The /trigger command can be used by a player to set or increment/decrement their own score in an objective with this criteria. The /trigger command will fail if the objective has not been "enabled" for the player using it, and the objective will be disabled for the player after they use the /trigger command on it. Note that the /trigger command can be used by ordinary players even if Cheats are off and they are not an Operator. This is useful for player input via /tellraw interfaces. Yes
deathCount Score increments automatically for a player when they die. Yes
playerKillCount Score increments automatically for a player when they kill another player. Yes
totalKillCount Score increments automatically for a player when they kill another player or a mob. Yes
health Ranges from 0 to 20 on a normal player; represents the amount of half-hearts the player has. May appear as 0 for players before their health has changed for the first time. Extra hearts and absorption hearts also count to the health score, meaning that with Attributes/Modifiers or the Health Boost or Absorption Status effects, health can far surpass 20. No

In snapshot 13w36a, hundreds of new criteria were added.[1] These criteria use the Statistics and Achievements systems to form compound criteria.[2] Unlike the simple criteria above, compound criteria have multiple parts, separated by periods ("."). For example, "stat.entityKilledBy.Zombie" would be a compound criterion, which would increment for a player whenever a zombie kills them.[3]

A list of known compound criteria follows:

Criteria Base Description Can be Modified? Number of sub-criteria
achievement Accepted sub-criteria are: "acquireIron", "bakeCake", "blazeRod", "bookcase", "breedCow", "buildBetterPickaxe", "buildFurnace", "buildHoe", "buildPickaxe", "buildSword", "buildWorkBench", "cookFish", "diamonds", "diamondsToYou", "enchantments", "exploreAllBiomes", "flyPig", "fullBeacon", "ghast", "killCow", "killEnemy", "killWither", "makeBread", "mineWood", "onARail", "openInventory", "overkill", "overpowered", "portal", "potion", "snipeSkeleton", "spawnWither", "theEnd", and "theEnd2". Value is dependent on how many times the player has gotten the achievement (e.g. if a player has picked up three blocks of wood, their score for an objective with the "achievement.mineWood" criterion will be 3). Yes 34
stat Base for criteria related to a player's statistics. Accepted sub-criteria are: "animalsBred", "boatOneCm", "climbOneCm", "crouchOneCm", "damageDealt", "damageTaken", "deaths", "diveOneCm", "drop", "fallOneCm", "fishCaught", "flyOneCm", "horseOneCm", "jump", "junkFished", "leaveGame", "minecartOneCm", "mobKills", "pigOneCm", "playerKills", "playOneMinute", "sprintOneCm", "swimOneCm", "timeSinceDeath", "treasureFished", and "walkOneCm". Score increments automatically for a player when they perform the action specified by the sub-criterion. Yes 26
stat.useItem The sub-criteria are the ID number (such as "stat.useItem.1") or ID name (such as "stat.useItem.minecraft.stone") of a block or item. Most blocks and items are accepted, except various blocks which do not have an item form.

The value increments when a player uses a block or item. "Use" is defined as when:

The value, however, does not increment when items are used on mobs, whether to name, tame, feed, breed, saddle, leash, shear, milk, or gather stew from; when armor is put on directly; when leather armor is washed in a cauldron; and all instances mentioned above.

There are 357 items attainable in creative mode, without using commands and including blocks with similar IDs but different datavalues, that can use this stat and 195 that cannot.

Yes 318 (636)[note 1]
stat.breakItem The sub-criteria are the ID number (such as "stat.breakItem.256") or ID name (such as "stat.breakItem.minecraft.bow") of an item with durability.

The value increments when the durability runs out. The durability runs out when the condition for losing durability for the item is met, and the durability becomes negative, which is the first use after the durability is zero.

Yes 50 (100)[note 1]
stat.mineBlock The sub-criteria are the ID number (such as "stat.mineBlock.1") or ID name (such as "stat.mineBlock.minecraft.stone") of a block. Most blocks are accepted, except for various indestructible or technical blocks.

This increments when a player mines a block. "Mine" is defined as when a player destroys a block in a way that an item could/would drop, unless the block does not drop items like glass, or another block would be created like ice. The value does not increase when in Creative mode and will still increase if doTileDrops is set to false.

Yes 135 (270)[note 1]
stat.killEntity The sub-criteria are the name of an entity. Valid names are: "Bat", "Blaze", "CaveSpider", "Chicken", "Cow", "Creeper", "Enderman", "EntityHorse", "Ghast", "LavaSlime", "MushroomCow", "Ozelot", "Pig", "PigZombie", "Sheep", "Silverfish", "Skeleton", "Slime", "Spider", "Squid", "Villager", "Witch", "Wolf", and "Zombie". Increments when a player has killed the specified mob. Yes 24
stat.entityKilledBy The sub-criteria are the name of an entity. Valid names are: "Bat", "Blaze", "CaveSpider", "Chicken", "Cow", "Creeper", "Enderman", "EntityHorse", "Ghast", "LavaSlime", "MushroomCow", "Ozelot", "Pig", "PigZombie", "Sheep", "Silverfish", "Skeleton", "Slime", "Spider", "Squid", "Villager", "Witch", "Wolf", and "Zombie". Increments when a player has been killed by the specified mob.

Note that if the name of a passive mob is used the value will never increase, as those mobs are not capable of hurting the player.

Yes 24
teamkill The sub-criteria are the color of a team. Valid colors are: "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", and "white". Increments when a player has killed a member of a team with the specified color. Yes 16
killedByTeam The sub-criteria are the color of a team. Valid colors are: "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", and "white". Increments when a player has been killed by a member of a team with the specified color. Yes 16
  1. ↑ a b c d Prior to 14w06a, stat.craftItem, stat.useItem, stat.breakItem, and stat.mineBlock only accepted numeric IDs and not ID names. The addition of ID names means that these compound criteria effectively have double the sub-criteria they previously had, but the new criteria serve the same exact roles as their numeric counterparts. For convenience, the first number listed is the number of blocks/items which these compound criteria accept, and the second is the literal number of sub-criteria.

A player's score in any objective may be changed via commands, unless it is read-only (currently, only objectives with the 'health' criterion are read-only). It may be increased or decreased by a specific amount, or set to a specific value. For objectives based upon stats or achievements, the objective can be changed via commands, however the actual stat or achievement doesn't change. The objective will continue to update with changes in stats or achievements.

Command blocks can also be used to check a player's score for any objective, with the arguments score_name and score_name_min. In these arguments, name is the internal name of the objective to test for. score_name passes players with at most the specified number of points, while score_name_min passes players with at least the specified number of points.

For example, "testfor @p[score_deaths=5,score_deaths_min=1]" in a Command Block will make a comparator provide output if a player has died at least once and has died no more than 5 times, assuming "deaths" is an objective of the "deathCount" criterion.

Display slots

Via the "scoreboard objectives setdisplay" command (see command reference), players' scores in specific objectives can be displayed in certain 'slots' in-game. Each 'Display Slot' can show one objective at a time, and multiple 'Display Slots' may be used for the same or different objectives.

Slot Description
list Displays a yellow number without a heading on the tab menu, where online players are shown. Visible even in singleplayer.
sidebar Shows on the right hand side of the screen. Shows players in a high score list with a heading labeled the objective's display name. Note that players will be shown even if offline, and untracked players will not be shown. In addition, fake players with names starting with a # will not show up in the sidebar under any circumstances.
sidebar.team.<color> There are 16 team-specific sidebar display slots. These operate the same as the standard sidebar slot, but only display to players who are on teams which use the specified color (for example, "sidebar.team.green" displays to players on "green" teams). Valid colors are: "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", and "white".
belowName Shows the score followed by the objective's display name below the player's nameplate above their head. Is hidden beyond ~10 blocks and when the player is sneaking. Not visible in singleplayer.

Teams

Teams are a combination of name, display name, prefix, suffix, friendly fire options, and a list of players who are on the team.

As with objectives, the name and display name of a team are case-sensitive, name is a single word used internally, and display name can be multiple words and does not need to be unique.

The prefix and suffix are inserted before and after the names of players on a team - without using external editors, the only possible prefixes are formatting codes for team colors, and the only possible suffix is the reset code (so characters after a player's name aren't formatted). Prefixes and suffixes will be added to the names of players in chat, the active players list, the sidebar, and above their heads.

The friendly fire option allows control of whether team members can harm each other. Its default mode, "true", makes no changes to PvP mechanics. When set to "false", however, it prevents players on the same team from causing damage to each other with melee attacks, bows, and Splash Potions of Harming. Note that players on the same team may still inflict negative status effects on each other with potions, even if friendly fire is false.

It is important to note that each individual player can only be on one team; teams cannot share players.

Command blocks can be used to check whether a player is on a team with the "team" argument; the "!" character may be placed before a name to check for players not on the team. For example, "testfor @p[team=red]" in a Command Block will provide comparator output if a player is on the "red" team. Similarly, "testfor @p[team=!red]" will provide output for players who are not on "red". Also, "testfor @p[team=!]" will check for all players on a team, while "testfor @p[team=] will check for those without a team.

Command reference

Command Description Success Conditions[note 1]
scoreboard <objectives|players|teams> The base command of the scoreboard system. N/A
scoreboard objectives list Lists all existing objectives, with their display name and criteria. The scoreboard must have at least one objective.
scoreboard objectives add <name> <criteria> [display name...] Creates a new objective with the internal name name, specified criteria, and the optional display name. Without a specified display name, it will default to name. See above section for the meaning of these properties. All arguments are case-sensitive. name must not be used by an existing objective, and must be at most 16 characters. criteria must be a valid criteria type. display name must be at most 32 characters.
scoreboard objectives remove <name> Deletes all references to the objective with name in the scoreboard system. Data is deleted from the objectives list, player scores, and if it was on a display list, it will no longer be displayed. name must be an existing objective.
scoreboard objectives setdisplay <slot> [objective] Displays score info for objective in the specified slot. Valid slots are listed and described in Display Slots. Note that the objective parameter is optional: if no objective is provided, this display slot is cleared (returned to its default state). objective must exist, if it is specified. slot must also exist. Note that clearing an empty slot will still succeed.
scoreboard players list [playername] Displays all players who are tracked, in some way, by the scoreboard system. The optional playername parameter can be used to display all scores of a particular player, and "*" (an asterisk) in place of playername will display all scores for all players tracked by the scoreboard system. playername must have recorded scores, if specified. If no playername is specified, there must be at least one tracked player on the scoreboard.
scoreboard players set <player> <objective> <score> [dataTag] Sets the player's score in objective to score, overwriting the previous score if it exists. "*" (an asterisk) may be used in place of player to represent every player tracked by the scoreboard. objective must exist and cannot be read-only, and score must be between -2,147,483,648 and 2,147,483,647, inclusive. Note that player does not need to be online or even exist. If player exists and a dataTag is specified, player must match dataTag.
scoreboard players add <player> <objective> <count> [dataTag] Increments the player's score in objective by count. "*" may be used to represent all players tracked by the scoreboard. objective must exist and cannot be read-only, and count must be between 1 and 2,147,483,647, inclusive. Note that player does not need to be online or even exist. If player exists and a dataTag is specified, player must match dataTag.
scoreboard players remove <player> <objective> <count> [dataTag] Decrements the player's score in objective by count. "*" may be used to represent all players tracked by the scoreboard.
scoreboard players reset <player> [objective] Deletes score or all scores for player. If objective is specified, only that objective is cleared; otherwise this applies to all objectives. Note this does not merely set the score(s) to 0: it removes the player from the scoreboard altogether (or for the given objective). "*" may be used to represent all players tracked by the scoreboard. Always succeeds, even on players who are not on the scoreboard.
scoreboard players enable <player> <trigger> Enables player to use the /trigger command on the specified trigger objective. Until this has been done, player's attempts to /trigger that objective will fail. Once they have used the /trigger command on it, it will be disabled again. "*" may be used to represent all players tracked by the scoreboard. trigger must be an objective of the criteria "trigger".
scoreboard players test <player> <objective> <min> [max] Outputs whether or not player's score in objective is within the range min to max (inclusive). If not specified or if "*" is used, max defaults to 2,147,483,647. Using a "*" for min means -2,147,483,648. For player "*" may be used to represent all players tracked by the scoreboard. objective must exist, and player's score in it must exist and be at least min and no greater than max. Note that player does not need to be online or even exist.
scoreboard players operation <targetName> <targetObjective> <operation> <selector> <objective> Applies an arithmetic operation altering targetName's score in targetObjective, using selector's score in objective as input.

<operation> may be:

  • "+=" Addition: add selector's score to targetName's
  • "-=" Subtraction: subtract selector's score from targetName's
  • "*=" Multiplication: set targetName's score to the product of targetName and selector's scores
  • "/=" Integer Division: set targetName's score to itself divided by selector's score
  • "%=" Modular Division: set targetName's score to the remainder of the division between itself and selector's score
  • "=" Assign: set targetName's score to selector's score
  • "<" Min: if selector's score is less than targetName's score, then set targetName's score to selector's score
  • ">" Max: if selector's score is greater than targetName's score, then set targetName's score to selector's score
  • "><" Swaps the scores of selector with targetName

In all cases except "><", selector's score in objective will remain unchanged. "*" may be used in place of either targetName or selector (but not both) to represent all players tracked by the scoreboard.

objective and targetObjective must exist, targetObjective cannot be read-only, and all requested targets/selectors must have scores in the specified objectives (if some do and some do not, the operation will succeed only for the combinations where both the target and the selector have a score). Note that player does not need to be online or even exist.
scoreboard teams list [teamname] Lists all teams, with their display names and the amount of players in them. The optional teamname parameter can be used to display all players on a particular team. If teamname is specified, it must exist and must have players. If no teamname is specified, there must be at least one registered team on the scoreboard.
scoreboard teams add <name> [display name...] Creates a team with the given name and optional display name. name must not be used by an existing team, and must be at most 16 characters. display name must be at most 32 characters.
scoreboard teams remove <name> Deletes the named team from the scoreboard system. name must be an existing team.
scoreboard teams empty <name> Removes all players from the named team. name must be an existing team, and the team must have at least one player.
scoreboard teams join <team> [players...] Assigns the specified players to the specified team. If no player is specified, the player running the command joins the team. "*" may be used to represent all players tracked by the scoreboard. team must exist. Note that the named players do not need to be online or even exist, and can even already be on the team.
scoreboard teams leave [players...]
scoreboard teams leave <team> [players...]		 Makes the specified players leave their teams. If no player is specified, the player running the command leaves their team. "*" may be used to represent all players tracked by the scoreboard. Each player must be on a team - it is possible to get a partial success and partial failure, but a command block will report only the failure.
scoreboard teams option <team> color <value> Will color the name of all players on this team in chat, above their head, on the Tab menu, and on the sidebar. Valid color values are "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", and "white". Another valid value is "reset" (names show in default color and formatting). team must exist, and value must be a valid value.
scoreboard teams option <team> friendlyfire <true|false> The default setting, true, has no impact on PvP mechanics. When set to false, players on this team cannot harm each other with melee, bow, or Splash Potion of Harming attacks, but may still inflict negative status effects on each other. team must exist, and the setting must be "true" or "false".
scoreboard teams option <team> seeFriendlyInvisibles <true|false> When set to true, players on this team will see invisible teammates (and themselves) as semi-transparent instead of completely invisible. team must exist, and the setting must be "true" or "false".
scoreboard teams option <team> nametagVisibility <never|hideForOtherTeams|hideForOwnTeam|always> Controls the visibility of nametags for players on the given team, and defaults to "always". When set to "never", no nametags will show above any player on the given team. When set to "hideForOtherTeams", only the nametags of players on other teams will be hidden. When set to "hideForOwnTeam", only nametags of other players on one's own team will be hidden. When set to "always", all nametags will be visible. team must exist, and the setting must be "never", "hideForOtherTeams", "hideForOwnTeam", or "always".
scoreboard teams option <team> deathMessageVisibility <never|hideForOtherTeams|hideForOwnTeam|always> Controls the visibility of death messages for players on the given team, and defaults to "always". When set to "never", no death messages will appear in chat for any player on the given team. When set to "hideForOtherTeams", only the death messages of players on other teams will be hidden. When set to "hideForOwnTeam", only death messages of other players on one's own team will be hidden. When set to "always", all death messages will appear in chat. team must exist, and the setting must be "never", "hideForOtherTeams", "hideForOwnTeam", or "always".
  1. ↑ A command's Success Conditions must be met in order for the game to consider the command "successful". This is used to determine a variety of things, such as the output of a Redstone Comparator feeding from Command Block with a command. Note that not all "successful" commands actually do something, and not all "failed" commands fail to do something useful.

NBT format

The file scoreboard.dat in the 'data' folder of a Minecraft world stores the scoreboard data for that world as a GZip'd NBT file:

  • The root tag.
    •  data: The scoreboard data.
      •  Objectives: A list of compound tags representing objectives.
        • An objective.
          •  CriteriaName: The criteria of this objective.
          •  DisplayName: The display name of this objective. If none was specified during the objective's creation, this will be identical to the Name tag below.
          •  Name: The internal name of this objective.
          •  RenderType: The type of data to store. Defaults to "integer".
      •  PlayerScores: A list of compound tags representing scores tracked by the scoreboard system.
        • A tracked player/objective pair with a score.
          •  Score: The score this player has in this objective.
          •  Name: The name of the player who has this score in this objective.
          •  Objective: The internal name of the objective which this player has this score in.
          •  Locked: 1 or 0 (true/false) - false if this objective is "enabled". Only meaningful for objectives with the criteria "trigger", where this must be false before a player can use the /trigger command on it.
      •  Teams: A list of compound tags representing teams.
        • A Team.
          •  AllowFriendlyFire: 1 or 0 (true/false) - true if players on this team can harm each other.
          •  SeeFriendlyInvisibles: 1 or 0 (true/false) - true if players on this team can see invisible teammates.
          •  NameTagVisibility: The value of the nametagVisibility option of this team.
          •  DeathMessageVisibility: The value of the deathMessageVisibility option of this team.
          •  DisplayName: The display name of this team. If none was specified during the team's creation, this will be identical to the Name tag below.
          •  Name: The internal name of this team.
          •  Prefix: The prefix prepended to names of players on this team. Ordinarily, it is a Formatting Code.
          •  Suffix: The suffix appended to names of players on this team. Ordinarily, it is the reset code, "§r", to prevent formatting from spilling over, but it may be blank if prefix is also blank.
          •  TeamColor: The text-based color ("black", "dark_blue", etc.) given to the team. Does not exist if no color is set.
          •  Players: A list of names of players on this team.
            • The name of a player on this team.
      •  DisplaySlots: A set of slots which are displaying specific objectives. If a slot is empty, its tag is not present.
        •  slot_0: The internal name of the objective displayed in the "list" slot.
        •  slot_1: The internal name of the objective displayed in the "sidebar" slot.
        •  slot_2: The internal name of the objective displayed in the "belowName" slot.
        •  slot_3: The internal name of the objective displayed in the "sidebar.team.black" slot.
        •  slot_4: The internal name of the objective displayed in the "sidebar.team.dark_blue" slot.
        •  slot_5: The internal name of the objective displayed in the "sidebar.team.dark_green" slot.
        •  slot_6: The internal name of the objective displayed in the "sidebar.team.dark_aqua" slot.
        •  slot_7: The internal name of the objective displayed in the "sidebar.team.dark_red" slot.
        •  slot_8: The internal name of the objective displayed in the "sidebar.team.dark_purple" slot.
        •  slot_9: The internal name of the objective displayed in the "sidebar.team.gold" slot.
        •  slot_10: The internal name of the objective displayed in the "sidebar.team.gray" slot.
        •  slot_11: The internal name of the objective displayed in the "sidebar.team.dark_gray" slot.
        •  slot_12: The internal name of the objective displayed in the "sidebar.team.blue" slot.
        •  slot_13: The internal name of the objective displayed in the "sidebar.team.green" slot.
        •  slot_14: The internal name of the objective displayed in the "sidebar.team.aqua" slot.
        •  slot_15: The internal name of the objective displayed in the "sidebar.team.red" slot.
        •  slot_16: The internal name of the objective displayed in the "sidebar.team.light_purple" slot.
        •  slot_17: The internal name of the objective displayed in the "sidebar.team.yellow" slot.
        •  slot_18: The internal name of the objective displayed in the "sidebar.team.white" slot.

History

r
1.5
{{Extension DPL}}<ul><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><li>[[Kelp|Kelp]]<br/>{{About|the plant|the dried variant|Dried Kelp}}
{{For}}
{{Block
|image=Kelp.gif
|invimage=Kelp
|transparent=Yes
|tool=Any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
|light=No
|hardness=0}}

'''Kelp''' is an underwater plant that generates in most [[ocean]]s.

== Obtaining ==

=== Natural generation ===

Kelp naturally generates in any [[ocean]] [[biome]]s (except in [[Frozen Ocean|frozen]], [[Deep Frozen Ocean|deep frozen]] and [[Warm Ocean|warm]]), near and around [[seagrass]]. Each chunk has {{frac|1|18}} chance to generate a [[vegetation]] of kelp.

=== Breaking ===

Kelp can be mined instantly with any [[tool]] or with the player's fist. Removing water from the kelp block destroys the kelp. Breaking one part of a kelp stalk destroys all kelp [[block]]s above it. Each block drops a kelp [[item (entity)|item]].

=== Trading ===

Kelp can be bought from [[wandering trader]]s for 3 emeralds.

== Usage ==

Kelp can be placed underwater by hand, or anywhere by the use of [[commands]] such as {{cmd|setblock}}. Placing it by hand gives it a random {{code|age}} value between 0 and 24. Kelp can be placed only in [[water]] source blocks or downward-flowing water, not horizontally flowing water.

When placed in downward-flowing water, the flowing water transforms into a water source block,<ref>{{bug|MC-134229}}</ref> which is useful for faster [[bubble column]] elevator creation.

Any building block can be placed on top of a kelp plant, which is useful for building structures over a deep ocean without needing to build from the ocean floor (see also [[lily pad]]).

=== Cooking ingredient ===

{{smelting
| showname = 1
| Kelp
| Dried Kelp
| 0.1
}}

=== Composting ===

Placing kelp into a [[composter]] has a 30% chance of raising the compost level by 1.

=== Growth mechanics ===

Kelp can be planted on a broad variety of blocks. It grows underwater if it has either a source block of water or, {{in|Java}}, flowing water above it.<ref>{{bug|MC-133354}}</ref> Neither [[player]]s nor [[dispenser]]s can remove the water source block that kelp grows in without breaking the kelp first.

Kelp does not require any [[light]] level to grow. Kelp also grows without having [[sky]] access. [[Bone meal]] can be used to grow kelp by 1 block on each use.

Kelp, when planted, is generated with a randomly chosen age value, which can be checked when pressing [[Debug screen|<kbd>F3</kbd>]]{{only|java}}. The age value of a newly planted kelp plant varies randomly from 0 to 24. Each time the kelp grows in height by one block, the newly generated top of the kelp plant increases its age by 1. When the top block of the kelp plant reaches an age of 25, it stops growing. This means that kelp can naturally grow to a height between 2 (if the first kelp plant had an age of 24) and 26 blocks (if the first kelp plant had an age of 0). 

When a kelp plant block is broken, the age of the kelp plant block underneath is randomized to a value from 0 to 24 and the kelp continues growing until it reaches age 25. It is possible to use this mechanic to cultivate a kelp plant to increase its growth height beyond its natural maximum height of 26 blocks. This can be done by breaking the top-most block of the kelp plant each time it reaches age 25. A kelp plant cultivated by a player in this way repeatedly grows until it reaches the water surface.

Each time it receives a [[random tick]], kelp has a 14% chance of growing.

If [[shears]] are used on the topmost block of kelp, that block automatically sets its {{cd|age}} value to {{cd|25}} and stop growing.{{only|JE}}

=== Farming ===
{{Main|Tutorials/Kelp farming}}
Kelp farming is similar to farming [[sugar cane]], although kelp must be placed underwater. Automation of harvest is easier because items float up in water.

== Sounds ==
=== Generic ===
{{Sound table/Block/Wet grass}}
=== Unique ===
{{edition|java}}:
{{Sound table
|sound=Shear.ogg
|subtitle=Plant cropped
|source=block
|description=When the tip of kelp is cropped with [[Shears#Cropping growing plants|shears]]
|id=block.growing_plant.crop
|translationkey=subtitles.block.growing_plant.crop
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}: ''None''

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Kelp
|spritetype=block
|nameid=kelp}}
{{ID table
|displayname=Kelp Plant
|spritetype=block
|nameid=kelp_plant
|form=block
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Kelp
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=kelp
|spritetype=item
|nameid=kelp
|id=382
|form=item}}
{{ID table
|displayname=Block
|spritename=kelp
|spritetype=block
|nameid=kelp
|id=393
|form=block
|itemform=item.kelp
|translationkey=-
|foot=1}}

=== Block states ===
{{see also|Block states}}

{{/BS}}

== History ==
{{History|java classic}}
{{History||May 21, 2009|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/110762705/my-list-on-tile-types-so-far|[[Notch]] shows interest in adding a "[[seaweed]]" [[block]].}}
{{History|java}}
{{History||November 18, 2017|link={{YouTubeLink|mAapz_nIC_Y}}|Kelp plants were shown in a clip of [[MineCon Earth]].}}
{{History||1.13|snap=18w07a|[[File:Kelp JE1 BE1.gif|32px]] [[File:Kelp (item) JE1 BE2.png|32px]] Added kelp.}}
{{History|||snap=18w07b|Kelp now behaves more like [[water]], meaning [[mob]]s can no longer spawn within the plant under water nor can they replenish their breath by [[swimming]] through it.}}
{{History|||snap=18w10a|[[File:Kelp JE2.gif|32px]] The texture for kelp has been overhauled.}}
{{History|||snap=18w14a|[[File:Kelp.gif|32px]] Top of the kelp textures have been shifted slightly downward.
|The generation rules for kelp have been changed, it now mainly generates in [[cold ocean]] [[biome]]s and can no longer generate in [[warm ocean]]s.}}
{{History|||snap=18w20a|The {{cd|kelp_top}} has been changed ID to {{cd|kelp}} and {{cd|kelp}} has been changed to {{cd|kelp_plant}}, for both the [[block]] and [[item]] forms.}}
{{History|||snap=pre2|Kelp is now destroyed by [[sponge]]s.<ref>{{bug|MC-127111}}</ref>}}
{{History|||snap=pre6|Added 5 new [[sound]] events that apply to kelp: <code>block.wet_grass.break</code>, <code>block.wet_grass.fall</code>, <code>block.wet_grass.hit</code>, <code>block.wet_grass.place</code>, and <code>block.wet_grass.step</code>.}}
{{History||1.14|snap=19w03a|Placing kelp into the new [[composter]] has a 10% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Kelp now has a 30% chance of increasing the compost level in a composter by 1.
|Added [[Wandering Trader|wandering trader]]s, which sell kelp.}}
{{History||1.16|snap=20w11a|Kelp can now be grown with [[bone meal]].}}
{{History|||snap=20w13a|Kelp has been moved from the Miscellaneous tab to the Decoration Blocks tab in the [[Creative inventory]].<ref name="misc decoration">https://bugs.mojang.com/browse/MC-174434</ref>}}
{{History||1.17|snap=20w46a|Kelp no longer generates on magma blocks.<ref>{{Bug|MC-185605|resolution=Fixed}}</ref>}}
{{History||1.18|snap=21w37a|Kelp now stops growing if [[shears]] are used on the tip.}}

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[File:Kelp JE1 BE1.gif|32px]] [[File:Kelp (item) BE1.png|32px]] Added kelp.}}
{{History|||snap=beta 1.2.20.1|[[File:Kelp (item) JE1 BE2.png|32px]] The kelp [[item]] texture has been updated to the {{el|je}}'s.}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Kelp.gif|32px]] The texture of the kelp plant has been updated.}}
{{History||1.10.0|snap=beta 1.10.0.3|Kelp can now be bought from [[wandering trader]]s for 3 [[emerald]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Kelp can now be used to fill [[composter]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Kelp.gif|32px]] [[File:Kelp (item) JE1 BE2.png|32px]] Added kelp.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* In real life, [[wikipedia:kelp|kelp]] is not considered a [[wikipedia:plant|plant]]. It is classified by scientists as a [[wikipedia:Brown algae|brown algae]].
** Kelp in real life absorbs nutrients directly from the water, instead of through its root-like structure, [[wikipedia:Holdfast (biology)|holdfast]], which merely attaches it to the seabed. This is in accordance with kelp being able to grow on almost any solid block in ''Minecraft''.

== Gallery ==
<gallery heights="60">
SeaPlantsMineConEarth2017.jpg|Kelp shown in a clip from MINECON Earth 2017. 
Kelp in ocean with Jappa textures.jpg|Naturally generated kelp in an [[ocean]] biome.
Kelp on shoreline.png|Naturally generated kelp near the shore.
Ocean life.png|An ocean with kelp visible in the far distance.
Kelp on Land.png|Kelp placed outside of [[water]] using the {{cmd|setblock}} command before 18w07b.
Waterless kelp.png|What kelp looks like without water (water removed using a [[resource pack]]).
Coral reef at night.png|Kelp within a [[coral reef]].
Floating Kelp.png|Kelp that generated in mid-air due to an [[ocean monument]]'s water cutting through it.
Kelp in ocean.jpg|Multiple kelps.
Kelp 255 blocks tall.png|Without obstacles, kelp can grow all the way to building limit.
ArgoMajor Kelp.jpg|First image of kelp in ''Bedrock Edition''.
</gallery>

== References ==
{{reflist}}

{{Blocks|vegetation}}
{{Items}}

[[Category:Plants]]
[[Category:Natural blocks]]
[[Category:Non-solid blocks]]

[[de:Seetang]]
[[es:Alga]]
[[fr:Algue]]
[[ja:コンブ]]
[[ko:켈프]]
[[pl:Wodorosty]]
[[pt:Alga]]
[[ru:Ламинария]]
[[th:สาหร่ายทะเล]]
[[zh:海带]]</li></ul>
13w04aAdded scoreboard.
13w05aAdded team-based functionality.
1.7
{{Extension DPL}}<ul><li>[[Written Book|Written Book]]<br/>{{Item
| title = Written Book
| image = Written Book.gif
| renewable = Yes
| stackable = Yes (16)
}}
A '''written book''' is an [[item]] created after a [[book and quill]] is signed.

== Obtaining ==

=== Signing a book and quill ===

Written books can be obtained by signing a [[book and quill]]. After it has been signed, it cannot be edited again. The label does not say "Written Book", but whatever the [[player]] titles it. The title appears on the top line of the label, and "by <''player''>" (the player's username) on the bottom. {{IN|bedrock}}, this is customizable without [[commands]].

=== Copying ===

{{crafting
|name=Written Book
|showdescription=1
|;;;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;;;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;;;;Book and Quill;Book and Quill;Book and Quill
|Book and Quill
|Written Book
|;;;;;;Book and Quill;Book and Quill
|;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill;Book and Quill
|;;;;;;;Book and Quill
|Output= Written Book; Written Book,2; Written Book,3; Written Book,4; Written Book,5; Written Book,6; Written Book,7; Written Book,8
|description=The input written book is not consumed.<br>The new copies are "Copy of Original" or "Copy of Copy", depending on whether the input written book is "Original" or "Copy of Original".<br>Copies of copies cannot be copied.<br>Copied books of the same generation ("Original", "Copy of Original", "Copy of Copy", or "Tattered") stack.
|type=Miscellaneous
}}

== Usage ==

Written books can be opened by right-clicking (or holding down on the screen {{in|bedrock}}), and display a GUI allowing the [[player]] to read it or turn the page.

The contents of a book are an extra set of data attached to the item. This means that when a book is destroyed, its contents are lost with it.

=== Lecterns ===

One can place 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.

=== Chiseled bookshelf ===
{{control|Use|text=Using}} the [[chiseled bookshelf]] while having a written book in the main hand will put the book inside the chiseled bookshelf.

== Sounds ==
{{edition|java}}:
{{Sound table
|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
|sound=Page turn1.ogg
|sound2=Page turn2.ogg
|sound3=Page turn3.ogg
|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 written book 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 written book 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 written book is placed in a chiseled bookshelf
|id=insert.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound>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 written book is removed from a chiseled bookshelf
|id=pickup.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|foot=1}}

== Data values ==
=== ID ===
{{JE}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Written Book
|spritetype=item
|nameid=written_book
|itemtags=bookshelf_books, lectern_books
|form=item
|foot=1}}

{{BE}}:
{{ID table
|edition=bedrock
|showitemtags=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Written Book
|spritetype=item
|nameid=written_book
|id=511
|itemtags=minecraft:bookshelf_books, minecraft:lectern_books
|form=item
|foot=1}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Written Books}}
</div>

{{el|bedrock}}:
: See [[Bedrock Edition level format/Item format]].

== History ==
{{History|java}}
{{History||1.3.1|snap=12w17a|[[File:Written Book JE1 BE1.png|32px]] Added written books.}}
{{History|||snap=12w21a|Written books can now be [[trading|sold]] to librarian [[villager]]s, at 1 written book for 1 [[emerald]].}}
{{History||1.7.2|snap=13w36a|Written books can now be cloned the same way [[map]]s can, but by using [[book and quill|books and quills]] instead of Empty Maps. Multiple copies of the same written book can be cloned by putting more book and quills in the crafting grid. 
|Written books can now be stacked (up to 16 per stack).}}
{{History||1.8|snap=14w02a|[[Trading]] has been changed: librarian [[villager]]s now [[trading|buy]] 2 written books for 1 [[emerald]].}}
{{History|||snap=14w05a|Copying written books now mark them as "Copy of Original" or "Copy of Copy". The copying status of a book is denoted in a separate line in the tooltip, beneath the author's name. Copies of copies cannot be copied.}}
{{History||1.9|snap=15w33c|A written book titled "Work in Progress" now generates within a [[hopper]] as a part of the [[end ship]] in the [[end cities]]. It reads: "We will have something else here soon..." and is signed by [[Searge]].}}
{{History|||snap=15w41a|End ships no longer contain a written book.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 387.}}
{{History||1.14|snap=18w43a|[[File:Written Book JE2 BE2.png|32px]] The texture of written books has been changed.}}
{{History|||snap=19w02a|Written books can now be held on [[lectern]]s.}}
{{History|||snap=19w11a|Librarian [[villager]]s no longer [[trading|buy]] written books.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Written books can now interact with [[chiseled bookshelves]].}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Written Book JE1 BE1.png|32px]] Added written books.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Written Book JE2 BE2.png|32px]] The texture of written books has been changed.
|Written books can now be held on [[lectern]]s.}}

{{History|console}}
{{History||xbox=TU25|xbone=CU14|ps=1.17|wiiu=Patch 1|[[File:Written Book JE1 BE1.png|32px]] Added written books.}}
{{History|PS4}}
{{History||1.90|[[File:Written Book JE2 BE2.png|32px]] The texture of written books has been changed.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*When written books are obtained with [[commands]] (without the correct [[Player.dat format#Written Books|data tag]]), the label shows "Written Book" and has the text "*Invalid book tag*" when opened. The book is signed and cannot be edited without commands.
*Commands that were added to a written book using serialized JSON objects are executed through the chat system. This means that any command added to a written book can't be longer than 256 characters, which is the maximum chat line limit.
*During the 2020 April Fools Update [[Java Edition 20w14∞]], throwing a written book into a lit [[Nether Portal (block)|nether portal]] would create a portal to one of the 2,147,483,645 new dimensions.

== Gallery ==
<gallery>
Written Book tooltip.png|A signed book.
Test by Dinnerbone.png|Copying a signed book.
BookandQuillOperators12w17a.png|Different types of characters can be used to simulate a different font.
JSON Book.png|First image of a book using JSON text.
No NBT written book GUI.png|A no NBT written book using commands.
Book Background (JE).png|Java Edition book background texture.
Book Background (BE).png|Bedrock Edition book background texture.
Book Arrowleft (JE).png|Java Edition left arrow texture.
Book Arrowright (JE).png|Java Edition right arrow texture.
Book Arrowleft (BE).png|Bedrock Edition left arrow texture.
Book Arrowright (BE).png|Bedrock Edition Right arrow texture.
</gallery>

== See also ==
*[[Book]]
*[[Bookshelf]]
*[[Book and Quill]]

{{Items}}

[[Category:Renewable resources]]

[[cs:Napsaná kniha]]
[[es:Libro escrito]]
[[fr:Livre édité]]
[[hu:Megírt könyv]]
[[it:Libro]]
[[ja:記入済みの本]]
[[ko:글이 쓰인 책]]
[[nl:Geschreven boek]]
[[pl:Zapisana książka]]
[[pt:Livro escrito]]
[[ru:Написанная книга]]
[[uk:Написана книга]]
[[zh:成书]]</li><li>[[:Category:Minecraft: Story Mode items|Category:Minecraft: Story Mode items]]<br/>[[Category:Minecraft: Story Mode]]
[[Category:Items]]</li></ul>
13w36aAdded statistic-based objective criteria.
u
1.8
{{Extension DPL}}<ul><li>[[:Category:Dyes|Category:Dyes]]<br/>These are items that can be used to dye sheep, wool blocks, or combined to make other dyes.

[[Category:Items]]

[[es:Categoría:Tintes]]
[[fr:Catégorie:Teinture]]
[[hu:Kategória:Festékek]]
[[zh:Category:染料]]</li><li>[[Lapis Lazuli|Lapis Lazuli]]<br/>{{Item
| image = Lapis Lazuli.png
|type=
| renewable = Yes
| stackable = Yes (64)
}}
{{About|the item|the ore|Lapis Lazuli Ore|the mineral block|Lapis Lazuli Block}}

'''Lapis lazuli''' is a mineral required to [[Enchanting|enchant]] items in an [[Enchanting Table|enchanting table]].

== Obtaining ==

=== Mining ===

When mined with a stone [[pickaxe]] or better, [[lapis lazuli ore]] drops 4–9 lapis lazuli. With the [[Fortune]] III enchantment, a single block has a chance of dropping up to 36 items.

=== Crafting ===

{{Crafting
  |Block of Lapis Lazuli
  |Output=Lapis Lazuli,9
  |type=Material
}}

=== Smelting ===
{{Smelting
  |showname=1
  |Lapis Lazuli Ore; Deepslate Lapis Lazuli Ore
  |Lapis Lazuli
  |0.2
}}

=== Villager gifts ===

{{IN|java}}, cleric [[villager]]s give [[player]]s lapis lazuli if they have the [[Hero of the Village]] effect.

=== Trading ===

Apprentice-level cleric villagers sell one lapis lazuli for an [[emerald]] as part of their trades.

{{IN|bedrock}}, [[wandering trader]]s may sell 3 lapis lazuli for an emerald.

=== Chest loot ===
{{see also|Lapis Lazuli Ore#Natural generation}}
{{LootChestItem|lapis-lazuli}}

== Usage ==

=== Enchanting ===

1–3 pieces of lapis lazuli are required to use an [[Enchanting Table|enchanting table]] to enchant an [[items|item]]. More specifically, the enchanting table UI shows 3 options (see [[Enchanting mechanics]] for details): the first, second, and third options cost 1, 2, and 3 lapis lazuli, respectively.

=== Crafting ingredient ===

Lapis lazuli can be used to make [[blocks of lapis lazuli]] and [[blue dye]]. {{IN|bedrock}}, it can also be used directly as a substitute for blue dye.
{{crafting usage}}

{{IN|bedrock}}, lapis lazuli can be also used in banner patterns:
{{banner crafting usage}}

=== Loom ingredient === 
{{Banner loom usage|Lapis Lazuli}}

=== Dye ===
{{Dye usage}}

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Lapis Lazuli
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Lapis Lazuli
|Lapis Trim Netherite Chestplate
|showdescription=1
|description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example.<br/>
|tail=1
}}

;Trim color palette
The following color palette is shown on the designs on trimmed armor:
*{{TrimPalette|lapis lazuli}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Lapis Lazuli
|spritetype=item
|nameid=lapis_lazuli
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Lapis Lazuli
|spritetype=item
|nameid=lapis_lazuli
|aliasid=dye / 4
|id=414
|form=item
|translationkey=item.dye.blue.name
|foot=1}}

== Advancements ==
{{load advancements|Enchanter}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Lapis Lazuli JE1 BE1.png|32px]] Added lapis lazuli.}}
{{History||1.2_02|[[Lapis lazuli ore]] can now be found at [[bedrock]] level and now drops 4–8 lapis lazuli per block mined (increased from 1) on [[singleplayer]] only. However, servers have not been affected yet.}}
{{History||1.8|snap=Pre-release|Lapis lazuli can now be found in [[mineshaft]] [[chest]]s.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Lapis lazuli can now be used to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Lapis lazuli can now be [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|Lapis lazuli can now be used to craft blue [[stained clay]].}}
{{History||1.7.2|snap=13w41a|Lapis lazuli can now be used to craft blue [[stained glass]].}}
{{History||1.8|snap=14w02a|[[Enchanting]] now requires lapis lazuli. Different enchantments require different amounts of levels and different amounts of levels now require different amounts of lapis lazuli (between 1-3).
|Cleric [[villager]]s now [[trading|sell]] 1–2 lapis lazuli for 1 [[emerald]], making it a [[renewable resource]].}}
{{History|||snap=14w30a|Lapis lazuli can now be used to dye [[banner]]s.}}
{{History||1.9|snap=15w44a|The average yield of lapis lazuli in [[mineshaft]] [[chest]]s has been decreased.}}{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Can now be used to craft blue [[concrete powder]].}}
{{History|||snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History|||snap=18w11a|Lapis lazuli now generates in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|Lapis lazuli can now be used to craft [[blue dye]].
|Lapis lazuli can no longer be used as a [[dye]].
|All of the dye-related functions and crafting recipes of lapis lazuli (except lapis lazuli blocks) have been transferred to blue dye.
|[[File:Lapis Lazuli JE2 BE2.png|32px]] The texture of lapis lazuli has been changed.}}
{{History|||snap=18w50a|Lapis lazuli can now be found in chests in [[village]] temples.}}
{{History|||snap=19w13a|Cleric villagers now give lapis lazuli to players under the [[Hero of the Village]] effect.}}
{{History||1.17|snap=21w08a|Lapis lazuli can now drop and be smelted from [[deepslate lapis lazuli ore]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Lapis lazuli can now be used as an armor trim material.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Lapis Lazuli JE1 BE1.png|32px]] Added lapis lazuli.}}
{{History||v0.3.2|Lapis lazuli can now be crafted into lapis lazuli blocks, and vice versa.}}
{{History||v0.12.1|snap=build 1|Lapis lazuli is now required for [[enchanting]].}}
{{History||v0.14.0|snap=build 1|Lapis lazuli can now be found inside [[minecart with chest]]s in [[mineshaft]]s.
|Lapis lazuli can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Cleric [[villager]]s now [[trading|sell]] 1–2 lapis lazuli for 1 [[emerald]].
|Lapis lazuli can now be used to [[dyeing|dye]] [[shulker shell]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Lapis lazuli can now be used to dye [[shulker box]]es and [[bed]]s.
|Lapis lazuli can now be used to [[crafting|craft]] blue [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Lapis lazuli can now be used to dye [[banner]]s, [[firework star]]s and [[glass]].}}
{{History||1.4.0|snap=beta 1.2.14.2|Lapis lazuli can now be found in [[shipwreck]] treasure chests.}}
{{History|||snap=beta 1.2.20.1|Lapis lazuli can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.10|Lapis lazuli can now be used to craft [[blue dye]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Lapis lazuli are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Lapis Lazuli JE2 BE2.png|32px]] The texture of lapis lazuli has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Lapis lazuli can now be found in [[desert]] [[village]] temple [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Cleric [[villager]]s now [[trading|sell]] one lapis lazuli for one [[emerald]].}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of lapis lazuli has been changed from <code>dye/4</code> to <code>lapis_lazuli</code>.}}
{{History||1.17.0|snap=beta 1.16.230.52|Lapis lazuli can now drop and be smelted from [[deepslate lapis lazuli ore]].}}
{{History||1.19.80|snap=beta 1.19.80.21|Lapis lazuli can now be used as an armor trim material.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Lapis Lazuli JE1 BE1.png|32px]] Added lapis lazuli.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|Lapis lazuli can now be used in [[enchanting]].}}
{{History|Ps4}}
{{History||1.90|[[File:Lapis Lazuli JE2 BE2.png|32px]] The texture of lapis lazuli has been changed.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* In real life, lapis lazuli is a blue gem that can be ground and processed into ultramarine pigment. Lapis lazuli pigment has been famously used in the production of illuminated manuscripts, stained glass, and cave paintings. [[Wikipedia:Lapis lazuli|See the Wikipedia article for more information]].
* Lapis lazuli is the only [[ore]] that can be used as a [[dye]]{{only|BE|short=1}} or making a dye.
* It is the only item that can be put in the second slot of an [[enchantment table]].

== References ==
{{reflist}}

{{Items}}

[[Category:Dyes]]

[[cs:Lazurit]]
[[de:Lapislazuli]]
[[es:Lapislázuli]]
[[fr:Lapis-lazuli]]
[[hu:Lazurit]]
[[ja:ラピスラズリ]]
[[ko:청금석]]
[[nl:Lapis lazuli]]
[[pl:Lazuryt]]
[[pt:Lápis-lazúli]]
[[ru:Лазурит]]
[[th:แร่แลพิสแลซูลี]]
[[uk:Лазурит]]
[[zh:青金石]]
[[Category:Renewable resources]]</li></ul>
14w02aEntities other than players can now be part of teams and have objective scores.
14w06aAdded the trigger and team kill-based objective criteria.
Added /scoreboard players enable.
"*" can be used in a player name argument to represent all players tracked by the scoreboard.
Added the "objective" argument to /scoreboard players reset.
Statistic objective criteria now use named IDs instead of numerical IDs.
14w07aAdded /scoreboard operation and /scoreboard test.
Scores for fake players that have a name beginning with "#" won't appear in the sidebar.
Added team-specific sidebar display slots.
Added the nametagVisibility team option.
14w10aAdded the deathMessageVisibility team option.
Added a dataTag argument to /scoreboard players set, /scoreboard players add, and /scoreboard players remove.
Added the stat.crouchOneCm, stat.sprintOneCm, and stat.timeSinceDeath objective criteria.
14w25aAdded =, <, and > to /scoreboard players operation.

Issues

Issues relating to "Scoreboard" are maintained on the bug tracker. Report issues there.

Gallery

  • An objective with two points to the player is displayed in the "list" slot, while an objective with the display name "Quest Points" with 0 points to the player is displayed in the "sidebar" slot.

    An objective with two points to the player is displayed in the "list" slot, while an objective with the display name "Quest Points" with 0 points to the player is displayed in the "sidebar" slot.

References

  1. ↑ https://twitter.com/Dinnerbone/status/364670393354694656
  2. ↑ https://twitter.com/Dinnerbone/status/365438719823577088
  3. ↑ https://twitter.com/Dinnerbone/status/368015870683254784

Gameplay 

View at: Template:Gameplay/content [edit]
Minecraft
Help
Menu screens
Aspects
Examples
Game customization
Editions
Java
Bedrock
Merged
Ports to consoles
Discontinued
Other
Discontinued
Legacy Console
Other
Miscellaneous
Deutsch Español Français Nederlands Polski Русский 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki