Documentation

Getting Started | Preferences | Dice Window | List Window

Preferences

Omnihedron features a number of user-settable preferences, set with the Preferences dialog. This dialog can be reached by choosing "Preferences..." under the "Edit" menu. The preferences dialog looks like this:

Directories

The directories section allows you to set the directory Omnihedron examines for lists.

List Window Options

The controls in this section control the behavior of the List Window.

Clear results before a roll

If this option is on, any time a list is rolled, the results section of the list window is first cleared. If this option is off, new list rolls are added to the end of the results section.

Clear results before displaying list information

If this option is on, any time information about a list is displayed, the results section of the list window is first cleared. If this option is off, new list information is added to the end of the results section.

Display number rolled in results

If clicked, the actual rolls made on top-level lists are displayed. This does not display rolls on subtables or on sequence lists.

Random Number Settings

Omnihedron provides several options for generating random numbers.

Operating System

This uses the standard random function for the platform on which the library runs. Generally, these internal random number generators perform very badly on randomness tests.

Combined Linear Congruential Generator

A number is generated using a combined linear congruential generator (CLCG). It has a longer period that the system generators and performs better in some randomness tests. It is also slightly faster. This is the default.

Modified Linear Feedback Shift Register

A number is generated using a maximal length, linear feedback shift register modified for faster software implementation. This register is used to generate random bits, from which integers are generated. This method is slower, but performs better on randomness tests than the CLCG.

Dice Window Options

The Dice Window section allows you to customize the behavior of the Dice Window. All of theses settings may be combined in various ways.

Roll under target considered success

If a number is provided in the Dice Window's Target field, a roll will be marked as a success if it is less than this number and this option is turned on. This should be turned on for use with gaming systems where the goal of a dice roll is to get less than a certain number.

Roll equaling target considered success

If a number is provided in the Dice Window's Target field, a roll will be marked as a success if it exactly equals this number and this option is turned on. This setting is usually combined with either the "roll under target" or "roll over target" settings. For example, when using a gaming system where the goal of a dice roll is to roll a specific number or higher, you would set both this setting and the "roll over target" setting.

Roll over target considered success

If a number is provided in the Dice Window's Target field, a roll will be marked as a success if it is greater than this number and this option is turned on. This should be turned on for use with gaming systems where the goal of a dice roll is to exceed a certain number.

Sort dice results

If this option is on, the results of a multiple roll (that is, when the when the Rolls field is set to a number greater than one) are sorted in the results pane of the Dice Window, from lowest to highest. If this setting is not set, the rolls are output in the order they were rolled.

Remember stats between session

If this option is set, statistics about each dice type listed in the Dice Window are saved when Omnihedron quits and restored when it is re-launched. This allows long term tracking of dice statistics.

Display dice from lists

Most of the lists in the List Window use various dice strings. Usually, these dice strings are hidden from you, but enabling this option will show these dice strings in the Dice Window. This is useful if you want to see statistics on those dice sets.

Roll dice automatically when added

When using the Add feature of the Dice Window, the dice roll added will be rolled immediately if this option is set.

Include count when adding dice

If this option is on, the value of the Roll field is included when adding dice. Each combination of count and dice is treated as independent entries in the list if this option is on.

This option is most useful for systems that use batches of identical dice, such as the Storyteller system or Shadowrun. For such games, turn this option on, then add the primary dice type for the game several times, increasing the count each time. This will provide preset "handfuls" of dice. For example, for a game that uses "exploding" six sided dice, you might set the dice window up like this:

Include target when adding dice

If this option is on, the value of the Target field is included when adding dice. Each combination of target and dice is treated as independent entries in the list if this option is on.