DivNull Software
Home
Download
Docs
Using
Making Lists
License
Credits
Omnihedron

Documentation

Getting Started | Preferences | Dice Window | List Window

Dice Window

Omnihedron provides advanced dice-rolling capabilities, adaptable to nearly any game system. All of these abilities are made available in the Dice Window:

Dice window screen image

Window Elements

The dice window is divided into four basic sections: the toolbar, the dice list, the results field and the dice graph. The dividers between the panes can be moved to alter the relative sizes of each pane, and these changes will automatically be remembered.

Toolbar

The toolbar contains a number of control buttons and several text fields. The elements of the toolbar, in order, are:

  • Roll button: When clicked, the dice item currently selected in the list is rolled a number of times specified in the Rolls edit (or once, if nothing is there) and applied to the target number specified in the Target edit, if any. See Making Rolls (below) for more detail information.
  • Graph button: Toggles the visibility of the Dice Graph (see below).
  • Delete button: Deletes the currently selected dice item from the dice list.
  • Rolls edit: Defines the number of times to roll a dice item.
  • Target edit: Defines the target to test against the dice item. How the test is performed depends on the preference settings.
  • Add button: Adds the dice item specified in the Add edit. If the Add edit is blank, clicking this button will open a window that allows the definition of a dice string.
  • Add edit: Defines the dice string to be added.

Dice List

This list contains a pool of dice types that can be rolled. You can select an item in the list, then act on it with toolbar buttons, menu choices, etc. Double-clicking a dice item is equivalent to selecting the item, then clicking the Roll button.

Generally, each dice type (e.g. "3d6" appears in the list only once). Some preference settings can be made, however, to list the same item more than once, attached to specific target numbers or counts.

Results

When a dice item is rolled, the result(s) of the roll appear in this space. If a target number was provided for the roll, rolls that succeed (based on the preference settings) are listed in bold and the total number of successes is listed. The results are typically sorted, but you can alter this behavior with a preference setting.

Dice Graph

The visibility of this pane is toggled by the Graph button in the toolbar. If visible, this pane will graph the statistics for the currently selected dice item. Note that a specific dice type (e.g. "3d6") has only one set of statistics, even if configured to appear in the list more than once.

By default, statistics for dice are tracked cumulatively between the entire lifetime of the application.

Dice Menu

The Dice Window has its own menu, that performs many of the same functions as the toolbar. It also defines a number of accelerator keys to invoke Dice Window functionality from the keyboard. The menu behaves as follows:

ItemAcceleratorFunction
Dice WindowControl DToggles visibility of entire Dice Window.
RollControl R or F5Identical to the Roll button on the toolbar.
Display GraphsControl GIdentical to the Graph button on the toolbar.
Delete DicenoneIdentical to the Delete button on the toolbar.
Add DiceF6Identical to the Add button on the toolbar
Set Count to xControl xSets the Count edit to x.
Set Target to xControl Alt xSets the Target edit to x.

Making Rolls

Rolling dice with Omnihedron is easy, with a great deal of complexity and power available if you want it. In its simplest form, rolling dice is as easy as double-clicking on the dice item you want to roll. You can also select the item with a single click and either click the roll button in the toolbar, choose "Roll" from the Dice menu, or type Ctrl-R or F5.

Rolling a dice item multiple times is more complicated and, for some games, much more useful. By entering a number greater than one in the "Rolls" edit field, when you roll a dice item, it is rolled as many times as you entered, each generating a separate result in the Results pane. Note that a dice item may itself contain multiple dice (or even different kinds of dice), and this can be a bit confusing at first. The thing to remember is that a dice item defines a single set of dice that are summed up to get a single result. By setting the "Rolls" edit field to n, you tell Omnihedron to roll and sum the dice in the dice item n distinct times. For example, if a dice item is a "3d6", and set the "Rolls" edit to 4, Omnihedron will roll three six-sided dice and sum them. This will be reported as the first result. It will then roll three six-sided dice again, and sum them. This will be reported as the second result. This will continue until four sets of three six- sided dice are rolled. This is, perhaps, better illustrated in the following table:

Dice ItemRolls fieldSample Result
d6empty4
d613
d633, 3, 5
2d617
2d635, 8, 10
2d6 + d10112
2d6 + d1058, 14, 20

This means that for games where tests involve rolling handfuls of the same kind of dice and treating the result of each die separately, the "Rolls" field is very important. The "Single Die Type Setup" section (below) shows a good way to configure Omnihedron to support such games.

Rolls can also be made against specific target numbers by providing a numeric value in the "Target" field. This does not change the way rolls are made, but alters how results are reported. Each roll that is judged a success is displayed in bold type in the results pane. In addition the results pane reports the total number of successes. Because different games may have different standards for success (e.g. some consider a success rolling the target number or under, while others use the target number or over as a success), you may need to adjust the preference settings to have Omnihedron judge successes correctly for the game system you use.

Adding Dice

Adding dice is done easily by typing a legal dice string into the Add edit (next to the Add button in the toolbar), then clicking the Add button. The new dice type will be inserted into the list.

If you find the dice string format confusing, you can also leave the Add field blank and just click the Add button. This will open a screen that constructs a dice string for you, based on settings that you choose:

Dice screen image

Depending on your preference settings the current values in the Rolls and Target fields might be attached to the dice item as well. This allows you to add items with predefined roll counts and/or target numbers for quick access.

Standard Setup

The standard dice setup for Omnihedron contains an entry for each of the common dice types found in roll playing, plus the 3d6 type.

Single Die Type Setup

In addition to the typical kinds of dice, Omnihedron is built to support games that rely on rolling handfuls of a single type of dice, then judge the results of these dice independently. To support these types of games without doing a lot of manual fiddling each time you roll, however, you need to change some of Omnihedron's settings.

First, open the Preferences screen and enabled the "include count when adding dice" option. Now, you can add dice items with attached counts, so you can fill you dice list with predefined "handfuls" of dice. The rest of these instructions show you how to do this.

Figure out the type of dice string that represents a single dice in your game. Often games that use this kind of dice rolling use the concept of "exploding" or "open" rolls as well. Say, for example, that the game uses 10-sided dice. An "exploding" roll would be where rolling a 10 means that you re-roll the dice and add 10 to the result. If that second roll is a 10, you keep repeating the process. This kind of roll is represented by the dice string "t10". (The "t" here stands for "test", as many games use this kind of dice in what they call "tests".)

Type the proper dice type ("t10" in the example above) into the Add field. Now type "1" into the Rolls field and click the Add button. This will add a dice item with an attached count to the dice list (in the example, it would look like "t10 (n:1)"). Now repeat the process with the Rolls field set to "2". This creates "t10 (n:2)". When you double-click this item, it will always roll two exploding 10-sided dice, regardless of how the Rolls field is set.

Repeat this process until you think you have all the preset combinations you will ever need.