XpBottle

✨ Features

• 🧪 XP Bottle Creation — Convert your XP into storable bottles via /xpbottle <amount>
• 🖱️ Easy Redemption — Right-click a bottle to instantly absorb its XP
• ⏳ Cooldown System — Configurable cooldown to prevent spam
• 🔐 Protected Bottles — Bottles are returned to the player on death instead of dropping
• 🎨 Customizable Bottles — Full control over material, name, lore, glow and hex colors
• 🔊 Sound Effects — Configurable sounds on withdraw and redeem
• 🗄️ Database Support — H2 (embedded) or MySQL via HikariCP
• 🔧 ItemsAdder Integration — Optional support for custom items
• 👑 Admin Commands — Give bottles to players and reload config
• 🌍 Configurable Messages — Full lang.yml with hex color & MiniMessage support

📋 Commands

| Command | Description | Permission |
|---|---|---|
| /xpbottle <amount> | Withdraw XP into a bottle | xpbottle.use |
| /xpbottle give <player> <amount> | Give XP bottle(s) to a player | xpbottle.give |
| /xpbottle reload | Reload the plugin configuration | xpbottle.reload |
| /xpbottle help | Display the help message | — |
| /xp | View your current level and total XP | xp.view |

🔒 Permissions

| Permission | Description | Default |
|---|---|---|
| xpbottle.use | Use /xpbottle to withdraw XP | true |
| xpbottle.give | Give bottles to other players | op |
| xpbottle.reload | Reload the configuration | op |
| xp.view | Use /xp to view level and XP | true |

🔖 Placeholders

| Placeholder | Description |
|---|---|
| %exp% | Amount of XP stored in the bottle |
| %signer% | Name of the player who created the bottle |
| %amount% | Number of bottles |
| %time% | Remaining cooldown time in seconds |
| %player% | Target player name |
| %level% | Player's current level |
| %xp% | Player's total XP |

⚙️ Configuration

database:
  type: h2        # h2 or mysql

xpbottle:
  min-exp: 50
  max-exp: 1000000000
  conversion-rate: 0.1   # 10% tax on withdrawal
  cooldown: 10           # seconds
  drop: false            # drop bottle on ground instead of inventory
  protected-bottles: true

bottle:
  use-itemsadder: false
  material: EXPERIENCE_BOTTLE
  name: "#F2EC27&lʙᴏᴛᴛʟᴇ ᴅ'ᴇxᴘᴇʀɪᴇɴᴄᴇ"
  lore:
    - ""
    - "&7xᴘ : &f%exp%"
    - "&7ᴘʀᴏᴘʀɪᴇᴛᴀɪʀᴇ : &f%signer%"
    - ""
    - "#F2EC27ᴄʟɪᴄᴋ ᴅʀᴏɪᴛ &7| &7utiliser la bouteille"
  glow: false

sound:
  redeem:
    sound: "ENTITY_PLAYER_LEVELUP"
    enabled: true
  withdraw:
    sound: "ENTITY_COW_DEATH"
    enabled: false

🔗 Integrations

• ItemsAdder — Enable use-itemsadder: true to use a custom item instead of the vanilla bottle
• MySQL — Switch database.type to mysql and fill in your credentials for multi-server setups