> ## 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.

# Classifiers

> Group items based on characteristics and usage restrictions

## Defining a Classifier

Classifiers are essential for organizing and managing various item types, characteristics, and traits within your game. They allow you to categorize items into specific groups, making it easier to implement game mechanics and restrictions.

Suppose you have a game where players can find items of various types and rarities. You might set up your classifiers as follows:

### Type

| Classifier Option | Roll Numerator |
| ----------------- | -------------- |
| `gear`            | 1              |
| `enhancements`    | 1              |
| `currency`        | 1              |

### Rarity

| Classifier Option | Roll Numerator |
| ----------------- | -------------- |
| `common`          | 70             |
| `rare`            | 20             |
| `epic`            | 10             |

<Tip>The roll numerator allows you to specify weight to each classifier option. This allows you to give higher probabilities to different options within a classifier</Tip>

With this configuration in tact we now have the capability to filter, and affect outcomes of rolls via the [Roll API](/api-reference/roll). If you want the roll to return only gear items, you would filter your roll to include the `gear` option from the `type` classifier.

This ensures that the only gear items with the specified rarity distribution will be returned.

By defining classifiers and using the [Roll API](/api-reference/roll) effectively, you can create a more dynamic and rewarding item distribution system in your game.