Getting Started Troubleshooting

Export

Trace a missing or incorrect Item through UIS in data order: Database, Inventory System Manager, Definition, Inventory, Item Collection, then UI. Stop at the first layer where the expected value disappears.

1. Database

Open Main Manager and confirm the intended Inventory System Database is selected. Locate the category and definition by exact name and verify their relationship, attributes, and unique IDs.

If the editor shows the wrong catalog, do not repair scene or UI references yet. Select the intended database first.

2. Inventory System Manager

Select the scene’s Inventory System Manager and confirm that Database matches Main Manager. Keep exactly one active manager for the world. Enter Play Mode and resolve database-null, duplicate-name, or duplicate-ID errors before continuing.

3. Runtime Item and Inventory

Select the player Inventory. Confirm that Inventory Identifier uses the intended stable ID, the expected Item exists at runtime, and the collection name and Purpose are correct.

The Inventory Inspector shows Item Collections and the selected Item data used for runtime diagnosis.

4. Collection and restrictions

Inspect the destination collection, its type, Item Slot Set when applicable, restrictions, overflow behavior, and exact collection name. Ask CanAddItem conceptually before assuming the UI or Item Action removed the Item.

5. UI binding

If the Item exists in Inventory but not UI, inspect:

  • player Inventory or Dynamic Panel Owner binding;
  • collection filter;
  • Item View Drawer Content;
  • Category Item View Set mapping;
  • generated slot count and navigation; and
  • the selected database of every referenced category or asset.

The Inventory Grid Inspector exposes the Inventory and Item View Drawer that connect the runtime data to slots.

Symptom guide

Symptom Check Fix
Main Manager or UI Designer is missing. Package import and compiler errors. Restore one matching UIS/Shared package and resolve the first error.
Definition is absent from a picker. Main Manager database and category assignment. Create/select the definition in the active database.
Database works in editor but not Play Mode. Inventory System Manager Database and startup errors. Assign the same database and keep one manager.
Starting Item is missing. Collection’s authored Item Amounts and initialization. Add the Item to the intended collection and retest.
Item enters the wrong collection. Main Purpose, collection order, transaction routing, and restrictions. Give the intended collection the correct Purpose and rule.
Item cannot equip. Item Slot Set category, Equipment collection, Item Action, and destination restriction. Fix the first category/slot mismatch.
Grid is empty. Runtime Inventory contents, Inventory binding, and collection filter. Prove the Item in Inventory, then bind/filter that collection.
Slots appear without icons. Item View Drawer, Content, Category Item View Set, and Icon. Repair the view mapping and definition data.
Item Action list is empty. Item Categories, Category Item Action Set, and binding. Add the matching category mapping and connect it to the selected grid.
Item disappears after scene change. Player/manager lifetime and save ownership. Persist the owner together or restore it through the Save System.
Saved mutable values reset. Stable IDs, Inventory saver, manager item saver, and load order. Save the complete owner chain and load after manager initialization.

Isolate safely

Use one Health Potion, one Bag, one player, and one grid. Remove filters, sorters, Item Actions, equipment, saving, and integrations from the reproduction. Restore one layer at a time after the smallest data path works.