Skip to content

Individual Parts & Lots

Track loose parts that exist outside of any set. E.g. spare parts from bulk purchases, parts salvaged from sets, or standalone inventory you want to manage separately.

Individual Parts

Accessing Individual Parts

Individual parts are accessible from the Parts entry in the main navigation. If the link is not visible, it may be hidden via the BK_HIDE_INDIVIDUAL_PARTS configuration option.

Adding Parts

Bulk add interface: Navigate to /add/parts and search for the parts by part number.

The interface supports three modes:

  • Single Mode: Add parts immediately one at a time. Each part is added to your inventory as a single part.
  • Bulk Mode: Add multiple individual parts. Parts are added to a cart and saved together as individual parts (no lot created).
  • Lot Mode: Create a part lot. Parts are added to a cart and saved together as a lot.

Quick-add from set inventory: On any set's parts table, click the row menu (⋮) next to a part and select Add to individual parts. This pre-fills the part number and color. This option can be hidden with BK_HIDE_QUICK_ADD_INDIVIDUAL_PARTS=true.

Problem Tracking

For each individual part you can track:

  • Missing: how many are missing
  • Damaged: how many are damaged
  • Checked: tick off parts during an audit

Changes save automatically.

Metadata

Individual parts and lots support the same metadata as sets.

Part Lots

Part lots let you group related individual parts together. For example, all parts from a bulk purchase, or parts destined for a specific project. This is also a way to add an MOC inventory.

Managing a Lot

Parts can be added to a lot directly from the bulk add interface. A lot shares storage and purchase metadata across all its parts.

View all parts in a lot by navigating to the lot detail page, where you can filter and sort the contents.

WARNING

It is currently not possible to add parts to a lot after it has been created.

Feature Flags

VariableEffect
BK_HIDE_INDIVIDUAL_PARTSHides the navbar menu item, "Add Parts" button, and links from part detail pages. Routes remain accessible by direct URL.
BK_DISABLE_INDIVIDUAL_PARTSEnables read-only mode. All pages are accessible but editing fields are disabled, delete buttons are hidden, the "Add Parts" menu item is removed, and all write operations are blocked.
BK_HIDE_QUICK_ADD_INDIVIDUAL_PARTSHides the "Add to individual parts" option in set parts row menus only. Does not affect the main individual parts feature.

All three can be set via Admin -> Live Settings without a container restart.

Released under the MIT License.