hunterdyar / 3d-dice-roller-unity

Dice notation parser and extensible 3D dice roller

About

This is two projects...

3D Dice roller for Unity

The goal is to be able to call for a dice roll, have it happen in whatever visually interesting way, and get back a result. It will dynamically load a new additive scene which renders it's own camera on top of the rest. It does not have to work this way, and can be easily modified. The dice can stand alone. Adding a grabbable from some VR interaction toolkit, for example, wouldn't be much work.

Dice Notation Parser

Written as pure C# - nothing about it requires unity. The parser could be ripped out (see the 'rollCodeParser' folder) and used elsewhere. It supports common "xdy+m" syntax, and can chain multiple comma or space separated rolls into a sequence of root expressions (the rolls, the modifiers).

Licenses

ses Low Poly 3D Dice by Facehunter2003, released under CC0 (public domain) license.

3d-dice-roller-unity's Issues

Add Drop/Keep to parse toString.

Use static dice-roller scene instead of spawner one.

It's needless and there are too many settings to want to tweak anyway; like embedding animations in it.

The roller loads the scene, it rolls, then unloads it. That's all.

Report back each individual dice roll instead of group from DiceRoller.

Parser to-string missing expressions?

use enum for explode behaviour instead of bool.

Drop/Keep

xdydz - roll x y-sided dice and drop the z lowest.

xdykz - roll z y-sided dice and keep the z highest.

Single rolls get a "Dropped" bool status from this, so we can see them in the results.

Parse ! for exploding dice

Exploding is an exploding enum flag on the dice roll.

Enum options are None, HighestExplode, LowestExplode.

Use [bracket] for labels on rolls

2d20[Fire Damage]
1d10[Ice Damage]

optional strikethrough or exclude dropped rolls on result string. Or some kind of formatter?

Broken when multiple rolls (1d1+2d2+3d3, etc)

Use { } brackets for grouping rolls.

Basically, trying to match roll20 notation.

Pasted from https://wiki.roll20.net/Dice_Reference:

Sometimes you may want to perform a series of rolls, and then compare each roll to a common check (like a success roll). Roll20 provides a "grouped rolls" functionality for this purpose. For example, you can roll two different pools of dice, then keep the highest dice roll across any of the pools:

/roll {4d6+3d8}kh1

If you separate the rolls inside the group with a comma, then we'll sum each individual dice expression in the group before applying any modifiers. For example, if we change the above example to use a comma, instead of keeping the highest single roll, it will instead keep the highest group total:

/roll {4d6,3d8}kh1

This is needed in games based on the Savage Worlds system, where important characters roll a "wild die" in parallel with their main die and choose the highest roll.