Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Bottle your Minecraft experience points into Bottles o' Enchanting with /bottle and full tax control.
🧪 ExpToBottles — Precision XP Bottling & High-Speed Farm Vacuum
ExpToBottles is a modern, high-performance plugin for Paper and Purpur Minecraft servers that allows players to safely bottle their experience points (XP), trade them, store them, and redeem them at any time with zero rounding loss.
It also includes a built-in Fast XP Vacuum, ending the lag and hassle of waiting around massive piles of XP orbs at Enderman, Gold, and Raid farms!
✨ Features
- 🎯 Exact Vanilla XP Mathematics:
- Implements the official Minecraft XP formulas (Levels 0–15, 16–30, 31+).
- Handles point-based and level-based conversions with 100% precision. Zero points lost!
- ⚡ Intuitive Bottling:
- Via Commands: Flexible syntax like
/bottle 500,/bottle 10l,/bottle all, or/bottle until 30. - Via Quick-Click: Simply hold an empty glass bottle and sneak-right-click (
Shift + Right Click)!
- Via Commands: Flexible syntax like
- 🔄 Two Ways to Redeem XP:
- Instant Drink: Right-click to drink the bottle and absorb stored XP immediately without spawning entity orbs.
- Throw as Splash Bottle: Throw it like a vanilla bottle o' enchanting. On collision, it accurately spawns the stored XP orbs.
- Configurable empty glass bottle refund upon drinking.
- 🌀 Fast XP Vacuum (Lag-Free Mob Farms):
- Fixes the classic farm issue where hundreds of XP orbs cause server and client stutter.
- Smoothly pulls orbs in a configurable radius (e.g. 5 blocks) and absorbs them in rapid batches directly into the player.
- Full Mending Support: Repairs damaged Mending armor and tools first (2 durability per 1 XP), then adds the remainder into the player's level bar.
- Toggleable by players anytime via
/bottle vacuum.
- 🎨 Adventure & MiniMessage Design:
- Beautiful gradients and lore on bottled items.
- Safe NBT / PersistentDataContainer (PDC) storage across server restarts.
📜 Commands & Aliases
Main command: /bottle (Aliases: /bottlexp, /xpbottle, /expbottle)
| Command | Description | Permission | Default |
|---|---|---|---|
/bottle |
Bottles 1 level of your experience | exptobottles.use |
Everyone (true) |
/bottle all |
Bottles all of your current experience | exptobottles.use |
Everyone (true) |
/bottle <xp> |
Bottles a specific number of points (e.g. /bottle 500) |
exptobottles.use |
Everyone (true) |
/bottle <level>l |
Bottles a specific number of levels (e.g. /bottle 5l) |
exptobottles.use |
Everyone (true) |
/bottle until <level> |
Bottles down until you reach target level (e.g. /bottle until 30) |
exptobottles.use |
Everyone (true) |
/bottle vacuum |
Toggles the fast XP vacuum on or off | exptobottles.use |
Everyone (true) |
/bottle spawn <xp> |
Spawns XP orbs at current location (Admin/Testing) | exptobottles.admin |
Admin (op) |
/bottle reload |
Reloads config.yml |
exptobottles.admin |
Admin (op) |
⚙️ Configuration (config.yml)
Easily configure vacuum radius, sound volume, bottle return, optional bottling tax fees, and message formatting in plugins/ExpToBottles/config.yml.
📦 Installation
- Download
ExpToBottles-1.0.0.jar. - Place the
.jarinside your server'splugins/folder. - Restart your server or run
/reload confirm.
Platforms
Paper
1.8–1.21