> For the complete documentation index, see [llms.txt](https://pororoca-works.gitbook.io/s.b.i-simple-basic-interaction-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pororoca-works.gitbook.io/s.b.i-simple-basic-interaction-documentation/basic-inventory.md).
# Basic Inventory
### Basic Inventory System
**S.B.I.** includes a lightweight, map-based inventory system built for quick interaction setup and small-scale item logic. It’s simple enough for fast prototyping, but modular enough to be expanded.
***
#### 🧍 Player Inventory
The player’s inventory is stored as a **Map** inside the `AC_PlayerInteractions` component:
Each entry tracks the quantity of a specific item the player is carrying.
***
#### 🗄️ Container Inventory
Actors like drawers or crates use the `AC_Stash` component to manage their contents.
Inside any `BP_MasterTarget` actor, you’ll find the **Stash** category with these setup options:
| Variable | Type | Description |
| ------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `HasStash` | `Boolean` | If **true**, the actor will automatically create and attach an `AC_Stash` component at runtime. If **false**, no component is added — keeping performance clean and avoiding unnecessary components. |
| `Stash` | `Map` | Predefined contents of the container |
| `WeightLimit` | `Float` | Max capacity of the stash (in weight units) |
On `Begin Play`, the stash is initialized using these values.\
This logic is handled through the `StashCheck` function inside the blueprint.
***
#### 🧱 Creating New Items
To define new items:
1. Add a new entry to the `EN_Item` enum.
2. Add a corresponding row to the `DT_ItemList` data table.
By default, each item includes:
* `Name` (display name)
* `Weight` (used for inventory weight checks)
You can expand the system by adding more columns or attributes as needed.
***
#### ➕ Item Pickup
Loose items (e.g. GasCan, Access Card, Small Battery) are `BP_MasterTarget` actors that automatically trigger the `Add Item` interface when interacted with. If successful, they’ll be added to the player’s inventory and removed from the world.
***
#### 🔁 Item Transfer & Weight Handling
Inventory weight checks are handled globally using functions inside the `BPL_InteractionLibrary`.
These are used when:
* Picking up items from the world
* Transferring items between player and containers
They ensure the receiving inventory has enough free capacity before completing the transfer.
***
#### 🧩 Integration with Other Inventory Systems
The built-in system is meant to be a simple default — you’re free to replace or extend it to suit your needs.
To integrate with your own custom inventory system:
* Modify the `BP_MasterControl` or `BP_MasterTarget` blueprints as needed
* You can either **bypass item requirements** entirely or rewire the validation logic to call your own inventory queries
***
> 🛠️ This system is intentionally simple and flexible. It’s a great starting point for prototypes and modular expansion into more advanced inventory mechanics.
