RACE (The Random Content Engine)

Introduction

Race comes with a bunch of functions that shall make your life easier, when it comes to random content.
RACE will help you with your game development in all of these situations (and more!):

• Generate Random Maps
• Drop Loot (Chests, Daily Login Bonus, Dying Monsters, ...)
• Spawn Monsters
• Fill any board/array with random objects
• Roll dice

But the most important thing about RACE is:

The elements have different chances to be picked. It is a weighted randomizer!

In general, there are two types of functions:

• Functions that start with race_ are end-user-functions and are here for you to be called.
• Functions that start with two underscores __race are internal functions and should not be called directly.

In addition, Race offers some #macro definitions that shall help you create better readable code. They follow the same scheme: Some start with RACE_ and are here for you to be used, some are internal and start with __RACE.

Macros

Macro	Description
RACE_TABLE_QUERIED	Holds the struct of the topmost table, that started the current query.
RACE_TABLE_CURRENT	Holds the struct of the table where the dropped item here is contained in.
RACE_ITEM_DROPPED	Holds the race struct (race_result_entry) that just dropped.

The RACE_TABLE_* macros _may_hold the same value, but in a recursive scenario, they might be different.