# Main Screen

This screen defaults to displaying the dice selection criteria with no saved item selected. In this mode you can enter formulas in RPG Dice Notation (an abridged version) to handle those complicated scenarios where rolling a number of d6 just doesn't cut it.

## Formula Syntax

The syntax is very straight forward and closely follows your basic algebraic notation. You can add, subtract, multiply, divide, use parenthesis, and unary plus/minus. (All numbers are integers.) Precedence order is the same as your basic algebra with multiplication occurring before addition and subtraction. However, the use of parenthesis will override this. *See Formula Syntax and Functions for more detailed information.* When you've entered your formula, just press the "Roll" button in the upper right-hand corner to roll the dice.

## Selecting Saved Items

If you have saved any dice configurations, you can choose them by tapping the drop-down list (it defaults to "None Selected") and choosing from the items in the list. When you select one, the formula entry area will disappear. Press the "Roll" button in the upper right-hand corner to roll the dice.

## Results

The results are displayed on this screen with the latest roll at the top. If you long-press on an individual result, you will have the option to copy it to the clipboard where it can be pasted anywhere to share.

## Menu Items

Several features are accessible by using the menu on your device.

**Add...**

This will allow you to save the formulas you are entering and a whole lot more. Multiple formulas can be grouped together and rolled at the same time.**Update...**

Modify the currently selected dice configuration.**Copy...**

Add a new group using the currently selected one as a template.**Delete**

Delete the currently selected saved dice configuration.**Import/Export**

The saved groups can be imported and exported so you can share them or work on them on another platform like a PC.

*See***RPG+ - Import/Export**for more details on importing and exporting.**Clear Results**

If the results list gets a little long, or you are switching games, this option will allow you to clear that list.**Share...**

If you have an email application on your device, this will allow you to send all of your results from this page to someone. They will be copied into your email for you.**Help...**

This will bring up the help system.

# Add/Update a Group

Here you can define your dice equations. You can define a collection of equations that are logically grouped together. This can make complicated weapon attacks easier to calculate and evaluate. To explore the potential of this feature, let's start with an example. Example: You have special sword that allows you to make three attacks as follows:

- Attack 1: 1d20+12
- Attack 2: 1d20+10
- Attack 3: 1d20+8

For each of these attacks, if successful, you do damage as calculated below:

- Damage: 2d8+1d6+5

It would be convenient to roll all of these at once rather than having to roll one attack, find the next, roll it, find the next, roll it, and then find and roll the damage. To do this we will define a group that has all of the calculations available to it and can be rolled at the same time. On this screen you will find the following elements:

**Group Name**

Name the group. (required)**Description**

Describe the group to make it easier to identify as your saved items gets larger. (optional)**List of Equations**

The list of equations which we will use to define the our sword described above. (1+ required)

The Equation list is initially populated with a blank equation. This is a prompt so that you know you need to enter at least one of these. In our case, we are going to enter a few. The Equation has three items that we need to familiarize ourselves with:

**Title**

This will be the name of this equation. (required)**Throws**

The number of times we need to throw this equation. (required, defaults to 1)**Expression**

This is where we write the formula. (required)

Our special sword definition can now be added as follows; **Group Name:** Special Sword **Description:** Example **Equations:**

Title | Throws | Expression |
---|---|---|

Attack 1 | 1 | 1d20+12 |

Attack 2 | 1 | 1d20+10 |

Attack 3 | 1 | 1d20+8 |

Damage | 3 | 2d8+1d6+5 |

*Note: The Damage element is the same equation thrown 3 times, once for each attack.*

## Managing the Equations

Note that the term "Equation" is used to refer to the collection of title, throws, and expression. The term "Expression" and "Formula" are used interchangeably.

**Add New Equation**

To add a new equation to the list select the "Add New Equation" button at the top, right of the list. This will take you the "Add/Update Equation" screen.**Update Equation**

Select the "pencil" icon on the equation you wish to update. This will take you the "Add/Update Equation" screen.**Delete Equation**

Select the "trash can" icon on the equation you wish to delete. This will remove that equation from the list.**Move Up/Down**

You can reorder the equations. Select the menu on the equation you wish to move and select "Move Up" or "Move Down" from the pop-up list.

When you've finished with your definition, select the OK button to save the group.

# Add/Update Equation

This screen will collect the data necessary to define your equation. The following elements are available for update:

**Title**

This will be the name of this equation. (required)**Throws**

The number of times we need to throw this equation. (required, defaults to 1)**Expression**

This is where we write the formula. (required)**Entry Aids**

The number, operator and function, and dice lists are presented to facilitate the entry of the expression. Select the element you'd like to insert and tap the clipboard next to it to have it inserted into the current cursor position.**Global Constants**

This is the list of Global Constants that are currently defined. They are presented here as an aid in building your expression. You can type them into the expression or tap the clipboard next to them to have them inserted into the current cursor position.

When you've made your choices, select the OK button to save the equation.