Open Source Android Apps for Developers: Dt-dice-roller (RPG and boardgame dice roller for Android platforms)


Cute Android: Open Source Android Apps for Developers: Dt-dice-roller (RPG and boardgame dice roller for Android platforms)

DiceRoller is an open source Android application for rolling dice for RPGs and boardgames that runs on Android platforms.

Aside from two generic dice-rolling screens (one with a standard set of polyhedral dice, and one with exclusively d6), several game systems are explicitly supported:

* Burning Wheel
* Fudge/FATE
* Hero
* Old World of Darkness (VtM, WtA, etc)
* New World of Darkness (VtR, WtF, etc)

The major feature TODO list includes, but is not necessarily limited to:

* Adding support for additional game systems
* Replacing the icons with a better set
* Creating an actual users’ guide

Project Home

Project owners



QR code

Source Code
# Non-members may check out a read-only working copy anonymously over HTTP.
svn checkout dt-dice-roller-read-only

DiceRoller: Intro and user instructions
It seems every gamer’s first application is either a character generator or a dice roller. Since the machines running Android generally have screens too small for an effective character generator, that left the dice roller. There are other dice rolling programs out there, some of which even run on Android devices. But I wanted one that was all mine, and that did things the way I wanted to do them. Plus, if I made it full-featured enough, it would give me lots of practice with the Android API.

Basic Usage
This is a skeleton of a user guide, but should be enough to get you started.

The first time the application starts up, it’s on the “Generic/d20″ screen. When it’s closed, it remembers the last screen you used, and starts there next time. Each screen is slightly different, and is covered in its own section.

The one thing they all have in common is a results section listing all the individual die rolls and an appropriate total.

Generic Polyhedral
This is probably the most complicated screen, and the one that takes the longest to use. That’s the penalty for being generic, I guess. There are several rows, all of which differ only in the dice pictured. From left to right, the fields are:

* An edit field for entering the number of that kind of die to roll.
* An icon indicating the die type. The icon has the number of sides printed on it (with the exception of the d10, which uses “0″), so it’s not hard to figure out which is which. The d100 (or percentile) row has a pair of d10s instead of a single die with the number 100.

Below the dice rows is a Roll button. Pressing that will roll all of the dice indicated in the edit fields, and display the individual dice and the sum in the results section.

There are only two die rolls you can make on this screen, but they’re all you need. If you play games that use Fudge dice, you already know how they work.

* 1dF
* 4dF

Pressing either Roll button will roll the dice on that row. The results section will show the individual dice as well as the sum.

The Hero screen has two Roll buttons. Each one has a separate function.

Pressing the Roll button on the 3d6 row will generate a standard 3d6 roll. For an attack roll, enter the OCV in the edit field before pressing the Roll button. It calculates what DCV would be hit and prints it in the results section.

The other row is designed for damage. It includes a variable number of dice, an optional half die, and a checkbox for indicating a killing attack. Enter the number of dice to roll in the edit field, check the appropriate boxes, and press the Roll button.

For rolls that are not marked as killing, it calculates both Stun and Body damage. The half die is shown as 1-3, but its Body is calculated from the full die before halving.

For killing attacks, it rolls a stun multiplier from 0-5. Zero is used instead of raising it to 1 so you can correctly account for an increased stun multiplier advantage.

New World of Darkness
This is for the new World of Darkness games:

* the World of Darkness
* Vampire: the Requiem
* Werewolf: the Forsaken
* Mage: the Awakening
* Promethean: the Created
* Changeling: the Lost
* Hunter: the Vigil
* Geist: the Sin-Eaters

It differs from the other screens by having individual dice buttons. Any number of dice up to twenty can be rolled with a single button press. One through five are on the first row, six through ten on the second, and so on.

The radio buttons underneath the dice indicate which X-again rule is in force for the roll (10, 9, 8, or none). Rerolled dice are also subject to the X-again rule, and will be rerolled as appropriate.

The results section displays the dice that were actually rolled (including re-rolls from X-again), as well as the total number of successes.

There’s also a button for a Chance Roll that displays a “Botch” result if a one is rolled. The X-again selection affects the Chance Roll exactly as for any other roll, and should probably be set to 10 before pressing the Chance Roll button.

Old World of Darkness
This is for the old World of Darkness games:

* Vampire: the Masquerade
* Werewolf: the Apocalypse
* Mage: the Ascension
* Changeling: the Dreaming
* Wraith: the Oblivion
* Hunter: the Reckoning

The old World of Darkness screen has the same 20 dice pool buttons as the new World of Darkness, and they are used the same way.

This screen provides an edit field to set the Difficulty from 2 to 10. Any number less than 2 will set the difficulty to 2; any number greater than 10 will set it to 10.

If the 1s Subtract from Successes box is checked, any roll of 1 will cancel a success. If more 1s than successes are rolled, the result will be “Botch” with the negative number in parenthesis indicating the severity.

If the Reroll 10s box is checked, any rolls of 10 will cause an extra die to be rolled. Extra dice that come up 1 or 10 will have the same effects as the original dice.

Generic d6
This is for any game that uses d6 exclusively. Like the World of Darkness screens, there are four rows of five dice each. A single button push can roll any number of dice up to 20. The results and the total of all the dice are shown at the bottom of the screen.

Burning Wheel
Like the other dice pool systems, this screen has rows of five dice each. There’s a radio button group to select the shade, as well as a checkbox for indicating an open-ended roll.

To facilitate using Artha to reroll traitors, the number of traitors is listed along with the number of successes in the results section.

Posted by Cute Android

Related posts:

  1. Open Source Android Apps for Developers: Awesomeguy (Game for the android platform)
  2. Open Source Android Apps for Developers: Hooklineandroid (Fishing game for the Android)
  3. Open Source Android Apps for Developers: Andoku (Android Game)
  4. Open Source Android Apps for Developers: Asqare (Android squares games)
  5. Open Source Android Apps for Developers: Osmeditor4android
  6. Open Source Android Apps for Developers: Rokon (Android Game Engine)
  7. Open Source Android Apps for Developers: Mages (Android Game Engine)
  8. Open Source Android Apps for Developers: jMonkeyEngine (Java Based 3D Game Engine)
  9. Open Source Android Apps for Developers: Libgdx
  10. Open Source Android Apps for Developers: YoghurtGum (Android Game Engine)