start here

Installation & setup

What the asset needs from your project, and the two one-time steps a clean project requires before the demo scenes render correctly.

Requirements

Requirement	Description
Unity	2022.3 LTS or newer, including all Unity 6 (6000.x) releases. Both are covered by the automated test pass before every release.
Render pipeline	URP is required for the included demo scenes only. The inventory itself is uGUI (Canvas + RectTransform) and runs identically under Built-in, URP, and HDRP.
TextMeshPro	Used by all text in the UI. Install via Package Manager; import the TMP Essential Resources once per project.
Input System	The new Input System package powers hotbar digit keys and dialog shortcuts. A legacy Input Manager fallback exists for core drag interactions.

Import the asset

Download and import from the Package Manager (Window▸Package Manager▸My Assets) or double-click the .unitypackage if you bought directly. Import everything — the asset is self-contained under a single folder:

Folder layout

text

Assets/NullBolt/InventorySystem/
├── Documentation/    README, CHANGELOG, TESTING, LICENSE
├── Editor/           Item Creator, Item Browser, Create-menu generators, scene builders
├── Examples/         Demo scenes
├── Prefabs/          Slot, Item, StackSplitDialog prefabs
├── Resources/        Sample ItemData assets + icons (fantasy + Tactical sets)
└── Scripts/
    ├── Core/         Runtime code (data, controllers, UI, save system)
    └── Demo/         Demo managers + sample IEconomy implementation

// note

All runtime code lives in the InventorySystem C# namespace — flat, not NullBolt.InventorySystem. Every script in this documentation starts with using InventorySystem;.

First-time setup on a clean project

Two one-time steps, both driven by Unity itself rather than the asset:

1. Install URP (demo scenes only) — Window▸Package Manager▸Unity Registry▸Universal RP▸Install, then assign a URP Asset under Edit▸Project Settings▸Graphics and Edit▸Project Settings▸Quality. Without it, the demo scenes' Camera and Directional Light show Missing (Mono Script) entries for their URP data components.

2. Import TMP Essential Resources — Window▸TextMeshPro▸Import TMP Essential Resources. Required once per project before any TextMeshPro component renders; skipping it produces UnassignedReferenceException: The variable material of TMP_FontAsset…

// tip

Integrating into a Built-in or HDRP project? Skip step 1. The runtime inventory UI has no pipeline dependency — only the demo scenes ship URP-flavoured camera and light data, and you can delete or replace those objects freely.

Verify the install

Open Assets/NullBolt/InventorySystem/Examples/Single-Inventory-Scene.unity and press Play. You should see a grid inventory stocked with sample items — drag them around, right-click a sword to rotate it, hover anything for a tooltip. Press H for the full controls list. If that works, everything is installed correctly.