Facts

Facts are key/value pairs that can be set by builders, mobs, and the Fact Scheduler. They can be evaluated in conditions with the fact_check operator, enabling conditional room actions, room checks, loaders, quests, and reactions.

Builders and mobs can set and remove facts with the setfact and clearfact commands. The system can also update them automatically through the Fact Scheduler.

Fact Schedule fields

Name

A descriptive name for the schedule entry.

Fact

The name of the fact to update.

Value

The value assigned to the fact. This field can contain multiple tokens; when it does, Value Selection determines which token is assigned.

Value Selection

Determines how the scheduler chooses among multiple tokens in Value:

• Default sets the fact to the first value.
• Cycle sets the fact to the next value in the list. For example, if season has the values summer fall winter spring and is currently fall, its next value will be winter.
• Random selects a random value from the list.

Schedule

Determines how often the fact is set. Its interpretation depends on Schedule Type.

Schedule Type

• Interval interprets Schedule as the number of seconds between updates.
• Cron interprets Schedule as a cron expression describing when the fact should be set.

Change Message

The message displayed when the fact changes. It can contain these special variables, which are replaced with the appropriate values:

• {{ fact }}
• {{ old_value }}
• {{ new_value }}

For additional background and sample Scheduler configurations, read The Facts Blog Post.