Skip to main content

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.

​
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 OptionRoll Numerator
gear1
enhancements1
currency1

​
Rarity

Classifier OptionRoll Numerator
common70
rare20
epic10
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
With this configuration in tact we now have the capability to filter, and affect outcomes of rolls via the Roll API. 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 effectively, you can create a more dynamic and rewarding item distribution system in your game.