Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for niktrick791

Bottle your Minecraft experience points into Bottles o' Enchanting with /bottle and full tax control.

Report NT-exptobottles?

R

1.0.0

🧪 ExpToBottles — Precision XP Bottling & High-Speed Farm Vacuum

Platform Minecraft License

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)!
  • 🔄 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

  1. Download ExpToBottles-1.0.0.jar.
  2. Place the .jar inside your server's plugins/ folder.
  3. Restart your server or run /reload confirm.

Information

Published
November 5, 2026
0Downloads

Platforms

Paper
Paper
1.8–1.21