> 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/reference/permissions.md).

# Permissions

{% hint style="warning" %}
None of these are declared in `plugin.yml` — every single one defaults to **server operators (`op`) only**, per vanilla Bukkit behavior for undeclared permission nodes. A permissions plugin (LuckPerms, PermissionsEx, ...) must grant them explicitly to non-op ranks; there's no built-in "everyone gets this by default" tier beyond `op`.
{% endhint %}

## Core

| Node                       | Controls                                               |
| -------------------------- | ------------------------------------------------------ |
| `xplayerexp.bottle.create` | `/bottlexp create` — converting XP into a bottle.      |
| `xplayerexp.bottle.use`    | Right-clicking a bottle to consume it.                 |
| `xplayerexp.admin.give`    | `/bottlexp give` — handing a bottle to another player. |
| `xplayerexp.admin.reload`  | `/bottlexp reload`.                                    |

The four nodes above are also each individually **remappable** to a different string via `config.yml`'s `permissions` section — see [Default Configuration Files](/home/xplayerexp/reference/configuration-files.md#config-yml) — in case you'd rather reuse permission names from another plugin's scheme.

## Bottle limits & tax tiers

| Node                                                   | Controls                                             |
| ------------------------------------------------------ | ---------------------------------------------------- |
| `xplayerexp.bottle.min.1`, `xplayerexp.bottle.min.2`   | Minimum bottle amount tiers (`min-exp-requirement`). |
| `xplayerexp.bottle.max.1`, `xplayerexp.bottle.max.2`   | Maximum bottle amount tiers (`max-exp-requirement`). |
| `xplayerexp.bottle.taxe.1`, `xplayerexp.bottle.taxe.2` | Tax percentage tiers (`tax`).                        |

These are the two **default** tiers shipped in `config.yml` — the list under each section is fully your own to add to, remove from, or rename the permission strings of. See [XP Bottles](/home/xplayerexp/features/bottles.md#minimum-maximum--tax).

## Cooldown & restrictions

| Node                                   | Controls                                                             |
| -------------------------------------- | -------------------------------------------------------------------- |
| `xplayerexp.bottle.cooldown.bypass`    | Exempts a player from the creation cooldown entirely.                |
| `xplayerexp.bottle.restriction.bypass` | Exempts a player from both world and WorldGuard region restrictions. |

See [Cooldowns & Restrictions](/home/xplayerexp/features/cooldowns-and-restrictions.md).

## Double XP

| Node                                                                  | Controls                                                                                   |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `xplayerexp.doublexp.start`                                           | Starting a Double XP event (in-game senders only — console is always allowed).             |
| `xplayerexp.doublexp.end`                                             | Ending one (same console exception).                                                       |
| `xplayerexp.bonus.1.5x`, `xplayerexp.bonus.2x`, `xplayerexp.bonus.3x` | The three default personal bonus-multiplier tiers (`bonus-permissions` in `doublexp.yml`). |

See [Double XP Events](/home/xplayerexp/features/double-xp.md).

## Admin

| Node                             | Controls                                                    |
| -------------------------------- | ----------------------------------------------------------- |
| `xplayerexp.admin.update-notify` | Receiving the in-game "a new version is available" message. |

## Common gotchas

* **Tiered permissions (min/max/tax/bonus) take the highest value among every node a player holds** — grant them as an additive stack per rank (a higher rank inherits the lower rank's node too), not as mutually exclusive choices, or a player with two conflicting tiers will silently get the more generous one, not a sum or an error.
* **`create`, `use`, `admin-reload` and `admin-give` are remappable strings in `config.yml`**, but everything else on this page (min/max/tax/cooldown/restriction/doublexp/bonus/update-notify nodes) is a fixed permission string used directly in code — renaming what a *command keyword* looks like (see [Custom Commands](/home/xplayerexp/features/custom-commands.md)) never changes which permission node gates it.


---

# 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/reference/permissions.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.