Skip to main content

Avoid title collisions in a Shopkeepers book shop

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

Book shops copy an owner’s written books using the documented book-shop rules. Reusing titles can make stock identity confusing, so establish a small controlled catalogue before opening a large library.

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. Read the book-shop section for your installed release and record the written book’s title, author and generation before using it as a sample.
  2. Give each intended catalogue entry a distinct title and keep an untouched original outside the shop container.
  3. Stock the linked container with the required copying materials described by the maintainer, then offer a low-value test copy to a normal customer.
  4. Inspect the purchased book’s pages, title and generation and compare the container changes with the expected copy process.

Confirm the result

The customer should receive the intended readable book while the shop retains the correct catalogue entry and consumes the documented materials. Another book should not be substituted because its title collides.

If the result differs

Copy-generation restrictions or unsuitable stock can block a trade even when a book looks correct in the preview. Check those details before changing permissions or rewriting every catalogue entry.

Recover safely

Remove the affected offer through the editor until its identity is clear, preserving the original books and container contents. Rebuild only that catalogue entry from the untouched original when repeating the test.

Documentation and related help

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