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

# Commands

The main command name (`/currencies` by default) is configurable - see [Global Configuration](/home/xplayercurrencies/configuration/global-config.md#language--commands). It also has the `/currency` and `/xpc` aliases out of the box. Every currency can additionally register its own scoped command (e.g. `/coins`) - see [Currency Basics](/home/xplayercurrencies/configuration/currency-basics.md#commands)

* which works exactly like its `/currencies ... <id> ...` equivalent, just without repeating the currency id.

Required permissions are noted per command - see the full [Permissions](/home/xplayercurrencies/reference/permissions.md) table for defaults.

## Player commands

| Command                                        | Description                                                                                                                       | Permission                                                                         |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `/currencies`                                  | Your own balance for every enabled currency.                                                                                      | `xplayercurrencies.balance.self`                                                   |
| `/currencies list`                             | Lists every configured currency.                                                                                                  | `xplayercurrencies.list`                                                           |
| `/currencies view [player]`                    | With no argument, your own read-only balance overview (menu). With a player, opens the **admin** balance editor for them instead. | `xplayercurrencies.balance.self` (self) / `xplayercurrencies.admin` (other player) |
| `/currencies top <currency>`                   | Opens that currency's leaderboard.                                                                                                | `xplayercurrencies.balance.self`                                                   |
| `/currencies pay <currency> <player> <amount>` | Sends currency to another player.                                                                                                 | `xplayercurrencies.pay`                                                            |
| `/currencies cheque <currency> <amount>`       | Creates a physical cheque item worth `<amount>`.                                                                                  | `xplayercurrencies.cheque.create`                                                  |
| `/currencies exchange [<from> <to> <amount>]`  | Converts a balance between currencies; with no arguments, opens the exchange menu.                                                | `xplayercurrencies.exchange`                                                       |
| `/currencies shop <currency> [shopId]`         | Opens a shop.                                                                                                                     | `xplayercurrencies.shop`                                                           |
| `/currencies sellall <currency> [shop]`        | Sells every matching item in your inventory at once.                                                                              | `xplayercurrencies.sellall`                                                        |
| `/currencies bank [currency]`                  | Opens the bank menu (auto-picks if only one is enabled).                                                                          | `xplayercurrencies.bank`                                                           |
| `/currencies killcoins`                        | Toggles the kill-coins/interest actionbar notification.                                                                           | none (must be a player)                                                            |
| `/currencies blackmarket <currency>`           | Opens the current black market rotation.                                                                                          | `xplayercurrencies.blackmarket`                                                    |

See [Bank](/home/xplayercurrencies/features/bank.md), [Shop](/home/xplayercurrencies/features/shop.md), [Sell Sticks & /sellall](/home/xplayercurrencies/features/sell-sticks-and-sellall.md), [Cheques & Exchange](/home/xplayercurrencies/features/cheques-and-exchange.md), [Kill Coins](/home/xplayercurrencies/features/kill-coins.md), [Black Market](/home/xplayercurrencies/features/black-market.md) and [Leaderboard](/home/xplayercurrencies/features/leaderboard.md) for what each of these actually does.

## Admin commands

Everything below is nested under `/currencies admin <action> ...` and requires `xplayercurrencies.admin` (default: `op`).

### Core

| Command                                                          | Description                                                            |
| ---------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `/currencies admin reload`                                       | Reloads config, language and currency files.                           |
| `/currencies admin gui`                                          | Opens the currency catalog admin menu (create/edit/delete currencies). |
| `/currencies admin view <player>`                                | Opens the balance editor for that player.                              |
| `/currencies admin balance <currency> <player>`                  | Shows one balance in chat.                                             |
| `/currencies admin give\|take\|set <currency> <player> <amount>` | Modifies a balance directly.                                           |
| `/currencies admin reset <currency> <player>`                    | Resets a balance to its default.                                       |
| `/currencies admin logs <player>`                                | Opens the transaction history menu for a player.                       |

### Bank

| Command                                                               | Description                                               |
| --------------------------------------------------------------------- | --------------------------------------------------------- |
| `/currencies admin bank give\|take\|set <currency> <player> <amount>` | Modifies a bank balance directly (bypasses the tier cap). |
| `/currencies admin bank reset <currency> <player>`                    | Resets a bank balance to 0.                               |
| `/currencies admin bank tier <currency> <player> <tier>`              | Force-sets a bank tier level.                             |
| `/currencies admin bank interest [currency]`                          | Force-pays interest immediately.                          |

### Shop

| Command                                 | Description            |
| --------------------------------------- | ---------------------- |
| `/currencies admin editshop <currency>` | Opens the shop editor. |

### Sell sticks

| Command                                                                   | Description                           |
| ------------------------------------------------------------------------- | ------------------------------------- |
| `/currencies admin sellstick give <player> <currency> <stickId> [amount]` | Hands out a sell stick.               |
| `/currencies admin sellstick containers`                                  | Lists the configured container types. |

### NPC (Citizens)

| Command                                          | Description                                                                               |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| `/currencies admin npc bind <currency> <shopId>` | Binds the NPC you're looking at (or standing near, per the Citizens selection) to a shop. |
| `/currencies admin npc unbind`                   | Removes a binding.                                                                        |
| `/currencies admin npc list`                     | Lists every current binding.                                                              |

Only meaningful with [Citizens](/home/xplayercurrencies/integrations/citizens.md) installed.

### Portable bank

| Command                                                 | Description                       |
| ------------------------------------------------------- | --------------------------------- |
| `/currencies admin portablebank give <player> [amount]` | Hands out the portable bank item. |

### Boosters

| Command                                                                                                 | Description                                |
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| `/currencies admin booster event <currency> <buy\|sell\|kill\|all> <percent> <durationMinutes>`         | Starts a server-wide temporary boost.      |
| `/currencies admin booster stop <currency> [buy\|sell\|kill\|all]`                                      | Ends the currently active global event(s). |
| `/currencies admin booster give <player> <currency> <buy\|sell\|kill\|all> <percent> <durationMinutes>` | Grants a boost to one player.              |
| `/currencies admin booster list`                                                                        | Lists active global events.                |
| `/currencies admin boosterpotion give <player> <currency> <potionId> [amount]`                          | Hands out a drinkable booster potion.      |

See [Boosters](/home/xplayercurrencies/features/boosters.md).

### Black market

| Command                                            | Description                      |
| -------------------------------------------------- | -------------------------------- |
| `/currencies admin blackmarket refresh <currency>` | Forces a new rotation right now. |

### Fraud detection

| Command                                                        | Description                                |
| -------------------------------------------------------------- | ------------------------------------------ |
| `/currencies admin fraud freeze <player> <currency> [seconds]` | Blocks a player's income for one currency. |
| `/currencies admin fraud unfreeze <player> <currency>`         | Lifts a freeze early.                      |
| `/currencies admin fraud status <player> <currency>`           | Shows whether/how-long a player is frozen. |

See [Fraud Detection](/home/xplayercurrencies/features/fraud-detection.md).

### Data

| Command                                                | Description                                                                                                                                                                             |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/currencies admin migrate vault <currency> [confirm]` | Imports balances from whatever plugin currently backs Vault's economy. Preview first, then re-run with `confirm`.                                                                       |
| `/currencies admin export <json\|csv\|yml> [currency]` | Dumps balances to a file.                                                                                                                                                               |
| `/currencies admin import <file> [add] [confirm]`      | Reads balances back from a file (same shape `export` produces). Preview first, then re-run with `confirm`. `add` adds to existing balances instead of overwriting (`set`, the default). |

Next: [Permissions](/home/xplayercurrencies/reference/permissions.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/reference/commands.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.