> ## Documentation Index
> Fetch the complete documentation index at: https://docs.forgegames.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Attributes

> Define and manage item properties and statistics

## 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 Name | Min | Max |
| -------------- | --- | --- |
| `health`       | 1   | 100 |

### Damage

| Attribute Name | Min | Max |
| -------------- | --- | --- |
| `damage`       | 10  | 50  |

### Speed

| Attribute Name | Min | Max |
| -------------- | --- | --- |
| `speed`        | 1   | 10  |

<Tip>
  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.
</Tip>

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](/api-reference/item-instances), 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.