Your First Inventory

Create one Health Potion definition, configure one Bag collection on a player, and verify the runtime Item without building equipment, shops, crafting, saving, or a custom UI.

Before you begin

• Complete Installing and Requirements.
• Create a project-owned folder for the database.
• Use a saved test scene.

Create the database

1. Open Tools > Opsive > Ultimate Inventory System > Main Manager.
2. Select Setup.
3. Under Inventory System Database, select New and save GameInventoryDatabase in the project folder created before opening the dialog.
4. Confirm that the new database remains selected.

The new database contains the broad All category with common Icon and Description definition attributes.

Create one category and definition

1. Open Item Categories and add Consumable below All.
2. Open Item Definitions and add Health Potion.
3. Assign Consumable as its category.
4. Set a clear Description and assign an Icon when an appropriate Sprite is available.

Do not add Attack, Durability, equipment, currency, or crafting data to this definition. The purpose of the first Item is to prove the catalog and Inventory connection.

Add the scene manager

1. Return to Main Manager > Setup.
2. Under Scene Setup, select Add Components.
3. Select the generated Game GameObject.
4. Confirm that Inventory System Manager > Database references GameInventoryDatabase.
5. Keep Pre Evaluate Attributes enabled.

Use one active Inventory System Manager for this scene. The manager registers definitions; it does not own the player’s Bag.

Add the player Inventory

1. Create an empty GameObject named Player.
2. In Main Manager > Setup > Character Setup, assign Player and select Add Components.
3. Confirm that Player has Inventory Identifier and Inventory. Keep the first stable Inventory Identifier ID at 1.
4. In Inventory > Item Collections, select the first collection that the Inspector created automatically.
5. Rename that existing Item Collection to Bag and retain its Main purpose. If you already added another collection, remove the unused empty default or ensure only Bag has Main purpose; adding another Main does not replace the first.
6. Under Bag’s starting Item Amounts, add one Health Potion with amount 1.

Editor checkpoint

Before Play Mode, confirm:

• Main Manager and Inventory System Manager reference GameInventoryDatabase;
• the database contains All, Consumable, and Health Potion;
• Health Potion uses Consumable;
• Player has Inventory Identifier ID 1 and Inventory;
• Bag is the only collection with Main purpose; and
• Bag starts with one Health Potion.

Verify in Play Mode

1. Enter Play Mode.
2. Select Player and inspect Inventory > Bag.
3. Confirm that Bag’s runtime Item Stacks contain one Health Potion.
4. Confirm that the runtime Item resolves the Health Potion definition, Consumable category, Description, and Icon value.
5. Stop Play Mode and confirm that the authored starting amount remains 1 rather than being replaced by the runtime list.

This is the first-success checkpoint: database registration created an Item from the definition and the player’s Main collection owns it.

Make one controlled change

Change the starting amount to 3 and test again. Bag should contain three Health Potion Items or one stack with amount three according to the collection’s stacking behavior. No UI is required to verify this data path.

Troubleshooting

Use Getting Started Troubleshooting when the first failed data layer is unclear.

Next step

Continue with First Inventory UI, then read The Data Model at a Glance before expanding the catalog.