Scripting / Inventory

Effect

Serializable data class embedded in Item assets — not a separate ScriptableObject. Describes a single stat modification applied when the item is used via Instruction_Use. Add effects in the Item Inspector under the Effects list.

PropertyTypeDescription
displayNamestringShort label shown in the HUD when this effect is active.
descriptionstringDetailed description shown in tooltips.
iconSpriteIcon shown in the active effects HUD.
targetStatStatThe Stat this effect modifies.
valueintAmount added to the stat. Negative values reduce it.
durationintNumber of turns the effect lasts. 0 means the modification is instant and permanent for the current run.
applyPerTurnboolWhen true, applies value once per turn for the duration instead of once upfront. Use for regeneration or damage-over-time. Ignored when duration is 0.

Add an Effect to an Item

Effects are not standalone assets — they are embedded directly inside an Item.

  1. Select an Item asset in the Project window.
  2. In the Inspector click + in the Effects list to add a new entry.
  3. Fill in displayName, description, and icon — these appear in the active-effects HUD while the effect is running.
  4. Assign a Stat asset to targetStat.
  5. Set value (positive to increase the stat, negative to reduce it).
  6. Leave duration at 0 for an instant modification that lasts the rest of the run. Set a positive integer to create a timed effect that expires after that many turns.
  7. Enable applyPerTurn if the effect should apply value once per turn (e.g. regeneration or damage-over-time) rather than once upfront. Ignored when duration is 0.