> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/better-storage/help/troubleshooting.md).

# Troubleshooting

Start with `/bs info`. It shows the version, which claim plugins Better Storage found, and whether a payment plugin is connected.

## The storage screen is empty, or misses some chests

* **It shows one chunk.** The chunk of the chest you opened it from, or the chunk you stand in for `/bs browse`. Chests a few blocks away can sit in the next chunk. Press **F3 + G** to see chunk borders.
* **Claims.** You only see chests you could open by hand. A chest in somebody else's claim stays hidden unless they trust you with their chests.
* **What counts.** Chests, trapped chests, barrels and copper chests. Placed shulker boxes only if `browser.include-shulkers` is on. Ender chests, hoppers and furnaces never.

## Sneaking and right-clicking a chest does nothing

* `interactions.sneak-open` may be off. `/bs browse` still works.
* You need an **empty hand**. Holding a block, you would place it against the chest, or, with an upgrade block, upgrade the chest.

## Every chest in a claim is hidden, even my own

A claim plugin is installed but Better Storage couldn't talk to it, usually right after a big update of that plugin. To stay safe it blocks those claims instead of leaving them open, and says so in the console at startup. Update Better Storage, or switch that plugin off under `protection` in `config.yml` and restart.

## The screen closes by itself

It closes when you walk out of the chunk or the chunks right next to it. On Folia it also closes when you cross into another region.

## Trash can or "Destroy blocked items" says no permission

Trash can and "Destroy blocked items" destroy items for good, so they are for operators only. Give `betterstorage.filter.void` to the players who should have them.

## An upgraded chest doesn't do anything

* **It needs materials and fuel inside it.** With `processing.source: self` (the default) an upgraded chest only uses what is in that chest.
* **Plain items only.** Named, enchanted or damaged items are skipped on purpose.
* **The Auto-Crafter needs to know what to make.** Sneak and right-click it with an empty hand and pick an item. With **Stop at a target** on, it stops once it made that many.
* **Busy server.** Upgraded chests take turns once there are more than `processing.max-operations-per-pass`. Raise it if machines feel slow.

## The resource pack look doesn't show

* `resource-pack.enabled` must be `true`, and the pack's `assets/betterstorage/` folder must be in the pack your server sends. See [The resource pack](/plugins/better-storage/getting-started/resource-pack.md).
* A player who declined the pack, or whose download failed, keeps the normal menus. That is on purpose.

## Missing pictures in the storage screen

The pack setting is on, but the player's pack doesn't have Better Storage's files, or has the files of an older version. Copy the current `assets/betterstorage/` folder from `BetterStorage-pack.zip` into your server's pack again, after removing the old one.

## The mouse wheel doesn't scroll

Point at the **scrollbar on the right** while turning the wheel. It does not scroll over the items themselves. If it never works for anyone, look in the console for a line saying mouse wheel scrolling is off. It appears the first time somebody opens the storage screen.
