> 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**](/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**](/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**](/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**](/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**](/home/xplayerexp/features/integrations.md) — PlaceholderAPI, public bStats metrics, and full `&#RRGGBB` hex color support everywhere text is shown.
* [**Languages & Update Checker**](/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](/home/xplayerexp/getting-started/getting-started.md) first. From there:

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xandtech.fr/home/xplayerexp/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.