​
Defining an Attribute

Attributes are essential for defining the characteristics and statistics of items within your game. They enable customization and progression by allowing items to have unique properties that impact gameplay mechanics. Suppose you have a game where items can have varying levels of strength, speed, or durability. You might set up your attributes as follows:

​
Health

Attribute NameMinMax
health1100

​
Damage

Attribute NameMinMax
damage1050

​
Speed

Attribute NameMinMax
speed110
Setting the min and max values for attributes ensures that randomized values remain within the defined boundaries. This is especially useful for rolling loot or defining item templates.
With this configuration in place, attributes can dynamically affect gameplay. For example:
  • A weapon with higher damage might give players an advantage in combat.
  • An armor item with increased health can enhance survivability.
  • Speed can influence how fast a character moves or attacks.
By defining attributes and using the Item Instance API, you can create a robust and flexible system for customizing gameplay elements.

​
Advanced Usage

Attributes can also be combined with other Forge features, such as random rolls or event triggers, to add complexity and depth to your game mechanics. For example:
  • Roll a weapon’s damage within a range of 20–40 to provide variability in loot drops.
  • Scale an attribute like health as a player progresses to higher levels.
By leveraging attributes effectively, you can build a dynamic and engaging item system that adapts to your game’s design needs.