⚠️ v1.6 UPDATE: XP Book II and III were removed, and item data changed! v1.6 converts everything: update to v1.6 first, open your world, and put your books in a crafting table to update them.

⚠️ Since v1.6.1, this conversion is gone: books and bottles that were not converted with v1.6 lose their content, so don’t skip v1.6!

| Data pack | XP Book | Upgrades |
|—|—|—|
| none (Default) | 15 levels, gives back 85%, 1 level per brewed bottle | Diamond (30 levels, 90%, 3), Netherite Ingot (50 levels, 95%, 5), Nether Star (100 levels, 100%, 10) |
| Easy-Default xp_storage:easy_default | 15 levels, gives back 100% | Same as default, all at 100% |
| Legacy xp_storage:legacy | 30 levels, gives back 100%, 1 level per brewed bottle | None |
| Balanced-Legacy xp_storage:balanced_legacy | 30 levels, gives back 90%, 3 levels per brewed bottle | None |
| OP-Legacy xp_storage:op_legacy | 100 levels, gives back 100%, 5 levels per brewed bottle | None |

Crystallized Lapis

• 4 Lapis Lazuli (it stores experience, so that makes sense)
• 1 Amethyst Shard (it’s a precious gem)

XP Book

• Stores up to 15 levels without upgrades (data pack).

This means the experience to go from level 0 to level X! That’s not the same amount as the experience from level Y to level X+Y!

• 1 Book (of course, it’s a book)
• 4 Crystallized Lapis

Smithing Template

• Upgrades XP Books of any level, only the ingredient that goes with it changes
• 1 Diamond
• 8 Crystallized Lapis

Smithing Template Duplication

• 1 Smithing Template
• 4 Crystallized Lapis

XP Book

• Store experience: Right click to store as much of your experience as the book can hold. If you have more experience than the book can hold, you keep the rest

• Retrieve experience: Right click while sneaking to get back 85, 90, 95 or 100% (depending on the book’s level) of the experience stored in the book

Brewing

• Put the XP Book in the brewing stand as the ingredient, with mundane potions or Experience Bottles made by brewing. Each brew takes 1, 3, 5 or 10 levels (depending on the book’s level) from the book for each bottle, and puts them in the resulting Experience Bottle (or adds them to it). The book is not consumed: only its experience is!
• Each Experience Bottle can hold up to 30 levels (config; in the brewing recipes on Minecraft 26.3+)

XP Book Upgrades

• Upgrade the book so it stores more experience and gives it back more efficiently
• Craft an XP Book Upgrade Smithing Template and use it with the right ingredient for the level of the XP Book you put in: Diamond, Netherite Ingot or Nether Star
• Every upgrade is a recipe: change them, or add new levels, with a data pack (see below)

Everything about the books lives in recipes. Override a recipe by putting a file with the same id in your data pack. If you also use a built-in data pack, enable yours after it (above it in /datapack list).

XP Book: xp_storage:xp_book

The crafted book carries its data in its result:

• capacity: levels it can store
• xpFromUsing: percentage of the experience given back when used
• xpFromBrewing: levels put in each brewed bottle
• barColor: color of the experience bar, as a decimal RGB number

"result": {
  "id": "xp_storage:xp_book",
  "components": {
    "xp_storage:book_component": {
      "level": 0, "capacity": 15, "xpFromUsing": 85, "xpFromBrewing": 1, "barColor": 1856424
    }
  }
}

Upgrades: xp_storage:xp_book_upgrade/level_0, level_1, level_2

Smithing recipes, one per book level: baseLevel is the level of the book you put in. Add a level_3 recipe to go further!

{
  "type": "xp_storage:xp_book_upgrade",
  "template": "xp_storage:xp_book_upgrade_smithing_template",
  "base": "xp_storage:xp_book",
  "addition": "minecraft:diamond",
  "baseLevel": 0,
  "resultCapacity": 30,
  "resultXpFromUsing": 90,
  "resultXpFromBrewing": 3,
  "resultBarColor": 10615784
}

Brewing (Minecraft 26.3+, v1.6.2+)

Two brewing recipes: xp_storage:brewing/experience_bottle (the first brew, from a mundane potion) and xp_storage:brewing/experience_bottle_upgrade (a brewed bottle brewed again). Change the potion, restrict the book, or set the bottles’ maximum level. max_level is optional: remove it and bottles have no maximum level.

{
  "type": "xp_storage:experience_brewing",
  "input": {"item": "minecraft:potion", "potion_contents": {"potions": "minecraft:mundane"}},
  "reagent": {"item": "xp_storage:xp_book"},
  "output": {"id": "minecraft:experience_bottle"},
  "max_level": 30
}

Operators get a warning if two data packs give an upgrade for the same book level.