Skip to main content

Fix a Shopkeepers trade blocked by a full payment chest

Applies to: Shopkeepers; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

A player shop needs space to receive payment as well as stock to sell. A chest full of sale items can prevent a valid trade even when the customer holds the correct currency.

Before you start

Shopkeepers player trades exchange physical items held in a linked container. A Vault balance is not the stock for these trades. Work with the shop owner and keep the container, shop record and item metadata together when investigating a failure.

Work through the check

  1. Ask the owner to open the linked container and record which slots hold sale stock and which can accept the configured payment item.
  2. Inspect the exact trade costs in the editor, including quantities and any custom currency item metadata.
  3. As a normal customer, try one inexpensive trade while the owner watches the stock container, then note whether either side changes.
  4. Move a small amount of the owner’s stock to a safe labeled container to leave payment space and repeat the same trade without changing its price.

Confirm the result

The trade should complete once enough matching stock and sufficient payment space are available. The customer receives the advertised item and the linked container receives the exact currency items.

If the result differs

A free slot may still be insufficient for a large payment or an unstackable custom currency. If space is adequate, compare the payment item’s metadata and the offered quantity with the recipe.

Recover safely

Return the temporarily moved stock after arranging permanent payment capacity. Do not replace the entire chest or delete the shop, because that can separate ownership and stock from the existing trade record.

Documentation and related help

Check the Shopkeepers maintainer documentation and Shopkeepers maintainer reference against your installed release before applying changes.