BottledExp: Store Your Minecraft XP in Bottles

BottledExp is a Bukkit plugin for Minecraft that lets you bottle your experience points into potions, keeping them safe on death and allowing trades between players.

Download BottledExp

Original name: BottledExp

FileVersionLoaderSize
BottledExp.jar5 КБDownload

BottledExp: Store Your XP in Bottles for Minecraft

Experience points in Minecraft are among the most valuable resources a player can accumulate. They fuel enchanting, repair vital gear, and unlock the full potential of late-game equipment. Yet, the vanilla game offers no reliable way to bank those hard-earned levels. Death means losing a substantial portion of your progress, and the experience bar itself is a blunt instrument—either you use it immediately or risk losing it entirely. This is where BottledExp: Store Your XP in Bottles for Minecraft steps in, offering a clever and practical solution that turns raw experience into tangible, storable glass bottles.

This server-side utility is designed for Bukkit and its popular forks, including Spigot and Paper. It introduces a straightforward mechanic: players can pour their experience into empty glass bottles, creating experience potions that can be stored, traded, or sold. The system is intuitive, requiring no complex crafting recipes. Everything is managed through simple chat commands, making it accessible to both seasoned administrators and newcomers alike.

Core Functionality and Design Philosophy

The primary goal of BottledExp is to give players agency over their experience points. Instead of being forced to enchant items they do not need, players can now bank their levels for future use. The process is simple: a player types a command, the plugin deducts a specified amount of experience, and in return, it provides a glass bottle filled with that experience. When the player needs the levels back, they simply break the bottle on the ground or use it, and the experience is restored.

The plugin supports three distinct modes for filling bottles. The first mode allows a player to specify an exact number of bottles to create. The second mode, often referred to as the "max" mode, converts all available experience into as many bottles as possible. This is particularly useful for clearing the experience bar before a dangerous expedition. The third mode is informational, displaying the player's current experience total in both levels and raw points, which is essential for precise planning.

Flexible Configuration for Server Administrators

One of the standout features of BottledExp is its deep configurability. Server owners have granular control over the economy of experience on their servers. The configuration file, config.yml, is generated automatically upon first run and contains a wealth of options. The price parameter allows administrators to set a base cost for each bottle, either as a fixed value or a multiplier applied to the plugin's internal experience formula.

Beyond the base cost, the plugin can be configured to consume a specific item during the bottling process. By default, this is a standard glass bottle, but administrators can change it to any material, such as a gold nugget or a diamond. This feature can be disabled entirely, allowing free conversion of experience. For servers with an economy plugin, the consumeMoney option integrates with Vault to deduct a set amount of in-game currency per bottle, creating a sink for server wealth.

Permission handling is also highly adaptable. The checkForPermission setting determines whether the plugin enforces permission nodes. If set to false, all players can use the core commands without any additional setup, which is ideal for small, private servers. For larger communities, the plugin supports standard permission nodes such as bottle.use, bottle.max, and bottle.reload, which can be assigned through popular permission managers like LuckPerms or PermissionsEx. Additionally, the language option allows for full localization of messages, ensuring the interface is clear for any player base.

Installation and Setup

Installing BottledExp is a straightforward process. To begin, you will need to download BottledExp: Store Your XP in Bottles for Minecraft from a trusted source. Once the .jar file is obtained, the installation is a simple matter of placing it into the /plugins folder of your Minecraft server directory. After a server restart, the plugin will load and generate its default configuration file. No external libraries are required for the base functionality, though integrating the money-spending feature will require Vault and a compatible economy plugin such as EssentialsX or CMI.

For those unfamiliar with manual server management, there are launchers that simplify the process of adding plugins. Many modern launchers allow you to browse and install server-side mods directly from their interface, which can save considerable time and reduce the risk of configuration errors. This is a convenient option for players who want to test the plugin quickly or for administrators who manage multiple servers.

Understanding the Commands

The command structure of BottledExp is clean and easy to learn. The primary command is /bottle, which has several subcommands. Typing /bottle alone displays the player's current experience level and total points. Adding a number, such as /bottle 5, instructs the plugin to convert five levels into experience bottles. The plugin calculates the exact amount of experience to remove and provides the corresponding bottles. The /bottle max command is a powerful tool that converts the player's entire experience pool into bottles, leaving the bar empty. Finally, /bottle reload is reserved for administrators, allowing them to apply configuration changes without a full server restart.

To ensure a smooth experience, it is recommended to test the configuration on a local copy of your world before applying changes to a live server. This prevents accidental balance issues or unintended interactions with other plugins.

Evolution and Version History

BottledExp has a rich history of development, evolving from a simple utility into a robust tool. Early versions focused on core functionality, with version 1.1 addressing a duplication exploit involving infinite bottle stacks. Version 1.2 introduced support for PermissionsEx, laying the groundwork for advanced permission management. A major milestone was reached in version 1.4, which added the ability to require a specific item for the bottling process and introduced an alternative method for calculating experience points.

The integration with Vault in version 1.5 was a game-changer, enabling the plugin to interact with server economies. This allowed servers to treat experience as a tradeable commodity, with players able to buy and sell bottled XP for in-game currency. The latest iteration, version 1.7.3, focuses on precision, improving the accuracy of experience calculations at higher levels where the standard formula could introduce errors. Throughout its history, the plugin has been adapted for various Minecraft versions, from 1.3.1 up to 1.7.2, and remains a reliable choice for servers running these versions.

Practical Use Cases and Scenarios

The versatility of BottledExp makes it a valuable addition to many different server types. On economy-focused servers, it creates a new market dynamic. Players who grind experience can bottle it and sell it to those who need levels for enchanting but lack the time to farm. This creates a player-driven economy where experience becomes a liquid asset.

On PvP or hardcore survival servers, the plugin is a lifesaver. Before a high-stakes raid, players can bank their experience to protect it from the death penalty. After the battle, they can restore their levels instantly, allowing them to re-enchant their gear and get back into the action without a lengthy grind. On smaller, private servers, the plugin simply removes the annoyance of having a full experience bar with nothing to spend it on. Players can store their progress in a chest, creating a personal reserve of levels for future projects.

Conclusion

BottledExp: Store Your XP in Bottles for Minecraft is a deceptively simple plugin that solves a persistent problem in the vanilla game. It provides a safe, efficient, and highly configurable method for storing experience, turning a volatile resource into a stable asset. Whether you are an administrator looking to add depth to your server's economy or a player who wants to stop losing progress to unexpected deaths, this plugin is a worthwhile addition. Its ease of installation, combined with its powerful configuration options, makes it a top-tier utility. If you are looking for a way to manage your experience more effectively, consider how to install this tool and give it a try—you may find it hard to play without it once you have experienced the convenience of banking your levels.