The VisualItemData ScriptableObject defines cosmetic items that can be equipped on characters, such as hats, glasses, trails, or stamps.
Each cosmetic is tied to a specific slot (e.g., "hat", "trail", "stamp"), ensuring only one item per slot can be active at a time.
This system allows you to easily expand character customization by adding new visual options.
Step 1 – Create a Visual Item Scriptable
In the Project window, right-click and select:
Create > SlingshotPuzzle > Visual Item
Rename the asset to represent the cosmetic (e.g., RedHat, BlueTrail, StarStamp).
Step 2 – Assign in GameInstance
Open the MainMenu scene.
Select the GameInstance object.
In the Visual Items List, add your new VisualItemData asset.
Save the scene.
Your new visual item will now appear in the shop or character customization menu.
Editable Variables (VisualItemData)
🔹 Identification
itemId → Unique numeric identifier for the visual item.
itemName → Multilingual display name (shown in shop/selection UI).
itemDescription → Multilingual description text.
🔹 Slot
slotName → Defines which category this item belongs to (e.g., "hat", "trail", "stamp").
Only one item per slot can be equipped at a time.
🔹 Visual References
previewSprite → Icon shown in the shop or customization UI.
visualPrefab2D → Prefab that is spawned or enabled when the item is equipped.
🔹 Unlock
isUnlocked → If true, this item starts unlocked and does not appear in the shop.
Example Uses
Hats → Cowboy hat, wizard hat, sports cap.
Trails → Fire trail, rainbow trail, sparkly trail.
Stamps → Explosion mark, star print, paw print.
⚡ This system makes it easy to expand character customization. Developers can add new cosmetic categories simply by using a new slotName (e.g., "glasses", "backpack").