> For the complete documentation index, see [llms.txt](https://docs.xandtech.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xandtech.fr/home/xplayerexp/readme.md).

# Introduction

XPlayerEXP is a Spigot/Paper plugin that turns player experience into a physical, tradeable item: right-click to bottle up XP (as raw points or whole levels), right-click a bottle to drink it back. On top of that: timed **Double XP** events with a live boss bar, permission-driven limits and taxes, per-player creation **cooldowns**, and **world/WorldGuard region restrictions** — all fully configurable, and every command keyword renameable to fit your server.

## What's in here

* [**XP Bottles**](https://docs.xandtech.fr/home/xplayerexp/features/bottles.md) — create and consume bottles in `POINTS` or `LEVELS` mode, fully custom item (material, name, lore), and admin/console vouchers via `/bottlexp give`.
* [**Double XP Events**](https://docs.xandtech.fr/home/xplayerexp/features/double-xp.md) — `/bottlexp doublexp start <multiplier> <duration>` with a live, auto-updating boss bar countdown, and permission-based bonus multipliers that stack on top of it.
* [**Custom Commands**](https://docs.xandtech.fr/home/xplayerexp/features/custom-commands.md) — the main command, its aliases, and every subcommand keyword (`create`, `give`, `reload`, `doublexp`, even `start`/`end`) are renameable via config, with tab-completion following along.
* [**Cooldowns & Restrictions**](https://docs.xandtech.fr/home/xplayerexp/features/cooldowns-and-restrictions.md) — a per-player creation cooldown, plus optional blocking by world name or WorldGuard region — both with their own bypass permission.
* [**Integrations**](https://docs.xandtech.fr/home/xplayerexp/features/integrations.md) — PlaceholderAPI, public bStats metrics, and full `&#RRGGBB` hex color support everywhere text is shown.
* [**Languages & Update Checker**](https://docs.xandtech.fr/home/xplayerexp/features/languages-and-updates.md) — 9 bundled languages, plus a background GitHub release checker that notifies permitted players in-game.

## Requirements

* Spigot or Paper `1.21.x` or newer — API version `1.21`.
* Java 21+.

Everything else is optional:

| Plugin                                                                    | Needed for                                |
| ------------------------------------------------------------------------- | ----------------------------------------- |
| [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) | The `%xplayerexp_*%` placeholders         |
| [WorldGuard](https://enginehub.org/worldguard)                            | Region-based bottle creation restrictions |

None of these are required to run XPlayerEXP — each integration only activates if the corresponding plugin is actually installed.

## Where to start

New to XPlayerEXP? Read [Installation & Setup](https://docs.xandtech.fr/home/xplayerexp/getting-started/getting-started.md) first. From there:

* Setting up the core item? Start with [XP Bottles](https://docs.xandtech.fr/home/xplayerexp/features/bottles.md).
* Want a timed boost? See [Double XP Events](https://docs.xandtech.fr/home/xplayerexp/features/double-xp.md).
* Renaming commands for your server's language/style? See [Custom Commands](https://docs.xandtech.fr/home/xplayerexp/features/custom-commands.md).
* Locking bottles to specific areas or limiting how often players can make them? See [Cooldowns & Restrictions](https://docs.xandtech.fr/home/xplayerexp/features/cooldowns-and-restrictions.md).
* Hooking up PlaceholderAPI or checking what data is sent to bStats? See [Integrations](https://docs.xandtech.fr/home/xplayerexp/features/integrations.md).
