🧪 Bottled Levels

Bottled Levels adds a refillable experience bottle that lets you store whole levels and recover them later, while preserving the progress already in your experience bar.

Keep levels for your next enchanting session, store spare bottles, and adjust the rules for your singleplayer world or multiplayer server.

✨ How it works

Craft a bottle using 4 Lapis Lazuli placed above, below, and on either side of a Glass Bottle in a crafting table.

Store levels by sneaking and right-clicking with the bottle. A single interaction transfers the maximum possible number of complete levels, limited by your available levels and the bottle's remaining capacity.

Recover levels by holding right-click without sneaking to drink. Every level stored in the bottle is added to your current level, and the empty bottle remains reusable.

Whole levels, preserved progress. Depositing and drinking keep the same percentage of progress in your experience bar. Bottled Levels stores a number of levels, not a fixed amount of raw XP points.

Example: storing and recovering 22 levels

With an empty bottle that can hold 30 levels, you have 22 levels and a half-full experience bar.

After one sneak-right-click, the bottle contains 22 levels. You are left at level 0 with a half-full bar.

Later, you reach level 15. Drinking that bottle brings you to level 37, while preserving whatever experience-bar progress you had immediately before drinking.

🧴 Bottle features

• 7 visual stages show how full the bottle is relative to its capacity.
• Reusable and stackable bottles let you organize your stored levels. Matching bottles with the same stored level count stack together, and emptied bottles stack with fresh ones.
• One bottle per interaction means filling or drinking from a stack only changes the bottle being used.
• Sound feedback accompanies filling, drinking, and reaching full capacity.

⚙️ World & server settings

Configure each world or server independently through operator commands.

By default, each bottle holds 30 levels, successful transfers have a 5-second cooldown, and damage on deposit is disabled.

Server operators can adjust bottle capacity, enable an optional health cost when depositing levels, and change or disable the cooldown.

The cooldown is shared across all Bottled Levels bottles used by the same player, including bottles in different stacks.

Operator commands

Command	Purpose
/bottledlevels	Show the current world's settings.
/bottledlevels capacity <levels>	Set the maximum number of levels per bottle.
/bottledlevels damage <enabled>	Enable or disable damage on deposit using true or false.
/bottledlevels damage amount <health-points>	Set the damage dealt per successful deposit.
/bottledlevels cooldown <seconds>	Set the cooldown after depositing or drinking.

Set /bottledlevels cooldown 0 to disable the cooldown.

These commands require operator permissions in both singleplayer and multiplayer. Settings are saved in bottled_levels.json inside the corresponding world's save folder.

📦 Installation

Available for Minecraft 1.21.11 — Fabric.

Requirement	Version
Fabric Loader	0.19.3 or newer
Fabric API	0.141.4+1.21.11 or newer, for Minecraft 1.21.11

For multiplayer, install Bottled Levels and its required dependencies on both the server and each player's client.

Upgrading from an older version

Some older bottles contain XP-point data without a recorded level count. When an exact whole-level conversion cannot be determined, their contents are preserved and transfers are blocked rather than guessing a value.

💬 Support & feedback

Report bugs, compatibility problems, feature requests, or requests for additional Minecraft versions through GitHub Issues.

For bug reports, include your Minecraft version, Bottled Levels version, and the steps needed to reproduce the issue.

Discord: FrenchDevs Source code: GitHub