> 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/xstash/chests-module/utility-bar.md).

# Utility Bar

A row of action buttons reserved at the top of every virtual chest once enabled. That row is never real storage — whatever a player had in it before the bar was turned on is just hidden, not lost, and reappears if the bar is later disabled.

`chests/config.yml`:

```yaml
utility-bar:
  enabled: true

  sort:
    enabled: true
    click: SHIFT_RIGHT
    permission: ""

  auto-smelt:
    enabled: true
    click: SHIFT_RIGHT
    permission: ""

  compact:
    enabled: true
    click: SHIFT_RIGHT
    permission: ""

  sell-all:
    enabled: true
    click: SHIFT_RIGHT
    permission: ""

  previous-chest:
    enabled: true
    click: LEFT
    permission: ""

  next-chest:
    enabled: true
    click: LEFT
    permission: ""

  back:
    enabled: true
    click: LEFT
    permission: ""
```

Every button needs the base `xstash.utility_bar` permission, plus its own `permission` if one is set. Button position (column 0-8) and appearance are configured separately in `chests/menus.yml`.

## Buttons

* **Sort** — sorts and stacks the chest's contents.
* **Auto-smelt** — smelts every smeltable, unmodified item stack, using the server's actual registered furnace recipes (so datapack-added recipes work too, not a hardcoded list).
* **Compact** — turns groups of 9 into their block form (e.g. iron ingots → iron blocks), also based on the server's real registered crafting recipes, with a small hardcoded fallback for common ore/ingot pairs in case a server has replaced those recipes.
* **Sell-all** — sells every plain stack with a price in `sell-prices.yml` (see [Economy & Selling](/home/xstash/reference/economy-and-selling.md)).
* **Previous-chest / next-chest** — jumps directly to the next **unlocked** chest in that direction, skipping over any locked chest number in between, without going back to the selector.
* **Back** — returns straight to the chest selector, on whichever page this chest itself is on.

{% hint style="info" %}
None of the destructive actions (sort, auto-smelt, compact, sell-all) ever touch renamed/enchanted/otherwise custom items — only plain, unmodified stacks.
{% endhint %}


---

# 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/xstash/chests-module/utility-bar.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.