> 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/sell-sticks-and-sellall.md).

# Sell Sticks & /sellall

Two ways to sell many items at once against a currency's shop(s), instead of selling one item at a time in a shop menu.

## /sellall

```
/currencies sellall <currency> [shop]
```

Sells every matching item in the player's own inventory at once, against the given currency's shop(s) (or one specific shop id, if provided). Requires `xplayercurrencies.sellall` (default: `true`).

## Sell sticks

A physical item that sells an **entire container's** contents (chest, barrel, etc.) when right-clicked on it, instead of opening the container. Defined per currency in `currencies/<id>.yml` `sell-sticks`:

```yaml
sell-sticks:
  - id: basic
    material: STICK
    name: "&6Sell Stick"
    lore:
      - "&7Right-click a chest or barrel to"
      - "&7sell its ENTIRE sellable contents"
      - "&7for {currency}."
      - ""
      - "&7Boost: &a+{boost}%"
    boost-percent: 0
    shop: ""              # blank = every shop this currency has
    permission: ""        # blank = anyone with xplayercurrencies.sellall
    click-type: RIGHT
    max-uses: 0            # 0 = unlimited
  - id: golden
    material: BLAZE_ROD
    name: "&e&lGolden Sell Stick"
    boost-percent: 15
    permission: "xplayercurrencies.sellstick.golden"
    click-type: SHIFT_RIGHT
    max-uses: 20
```

| Key             | Description                                                                                                                                                                                                                            |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | Only used to look this entry back up at click time - editing name/boost/permission/shop/max-uses/click-type here updates every already-handed-out copy immediately, nothing needs reissuing.                                           |
| `boost-percent` | Extra bonus applied on top of the shop's normal sell prices for this stick specifically.                                                                                                                                               |
| `shop`          | Blank = every shop this currency has (that the player can see); set to one shop's id to restrict this stick to just that shop's prices.                                                                                                |
| `click-type`    | Which physical click triggers it: `RIGHT` (default), `SHIFT_RIGHT`, `LEFT`, or `SHIFT_LEFT`. Any other click on the container falls through to normal vanilla behavior (opening/breaking it).                                          |
| `max-uses`      | `0` (default) = unlimited, the stack stays a normal stack. Above `0`, every handed-out copy is unstackable and tracks its own remaining uses (shown via `{uses_left}`/`{max_uses}` lore placeholders), auto-deleted once it reaches 0. |

Which block types count as a "container" for this is set once globally, in [`config.yml`'s `sell-sticks.container-types`](/home/xplayercurrencies/configuration/global-config.md#sell-sticks---container-types) (chests/barrels by default).

### Handing sticks out

```
/currencies admin sellstick give <player> <currency> <stickId> [amount]
/currencies admin sellstick containers
```

Requires `xplayercurrencies.admin`. The second command lists the currently-configured container types in chat.

## Sell protection

Both bulk actions above respect [`config.yml`'s `sell-protection` blacklist](/home/xplayercurrencies/configuration/global-config.md#sell-protection) - neither ever sweeps away a protected material, even if a shop happens to buy it. A player's own deliberate single-item sell in a live shop menu is never affected.

Next: [Cheques & Exchange](/home/xplayercurrencies/features/cheques-and-exchange.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/sell-sticks-and-sellall.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.