GS_Item
Categories:
GS_Item provides the foundational inventory and equipment infrastructure for GS_Play games. It handles how items are stored, organized, and associated with characters — from simple containers that hold collectables to slot-based equipment systems that drive visual changes through GS_Performer.
For architecture details, component properties, and extending the system in C++, see the GS_Item API.
Quick Navigation
| I want to… | Feature | API |
|---|---|---|
| Store, stack, and manage items in container-based inventories | Inventory | API |
| Equip items into typed character slots with visual integration | Equipment | API |
Installation
GS_Item requires GS_Core. GS_Performer is an optional dependency for visual equipment integration.
For a full guided walkthrough, follow the Simple Project Setup guide.
Quick Installation Summary
- Enable the GS_Item gem in your project configuration.
- Define item data assets for your game’s items.
- Place Inventory components on entities that need to store items.
- Place Equipment components on characters that need to equip items.
Inventory
The Inventory system is a container-based model for item storage. Each inventory is a collection of item slots where each slot holds an item reference and a stack count. The system handles adding, removing, querying, and capacity management. Any entity can host an inventory — a player backpack, a chest, a vendor, or a loot bag.
Equipment
The Equipment system is the slot-based layer that governs which items a character has equipped. Each slot has a defined type and enforces compatibility rules. Equipment integrates with GS_Performer’s Skin Slot system — equipping an item automatically updates the matching visual asset, connecting inventory state to character presentation.
See Also
For the full API, component properties, and C++ extension guide:
For related systems:
Get GS_Item
GS_Item — Explore this gem on the product page and add it to your project.