> For the complete documentation index, see [llms.txt](https://visualonecompany.gitbook.io/storyframeworkdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://visualonecompany.gitbook.io/storyframeworkdocs/core-components/markdown/quick-access-inventory.md).

# Quick-Access Inventory

The Quick-Access Inventory becomes an important part of gameplay when the player picks up items that can / need to be used during gameplay. Things like healables, throwables, or any form of action that is performed upon "using" an item.

***

The Quick-Access inventory separates all items within the players inventory into 3 different categories (accessed by either pressing \[1], \[2], or \[3] on mouse & keyboard. (D-pad up), (D-pad right), or (D-pad down) on gamepad.

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FziyEeuO7ySYefbsiZ6hF%2Fimage.png?alt=media&amp;token=ad871437-0a10-470d-8f66-58616542be60" alt="" width="149"><figcaption></figcaption></figure></div>

These 3 categories can be configured within the framework settings data asset > System Defaults > Inventory > Quick Access.

<figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FYoZRpOr21Kyao9MjTUSr%2Fimage.png?alt=media&amp;token=838601bf-e334-4757-82cd-8d936cad67d8" alt=""><figcaption></figcaption></figure>

Items get sorted into these different categories if they contain the category tag matching either the \[ Top ], \[ Middle ], or \[ Bottom ]. Item category tags are defined within any objects Interaction Data > Advanced Data > Item Inventory Data (assuming the item can be picked up).

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FyXRCXWXMT1E7vHmlkFzl%2Fimage.png?alt=media&amp;token=a51d19a4-e4a2-4486-86bb-44b4e0305b11" alt=""><figcaption></figcaption></figure></div>

***

Using items that appear in the Quick-Access inventory requires your object to have a valid `Use Item Logic` object assigned. If one is not assigned, then the item will appear with a "blocked / can not use" icon next to it within the Quick-Access inventory.

<div align="left"><figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FL1puPPKzjxkutBsGIzhc%2Fimage.png?alt=media&amp;token=0e2a22d8-3021-4185-8d77-1104bb77bde3" alt=""><figcaption></figcaption></figure></div>

Custom `Use Item Logic` objects can be created for more "object specific" behaviour. Easiest way to do so would be by duplicating an existing `Use Item Logic` object blueprint, renaming it, and building your custom logic inside of that object blueprint.\
\
Once created and opened, reference the logic shown below to create your own "Use Item" logic.

<figure><img src="https://2310584459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiMQl6UzBr8OnuaoaiWO%2Fuploads%2FbXa5cmm9N5VNDeJbllAC%2FCustomUseLogic.png?alt=media&amp;token=bc3207f4-8233-473f-9f81-c6b8423deb98" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="note-sticky" %}
Note that if the item in question needs to be removed from the players inventory (or its quantity needs to be reduced by "1"), then you are responsible for manually removing the item using the `ObjectID` variable and calling the `RemoveItemFromInventory (Player)` function from SF's inventory manager. Refer to the "Consume\_Cube" Use Item Logic object blueprint for this.
{% endhint %}

***
