> 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/permissions.md). # Permissions | Permission | Default | Description | | --------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `xplayercurrencies.admin` | `op` | Every admin action nested under `/currencies admin ` - give/take/set/reset a balance, reloading the plugin, the currency-catalog `gui` menu, `view ` to inspect/edit any player's balances, `logs ` for their transaction history, `migrate`/`export`/`import`, `bank give/take/set/reset/tier/interest`, `sellstick give/containers`, `portablebank give`, `booster event/stop/give/list`, `boosterpotion give`, `blackmarket refresh`, `fraud freeze/unfreeze/status`, and (if Citizens is installed) `npc bind/unbind/list`. | | `xplayercurrencies.balance.self` | `true` | Checking your own balance (`/currencies`, `/currencies view`, a currency's own scoped command) and viewing a currency's leaderboard. | | `xplayercurrencies.list` | `true` | Listing every configured currency via `/currencies list`. | | `xplayercurrencies.pay` | `true` | Sending currency to another player via `/currencies pay` (currencies with `allow-pay` enabled). | | `xplayercurrencies.leaderboard.bypass` | `op` | Hides you from every currency's leaderboard regardless of balance - only reliably applied while online when the leaderboard is generated. | | `xplayercurrencies.cheque.create` | `true` | Converting your own balance into a physical cheque item, for currencies with `cheque.enabled` on. | | `xplayercurrencies.cheque.use` | `true` | Redeeming a cheque item by right-clicking it. | | `xplayercurrencies.exchange` | `true` | Converting part of your balance from one currency into another. | | `xplayercurrencies.shop` | `true` | Opening a currency's shop menu(s) to buy/sell items. | | `xplayercurrencies.bank` | `true` | Opening a currency's bank menu to deposit/withdraw and upgrade tiers. | | `xplayercurrencies.sellall` | `true` | Selling every matching item at once via `/currencies sellall`, and using a sell stick. | | `xplayercurrencies.deathpenalty.bypass` | `op` | Exempts you from every currency's death penalty (wallet only, never bank). | | `xplayercurrencies.portablebank.use` | `true` | Right-clicking the portable bank item to open the bank menu - required **on top of** `xplayercurrencies.bank`. | | `xplayercurrencies.blackmarket` | `true` | Opening a currency's black market menu. | | `xplayercurrencies.admin.fraud.alerts` | `op` | Receives the live in-game chat alert whenever [fraud detection](/home/xplayercurrencies/features/fraud-detection.md) flags or blocks a suspicious gain - independent of `xplayercurrencies.admin`, so it can be granted to trusted non-admin staff without giving them every other admin action too. Every alert is always logged to console regardless of who holds this. | ## Per-feature extras These aren't declared in `plugin.yml` (no fixed `default`) since they're referenced from example config values, meant to be created in your permissions plugin and attached to whichever tier/rank/item you want: | Permission (example) | Used by | | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `xplayercurrencies.bank.silver` | An example bank tier's `required-permission` (`currencies/coins.yml`). | | `xplayercurrencies.sellstick.golden` | An example sell stick's `permission` (`currencies/coins.yml`). | | `xplayercurrencies.booster.vip` / `xplayercurrencies.booster.mvp` | Example [permanent permission boosters](/home/xplayercurrencies/features/boosters.md#permanent-permission-boosters) (`currencies/coins.yml`). | A [sell stick](/home/xplayercurrencies/features/sell-sticks-and-sellall.md), [booster potion](/home/xplayercurrencies/features/boosters.md), [bank tier](/home/xplayercurrencies/features/bank.md), or [black market pool item](/home/xplayercurrencies/features/black-market.md) can each optionally require their own permission string, of your choosing, set directly in their config entry. Next: [Commands](/home/xplayercurrencies/reference/commands.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/permissions.md?ask=&goal= ``` `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.