Prototype/ItemWithInventory

Basics

Inherits from prototype/ItemWithLabel and is used in the base game by the blueprint book item.

 type = "item-with-inventory"

The inventory allows setting player defined filters similar to the quickbar and cargo wagon inventories.

Mandatory properties

inventory_size

The inventory size of the item.

 inventory_size = 20 -- 20 slots

Optional properties

item_filters

A list of explicit item names to be used as filters.

 item_filters = {"iron-ore", "copper-ore", "coal", "stone"}

item_group_filters

A list of explicit item group names to be used as filters.

 item_group_filters = {"storage", "belt"}

item_subgroup_filters

A list of explicit item subgroup names to be used as filters.

 item_subgroup_filters = {"capsule", "tool"}

filter_mode

This determines how filters are applied. If no filters are defined this is automatically set to "none".

 filter_mode = "blacklist" -- or "whitelist" if you want whitelisting

filter_message_key

The locale key used when the player attempts to put an item that doesn't match the filter rules into the item-with-inventory.

 filter_message_key = "....."

If not defined this defaults to "item-limitation.item-not-allowed-in-this-container-item".

extends_inventory_by_default

When true, this item-with-inventory will extend the inventory it sits in by default. This is a runtime property on the result item that can be changed through the Lua interface and only determines the initial value.

 extends_inventory_by_default = false -- the default is false if not defined

insertion_priority_mode

The insertion priority mode for this item. This determines if items are first attempted to be put into this items inventory if the item extends the inventory it sits in when items are put into the parent inventory.

 insertion_priority_mode = "never"

Possible values are:

Flag	meaning
default	Items are inserted into this item-with-inventory only if they match the whitelist defined in the prototype for the item and whitelist is used.
never	Items are never inserted into this item-with-inventory except explicitly by the player or script
always	All items first try to be inserted into this item-with-inventory
when_manually_filtered	When the inventory contains filters that match the item-to-be-inserted then try to put it into this item before the inventory this item resides in