They can be used singularly, or used in this combined method.<\/p>\n\n\n\n
Setting up<\/h2>\n\n\n\n
There is a prefab for the Item Container located in \/Prefabs\/ItemContainer_Master.<\/p>\n\n\n\n
If you wanted to set up from scratch, a couple of things to remember – Everything else is free to explore, and is best to try out which settings work for your game – see below for what each setting does. <\/p>\n\n\n\n <\/p>\n\n\n\n Storage Type<\/strong> ByType – Stores only the Items listed in Specific Item Types List. These will then be displayed as an icon above the Item Container. <\/p>\n\n\n\n Overall Container Limit Stat<\/strong> Include In Global Inventory<\/strong> Priority<\/strong> Disabled – No interaction will occur with this Item Container. As with most of the core systems, there are key events you can hook into either via the editor, or via code. <\/p>\n\n\n\n All Item Containers that need saving must have the Saveable Object<\/a> component added to it, which in turn will add a Unique ID<\/a> component. Only one list is saved for Item Containers, the ItemStackData list. This contains the itemID and the amount of the item stored. Any Item Containers placed during runtime ARE saved however because this asset does not do any building logic, you would need to first of all build this asset back into the world – then get its save data (see this section for more details on how to do this) and then finally reinstate the Item Container as saved. <\/p>\n\n\n\n Loading is fairly straght forward and will load the Item Amounts list exactly as saved. Destroyed Item Containers before saving will be completly reinstated if they were placed in the editor. As the asset has nothing to do with building – all destroyed Item Containers should be dealt with in how you define your placement\/removal\/loading logic. If placed in the editor, your loading logic could remove the gameobject if it was destroyed. <\/p>\n\n\n\n There are some nice complementary components for Item Container, such as the Event Visual<\/a>, Popup Spawner<\/a>, Stat Bar<\/a> and Info Icon<\/a>. This section will cover scripting for developers wanting to hook into the system. Most public methods have a summary and info on what each parameter is for. <\/p>\n\n\n\n Introduction Item Containers are the flexible storage solution linking up to the Inventory Manager as a Global Storage solution if required. They can be used singularly, or used in this combined method. Setting up There is a prefab for the Item Container located in \/Prefabs\/ItemContainer_Master. If you wanted to set up from scratch, a couple […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"doc_category":[46],"doc_tag":[],"class_list":["post-2196","docs","type-docs","status-publish","hentry","doc_category-resource-and-production"],"acf":[],"aioseo_notices":[],"year_month":"2026-04","word_count":1594,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"rickitz5h","author_nicename":"rickitz5h","author_url":"https:\/\/golemitegames.com\/index.php\/author\/rickitz5h\/"},"doc_category_info":[{"term_name":"Resource And Production","term_url":"https:\/\/golemitegames.com\/index.php\/docs-category\/resource-and-production\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/docs\/2196","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/comments?post=2196"}],"version-history":[{"count":19,"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/docs\/2196\/revisions"}],"predecessor-version":[{"id":2523,"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/docs\/2196\/revisions\/2523"}],"wp:attachment":[{"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/media?parent=2196"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/doc_category?post=2196"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/golemitegames.com\/index.php\/wp-json\/wp\/v2\/doc_tag?post=2196"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
The parent should contain the Item Container component, with the Mesh with Collider (3d or 2d) attached as a child. Any other components you wish to add to the Item Container such as a StatBar<\/a> for the Overall Capacity or a Popup Spawner<\/a> should also be children of the Item Container gameobject.
It should look something like this.<\/p>\n\n\n\n![\"\"](\"https:\/\/golemitegames.com\/wp-content\/uploads\/2025\/11\/image-10.png\")
<\/figure>\n\n\n\nSettings<\/h2>\n\n\n\n
![\"\"](\"https:\/\/golemitegames.com\/wp-content\/uploads\/2025\/11\/image-11.png\")
<\/figure>\n\n\n\n
All – Stores every type of Item<\/a> available<\/p>\n\n\n\n
The overall capacity of the container. This Sums all Item Amounts, to check against this Limit.
Stack Count Limit<\/strong> Stat<\/strong>
The Stack capacity of the container. If Items have a stack size set, then after that stack has reached its limit, then a new stack is created. The total stacks are checked against this Limit. You can think of stacks as slots in a container.
See below the two stacks, as the Log Item<\/a> has a stack size of 10.<\/p>\n\n\n\n![\"\"](\"https:\/\/golemitegames.com\/wp-content\/uploads\/2025\/11\/image-12.png\")
<\/figure>\n\n\n\n
If true, this Item Container will be part of Global Storage solution provided by the Inventory Manager<\/a>.
If false, this Item Container will act independently.<\/p>\n\n\n\n
Priority will change which Item Container is chosen by the Inventory Manager<\/a> during the selection in the Global Storage solution. Highest available is picked first.
Interact Behaviour<\/strong>
Click – Opens the Inventory window with only the Item Amounts in this Item Container.<\/p>\n\n\n\n
Item Amounts <\/strong>
This is the List of Item Amounts this Item Container is currently holding, split into stacks if applicable.
Note – This is generally meant for testing as it kept public, you can add things to this list in the inspector, and it will refresh on Start as long as the game is not loaded. If the game is loaded, everying put in from the inspector will be overwritten. <\/p>\n\n\n\n![\"\"](\"https:\/\/golemitegames.com\/wp-content\/uploads\/2025\/11\/image-13.png\")
<\/figure>\n\n\n\nEvents
<\/h2>\n\n\n\n![\"\"](\"https:\/\/golemitegames.com\/wp-content\/uploads\/2025\/11\/image-14.png\")
<\/figure>\n\n\n\n
On Item Amounts Changed Event<\/strong>
Triggers whenever there are any changes in the Item Container, whether added, or removed.
On Item Amount Add Event<\/strong>
Triggers when an Item Amount<\/a> is added.
On Item Amount Remove Event<\/strong>
Triggers when an Item Amount<\/a> is removed.
On Hit Overall Limit Event<\/strong>
Triggers when Overall Limit Stat is reached.
On Stack Limit Event<\/strong>
<\/strong>Triggers when Stack Limit Stat is reached.<\/p>\n\n\n\nSaving and Loading<\/h2>\n\n\n\n
Check SaveManager<\/a> to see how to do custom save and load back into your scene.<\/p>\n\n\n\nExtras<\/h2>\n\n\n\n
Any extras can be drag and dropped as child to this component’s gameobject. For super UI control, add a UI Billboard<\/a> to Stat Bar<\/a> and Info Icon<\/a>, or use the prefab for both StatBarInfoIcon in \/prefabs\/UI.
Event Visual<\/strong>
Animates the component using public functions.
Popup Spawner<\/strong>
Displays a popup of the Item Amount<\/a> that is added or removed from the inventory.
Stat Bar<\/strong>
Assigned to Item Container Overall Container Limit Stat in the left hand corner. Displays the Container storage space of the Item Container.
Info Icon<\/strong>
Displays either the Specific Item type of the container or the largest amount of Item<\/a> in there. <\/p>\n\n\n\nScripting<\/h2>\n\n\n\n
\/\/Actions\n\n\/\/Triggers when there any changes to the Item Container, both adding and removing\npublic Action<ItemAmount, bool> OnItemAmountsChangedAction;\n\n\/\/Triggers when an ItemAmount is added\npublic Action<ItemAmount> OnItemAmountAddAction;\n\n\/\/Triggers when an ItemAmount is removed\n\/\/Note that this Action returns a COPY of the ItemAmount\n\/\/The actual ItemAmount has been removed and does not exist anymore\npublic Action<ItemAmount> OnItemAmountRemoveAction;\n\n\/\/Triggers when the OverallLimitStat is reached\npublic Action OnHitOverallLimitAction;\n\n\/\/Triggers when the StackLimitStat is reached\npublic Action OnHitStackLimitAction;\n\n\/\/Examples of how to set up the Actions\nprivate void Start()\n{\n itemContainer.OnItemAmountsChangedAction += (item, added) => DoSomething(item, added);\n itemContainer.OnItemAmountAddAction += (item) => DoSomething(item);\n itemContainer.OnItemAmountRemoveAction += (item) => DoSomething(item);\n itemContainer.OnHitOverallLimitAction += DoSomething();\n itemContainer.OnHitStackLimitAction += DoSomething();\n}\n\n\/\/\/ <summary>\n\/\/\/ Use the ItemAmounts pre-added into the container to restart the container from there - will not do anything if the game is being loaded\n\/\/\/ <\/summary>\npublic void InitialiseState()\n\n\/\/\/ <summary>\n\/\/\/ Opens this individual ItemContainer in the InventoryManager UI, or if it currently open, close it\n\/\/\/ Will only work with interactWithMenusOpen bool set to true on InputManager\n\/\/\/ <\/summary>\npublic void OnClick()\n\n\/\/\/ <summary>\n\/\/\/ Add an ItemAmount to this ItemContainer within the storage constraints\n\/\/\/ <\/summary>\n\/\/\/ <param name="itemAmountToAdd">The ItemAmount, containing the item and the quantity<\/param>\n\/\/\/ <param name="overrideAmount">Optional value for the amount of itemAmountToAdd amount. This will override the amount if greater than 0<\/param>\n\/\/\/ <param name="updateOverallContainerLimitStat">Updates the overallContainerLimitStat by default, pass false to skip the update<\/param>\n\/\/\/ <returns>Remainder of not stored<\/returns>\npublic double AddItem(ItemAmount itemAmountToAdd, double overrideAmount = 0, bool updateOverallContainerLimitStat = true)\n\n\/\/\/ <summary>\n\/\/\/ Removes an ItemAmount from the container if it exists, over all stacks\n\/\/\/ <\/summary>\n\/\/\/ <param name="itemAmount">The ItemAmount to remove, uses the item._id to match so does not have to be the ItemAmount instance<\/param>\n\/\/\/ <param name="amount">Optional override amount to remove, otherwise uses itemAmount.Amount<\/param>\n\/\/\/ <returns>Whether any or all was removed<\/returns>\npublic bool RemoveItem(ItemAmount itemAmount, double amount = 0)\n\n\/\/\/ <summary>\n\/\/\/ Transfers all items from this container into another.\n\/\/\/ Will respect stack limits, container capacity, etc.\n\/\/\/ Leaves any untransferred items in the source container.\n\/\/\/ <\/summary>\npublic void TransferAllItemAmounts(ItemContainer targetContainer)\n\n\/\/\/ <summary>\n\/\/\/ Clears the ItemContainer\n\/\/\/ <\/summary>\npublic void RemoveAllItems()\n\n\/\/\/ <summary>\n\/\/\/ Makes several different checks to test if the container is full, or can accept a specified ItemAmount in full\n\/\/\/ <\/summary>\n\/\/\/ <param name="incoming">Can this Item Container fit this ItemAmount in full<\/param>\n\/\/\/ <returns>Whether the Item Container is full<\/returns>\npublic bool IsFull(ItemAmount incoming = null)\n\n\/\/\/ <summary>\n\/\/\/ Get the sum of all ItemAmounts in this ItemContainer\n\/\/\/ <\/summary>\n\/\/\/ <returns>The total number of ItemAmount.Amount<\/returns>\npublic double GetTotalItems()\n\n\/\/\/ <summary>\n\/\/\/ Get the ItemAmount from the given Item\n\/\/\/ <\/summary>\n\/\/\/ <param name="item">The Item to check for, uses the Item._id<\/param>\n\/\/\/ <returns>ItemAmount, or null if not found<\/returns>\npublic ItemAmount GetItemAmount(Item item)\n\n\/\/\/ <summary>\n\/\/\/ Get the ItemAmount from the given id\n\/\/\/ <\/summary>\n\/\/\/ <param name="id">The id of the Item to look for<\/param>\n\/\/\/ <returns>ItemAmount, or null if not found<\/returns>\npublic ItemAmount GetItemAmount(int id)\n\n\/\/\/ <summary>\n\/\/\/ Get the total amount of all of a certain ItemAmount.Item\n\/\/\/ <\/summary>\n\/\/\/ <param name="itemAmount">The ItemAmount for which the Item._id is checked<\/param>\n\/\/\/ <returns>The sum total of all of this type of Item<\/returns>\npublic double GetItemCount(ItemAmount itemAmount)\n\n\/\/\/ <summary>\n\/\/\/ Checks to see if the any of the incoming List<Item> have an id that matches any of the specificItemType id's. StorageType.All returns true.\n\/\/\/ <\/summary>\n\/\/\/ <param name="items">The Items List to check against<\/param>\n\/\/\/ <returns>Whether any of the Item._id matches any of the specificItemTypes<\/returns>\npublic bool DoItemTypesMatch(List<Item> items)\n\n\/\/Saving and Loading \npublic object CaptureState()\npublic void RestoreState(object state)<\/code><\/pre><\/div>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"