Item Definitions

​

Anatomy of an Item Data Asset

Item ID: WoodenSword             // Unique identifier
Display Name: "Wooden Sword"      // Shown to player
Description: "A basic sword..."   // Tooltip text
Flavor Text: "Every hero..."      // Lore text
Item Rarity: Item.Rarity.Common   // Quality tier
Weight: 2.5                       // Weight in kg

• Item ID: Unique FName used by code
• Display Name: Localized text shown in UI
• Description: Functional description of the item
• Flavor Text: Optional lore/story text
• Item Rarity: Gameplay tag defining quality (Common, Rare, Epic, etc.)
• Weight: Used for encumbrance calculations

Max Stack Size: 1                 // How many per stack
Stacking Policy: FullInstance     // How stacking works
Bucket Width Percentage: 20       // Policy granularity
Include Rarity In Stack Key: false

Is Equipable: true
Equipment Slot Tag: Equipment.Slot.MainHand
Compatible Slot Tags: [Equipment.Slot.MainHand, Equipment.Slot.OffHand]
Equipment Type Tag: Equipment.Type.OneHanded

// Visual
Equipment Mesh Variants:
   Default: SK_Sword
   Male: SK_Sword_Male
   Female: SK_Sword_Female

Equipment Material Overrides:
   Item.Rarity.Rare: M_Sword_Blue
   Item.Rarity.Epic: M_Sword_Purple

Attachment Socket: hand_r
Equipment Transform Offset: (X=0, Y=0, Z=0)

// Body Part Hiding
Hides Body Parts: false
Body Parts To Hide: []

• Is Equipable: Can this be equipped?
• Equipment Slot Tag: Primary slot for this item
• Compatible Slot Tags: All slots this can fit in (e.g., ring in either ring slot)
• Equipment Type Tag: Categorization (OneHanded, TwoHanded, Shield, etc.)
• Mesh Variants: Different meshes for different character types
• Material Overrides: Different materials based on rarity
• Attachment Socket: Socket name on skeleton to attach to
• Transform Offset: Fine-tune position/rotation
• Body Part Hiding: Hide character parts when equipped (e.g., hide hair under helmet)

Is Weapon: true
Weapon Tag: Weapon.Sword
Weapon Actor Class: BP_SwordActor
Equip Ability: GA_EquipWeapon
Unequip Ability: GA_UnequipWeapon

• Is Weapon: Marks this as a weapon
• Weapon Tag: Weapon classification
• Weapon Actor Class: Spawned actor when equipped
• Equip/Unequip Ability: Gameplay abilities triggered on equip/unequip

Is Consumable: true
Consumable Data:
   Auto Consume On Use: true
   Drop On Remaining Quantity: false
   Consumable Ability: GA_UseHealthPotion

• Is Consumable: Can be consumed
• Auto Consume On Use: Automatically reduce quantity
• Drop On Remaining Quantity: Drop if some remain after use
• Consumable Ability: Gameplay ability activated on use

Item Stats:
   Fixed Stats:
      [0]: Stat.Attack | Value: 10
      [1]: Stat.Durability | Value: 100
   Rolled Stat Rules:
      [0]: Stat.CritChance | Min: 5.0 | Max: 15.0

Item Value:
   Base Value: 50.0
   Sell Value: 25.0
   Vendor Type: Vendor.Blacksmith

Max Durability: 100.0
Can Decay: true
Decay Rate: 0.1 (per second)

• Fixed Stats: Always the same (e.g., sword always has 10 attack)
• Rolled Stat Rules: Random within range (e.g., crit chance between 5-15%)
• Item Value: Buy and sell prices
• Durability: Maximum durability
• Decay: Deterioration over time

Static Meshes: [SM_Sword]
Skeletal Meshes: [SK_Sword]
Item Offset: (X=0, Y=0, Z=0, Pitch=0, Yaw=0, Roll=0)

Icon: T_Sword_Icon
Full Size Icon: T_Sword_Large

Sounds:
   Equip: SFX_Equip_Sword
   Use: SFX_Sword_Swing
   Drop: SFX_Drop_Metal

• Static/Skeletal Meshes: 3D representation
• Item Offset: Adjust position when held/equipped
• Icon: Small icon for inventory (64x64 or 128x128)
• Full Size Icon: Large icon for inspection
• Sounds: Audio for various actions

Active Ability: GA_PrimaryAttack
Passive Ability: GA_SwordMastery
Remove Ability: GA_SwordMastery
Action Set: ActionSet_Sword

• Active Ability: Triggered on use
• Passive Ability: Always active when equipped
• Remove Ability: Removed when unequipped
• Action Set: Defines primary action behavior

​

Creating Item Data Assets

1. Content Browser → Right-click → Miscellaneous > Data Asset
2. Choose ItemDataAsset as the class
3. Name it with a prefix (e.g., DA_HealthPotion, DA_IronSword)
4. Configure all relevant properties
5. Save