Normal Item Collection

Normal Item Collection

This is the most frequently utilized Item Collection type within GIS, serving as the foundational class for all other Item Collection variants.

It encompasses an Item Stack container (i.e., a list of Item Stacks), where each Item Stack holds a reference to an item instance, the item’s quantity, and other pertinent details. You can store an unlimited number of items within this collection.

The collection exhibits the following characteristics:

• The quantity of items added must be greater than or equal to 1; negative values are not permitted.
• Unique items can only have a quantity of 1. If a unique item is added repeatedly to the collection, a duplicate of the item (with a new GUID) is created and added.
• Each item instance exists solely within a single Item Stack (this limitation can be circumvented by using Multi-Stack Item Collections or custom implementations).
• An arbitrary number of items can be added (Collection Restriction Sets can be employed to limit the quantity of specific items; for fixed-size item slots, consider using Slot Item Collections).

Default Settings

These settings are standard fields across all types of collections:

• CollectionTag: A unique identifier for the Item Collection, used to query the collection within the inventory.
• DefaultLoadout: The default items assigned to this collection.
• OverflowOptions: Determines whether an item unable to be placed in this collection should be returned to its source (if a source Collection exists).

Use Cases

This type of collection is well-suited for straightforward scenarios, such as shop inventories or treasure chest inventories.

API

Technical Details

• ItemCollection is a UObject, synchronized over the network via ReplicatedSubObject, and supports RPC calls.
• The Owner of an ItemCollection is set to the Owner of the inventory to which the collection belongs upon initialization.
• The Item Stack container is implemented using FastArraySerializer, with Item Stacks being FastArraySerializerItem. This ensures efficient network replication even with a substantial number of items.