Datapack Codex

Item format/Written Books

Minecraft Wiki article. Categories: Removed_features, Top-level_data_pages

📌 Mirrored from Minecraft Wiki

This article is reproduced from Item format/Written Books on the Minecraft Wiki. Mirrored from revision 2814115. It is licensed CC BY-NC-SA 3.0 by the Minecraft Wiki contributors — not under the Codex’s CC BY-SA 4.0, and it may not be used commercially. Edits belong upstream, not here.

BlockSprite rose.png: Sprite image for rose in Minecraft
This page describes content that has been removed and was only present in earlier versions of Java Edition.
 
In Java Edition 1.20.5, this format has been replaced with the data component format.
    • [NBT Compound / JSON Object] filtered_pages: Only in Realms. The pages shown to players with the profanity filter turned on instead of some of the regular pages. This compound is automatically given a tag named after the page number and set to "" when a player with the profanity filter turned off closes or signs a book with that specific page containing one or more blocked words, so players with the filter on cannot see the blocked words. If a player with the filter on tries to use blocked words in one or more of the pages, this compound is not given any new tags and the specific page(s) in [NBT List / JSON Array] pages are instead set to "", which makes the page(s) render completely blank. If multiple pages have been edited before the book is closed, only the pages containing blocked words are blanked.
    • [String] filtered_title: Only in Realms. The title shown to players with the profanity filter turned on instead of the regular title. This tag is automatically set to "" when a player with the profanity filter turned off signs a book with a title containing one or more blocked words, so players with the filter on cannot see the blocked words. If a player with the filter on tries to use blocked words in the title, this tag is not added and the [String] title tag is instead set to "", which makes the title render as "Written Book", as if it weren't named.
    • [Byte] resolved: Optional. Created and set to 1 when the book (or a book from the stack) is opened for the first time after being created. Used to determine whether to resolve advanced components within JSON, because their values become fixed at that point.
    • [Int] generation: Optional. The copy tier of the book. 0 = original, 1 = copy of original, 2 = copy of copy, 3 = tattered. If the value is greater than 1, the book cannot be copied. Does not exist for original books. If this tag is missing, it is assumed the book is an original. 'Tattered' is unused in normal gameplay, and functions identically to the 'copy of copy' tier.
    • [String] author: The author of the written book.
    • [String] title: The title of the written book. Lower priority than the item name set by tag.display.Name. Cannot be used to open locked containers.
    • [NBT List / JSON Array] pages: The list of pages in the book.
      • [String]: A single page in the book. Each page is a serialized JSON text.

Sources

Datapack Codex — The all-versions Minecraft data pack reference. Community reference; not affiliated with Mojang Studios or Microsoft. “Minecraft” is a trademark of Mojang Synergies AB.

Primary syntax targets Minecraft Java Edition 1.21+ (singular folder names). Version-specific behaviour is flagged inline and mapped on the pack_format history page.