XpGet

A plugin that allows you to convert your experience into experience bottles when you have empty glass bottles. Supports both fixed amounts and automatic maximum calculation. Features a GUI interface for more convenient conversion.

🧩 Version Compatibility

Plugin version	Supported Paper	Java
2.2.0+	1.20.4 – 26.3	25
2.1.0	1.20 – 26.3	25
2.0.1	1.20 – 1.21.11	21

📸 Screenshots

!Menu

⚙️ Command

Command	Description
/xpget	Open GUI menu for experience conversion
/xpget [amount | max]	Converts the specified amount of experience or the maximum possible
/xpget reload	Reloads the configuration

Examples:

• /xpget 10 — create 10 experience bottles (if enough experience and bottles)
• /xpget max — create the maximum possible number of bottles

🧾 Permissions

Permission	Default	Description
xpget.use	✅ true	Allows usage of the /xpget command
xpget.reload	op	Allows usage of the /xpget reload command

⚙️ Configuration

# XPGet Configuration
# How many experience points are required to create one experience bottle.
# The value is specified in experience points, not levels.
exp-per-bottle: 7

gui:
  size: 27
  title: "<gold>Experience Conversion</gold>"

  divider:
    enabled: true
    material: "GRAY_STAINED_GLASS_PANE"
    name: "<gray>"

  close:
    slot: 22
    material: "BARRIER"
    name: "<red>Close"
    actions:
      - "[close]"

  # Available actions for GUI items:
  # [close]         - Close the inventory.
  # [cmd] <command> - Execute a command as the player.
  #
  # Available placeholders for conversion items:
  # {level}          - The player's current level.
  # {level_after}    - The player's level after conversion.
  # {levels}         - The difference between the current level and the level after conversion.
  # {level_required} - The level corresponding to the specified amount of experience points,
  #                    assuming the player starts with zero experience.
  # {exp}            - The total number of experience points required for conversion.
  # {current_exp}    - The player's current total experience points.
  # {max_bottles}    - The number of bottles selected for conversion.
  #
  # Important: experience points and levels are different quantities.
  # The number of levels lost depends on the player's current level
  # and their progress toward the next level.
  #
  # Example of a custom item:
  # main-menu:
  #   slot: 0
  #   material: "STONE"
  #   name: "<yellow>Main Menu"
  #   lore:
  #     - "<gray>Click to return to the main menu"
  #   actions:
  #     - "[close]"
  #     - "[cmd] menu"

items: one: slot: 11 material: "EXPERIENCE_BOTTLE" amount: 1 name: "1 Experience Bottle" lore: - "Quantity: 1 bottle" - "Cost: {exp} XP" - "You have: {current_exp} XP" - "After conversion: Lv. {level_after} <dark_gray>(-{levels})" - "" - "▶ Click to convert"

stack:
  slot: 13
  material: "EXPERIENCE_BOTTLE"
  amount: 64
  name: "<yellow>64 Experience Bottles"
  lore:
    - "<gray>Quantity: <white>64 bottles"
    - "<gray>Cost: <white>{exp} XP"
    - "<gray>You have: <green>{current_exp} XP"
    - "<gray>After conversion: <yellow>Lv. {level_after} <dark_gray>(-{levels})"
    - ""
    - "<yellow>▶ Click to convert"

max:
  slot: 15
  material: "ENCHANTED_BOOK"
  amount: 1
  name: "<gold>Maximum"
  lore:
    - "<gray>Quantity: <white>{max_bottles} bottles"
    - "<gray>Cost: <white>{exp} XP"
    - "<gray>You have: <green>{current_exp} XP"
    - "<gray>After conversion: <yellow>Lv. {level_after} <dark_gray>(-{levels})"
    - ""
    - "<yellow>▶ Click to convert"

messages: player-only: "This command can only be used by players!" no-permission: "You don't have permission to use this command!"

usage: | Usage: /xpget [amount|max] Examples: /xpget 10 - convert experience into 10 bottles /xpget max - convert the maximum possible number of bottles Note: You can convert any number of bottles.

config-reloaded: "Configuration reloaded successfully!"

invalid-amount: "Invalid amount! Specify a positive number or 'max'."

not-enough-exp: "Not enough experience! Required: {level_required} levels of experience. Your current level: {level}." not-enough-empty: "Not enough empty bottles! Required: {needed}, you have: {current}." not-enough-space: "Not enough inventory space! You can fit {available} more bottles."

no-empty-bottles: "You don't have any empty bottles!" not-enough-exp-for-one: "You don't have enough experience for even one bottle!" not-enough-space-even: "Not enough inventory space to store experience bottles!"

success-specific: "Successfully created {amount} experience bottles!" success-max: "Successfully created {actual} experience bottles!"

## 📦 Installation

1. Download the **latest release**
2. Place it in the /plugins folder
3. Restart the server
4. Configure `config.yml` if needed and use `/xpget reload`
5. You're ready to use it: use `/xpget` in-game