> 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/xplayercurrencies/features/boosters.md).

# Boosters

Temporary or permanent earnings/spending boosts, in four flavors: drinkable potions, permanent permission-based perks, and admin-granted global events or per-player grants. Every boost has a **scope** - `BUY` (discount on shop purchase prices), `SELL` (bonus on shop/sellall/sell-stick sale prices), `KILL` (bonus on kill coins), or `ALL` (all three at once) - and a positive **percent**. Multiple active boosts stack additively.

## Booster potions

Drinkable items (right-click to consume, standard vanilla potion mechanic) that grant the drinker a temporary boost:

```yaml
booster-potions:
  - id: sell_boost
    material: POTION
    name: "&d&lSelling Frenzy"
    lore:
      - "&7Drink to boost your {currency}"
      - "&7selling price by &a+{percent}%"
      - "&7for &f{duration} &7minute(s)."
    scope: SELL
    percent: 25
    duration-minutes: 15
    permission: ""
```

`id` is only used to look the entry back up when drunk - editing it here updates every already-handed-out copy immediately. It's just a physical item, so it can also be sold in a shop by sampling it into a `ShopItem`'s give-item slot in the shop editor.

```
/currencies admin boosterpotion give <player> <currency> <potionId> [amount]
```

## Permanent permission boosters

A permanent boost for whoever holds a permission (granted through your permissions plugin, e.g. LuckPerms - not an in-game command), re-checked **live** on every price/reward calculation: granting or revoking the permission takes effect immediately, nothing to reload.

```yaml
permission-boosters:
  - permission: "xplayercurrencies.booster.vip"
    scope: SELL
    percent: 10
  - permission: "xplayercurrencies.booster.mvp"
    scope: ALL
    percent: 20
```

Typically used for a rank perk, e.g. "VIP always sells 10% higher".

## Admin-granted boosts (no item needed)

```
/currencies admin booster event <currency> <buy|sell|kill|all> <percent> <durationMinutes>
/currencies admin booster stop <currency> [buy|sell|kill|all]
/currencies admin booster give <player> <currency> <buy|sell|kill|all> <percent> <durationMinutes>
/currencies admin booster list
```

| Subcommand | Description                                                                                                                                                                          |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `event`    | Starts a server-wide temporary boost, announced to every online player.                                                                                                              |
| `stop`     | Ends the currently active global event(s) for that currency - optionally just one scope, leaving others untouched. Never affects per-player boosts or permanent permission boosters. |
| `give`     | Grants a temporary boost to one specific (online) player, silently (no server-wide announcement).                                                                                    |
| `list`     | Lists every currently-active **global** event, with remaining time.                                                                                                                  |

All require `xplayercurrencies.admin`.

## Live display

`config.yml`'s [`booster-display`](/home/xplayercurrencies/configuration/global-config.md#booster-display) shows every currently-active boost (global events + the viewer's own) on-screen with remaining time, in either actionbar or bossbar mode.

## Recalculated prices

Shop menus show both the base price and the boosted price live when a boost is active, so players always see exactly what they're paying/earning before confirming.

Next: [Black Market](/home/xplayercurrencies/features/black-market.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/xplayercurrencies/features/boosters.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.