XpBottle

!(https://cdn.modrinth.com/data/cached_images/014265fc3bd1e10bf495f73b494c36d8da60968a.png)

!(https://img.shields.io/badge/Version-1. 0. 0-blue) !(https://img.shields.io/badge/Paper-1. 21%2B-brightgreen) !(https://img.shields.io/badge/Java-21-orange) [!(https://img.shields.io/discord/1463533838704578645?logo=discord&label=Discord&color=5865F2)](https://discord.com/invite/ydn5S7FC7q)

## ✨ Features

• 🧪 XP Bottle Creation — Convert your XP into storable bottles via `/xpbottle `
• 🖱️ 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

!(https://cdn.modrinth.com/data/cached_images/b859d1899f664c87d8b1b3ff5788ac860fe88991.png)

## 📋 Commands

| Command | Description | Permission | |---|---|---| | `/xpbottle ` | Withdraw XP into a bottle | `xpbottle.use` | | `/xpbottle give ` | 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` |

!(https://cdn.modrinth.com/data/cached_images/a4765db5deedcf5dc9e931f643ce24e1a82da7d2.png)

## 🔒 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` |

!(https://cdn.modrinth.com/data/cached_images/3d5b07dd223181721b1e81148368bf5c2d2f7fcf.png)

## 🔖 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 |

!(https://cdn.modrinth.com/data/cached_images/6f0ae08a31af81e49c49b69ed5194bfa056a6f5c.png)

## ⚙️ Configuration

```yaml 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 ```

!(https://cdn.modrinth.com/data/cached_images/78c1c871dcfb13f4e637ac31baed0041d5687e48.png)

## 🔗 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