rbossy/yadrol

Yadrol is a dice roller and dice distribution sampler

Yadrol

Yadrol simulates dice rolling and presents roll results or calculates the distribution of rolling dice many times. Yadrol is designed for tabletop role playing games and boardgames enthousiasts that want to study existing dice mechanics or that want to create new mechanics.

You can play with Yadrol right now!

Features

• Flexible dice mechanics language
• Self-contained help: a tutorial for the application, quick help and reference for the Yadrol language,
• Library: most common dice mechanics,

License

Yadrol is an Open Source software distributed under the MIT license.

Deploy

git clone https://github.com/phatonin/yadrol.git
cd yadrol
./server.py

In a browser, open the address http://localhost:8000/.

The server.py script requires Python >= 2.7, though you can use any other HTTP server to expose the directory: Apache, Node's http-server, Jekyll...

Be careful not to expose your .git/ directory since it may contain sensitive information.

Contribute

Use GitHub's issues to ask for help, suggestions, feature requests, or just praises to the author.

yadrol's Issues

Yadrol reference

• Language reference
• Libraries reference

On GitHub wiki if repoable.

Better evaluation errors

Info on the about box

• links to d3.js and jQuery
• licenses of d3.js and jQuery
• link to MIT license

Settings box

Settings: sample size

quick help

Quick help:

• basic interaction
• most used expressions
• URL composition

Handle import failure

Failure to import will result in an exception.

Parse / evaluate tests

Test parse + evaluation.

Create a standard library

• Standard exploding/imploding dice
• BoL
• ORE

Most can be salvaged from java-legacy.

Generate shareable URL

Output framework

• Create structure where outputs are recorded.
• Distribution objects.
• Implement roll, sample and output expressions.

String interpolation

Infobox

In infobox:

• link to github
• credit jquery, bootstrap, plottablejs, and icons
• contact

Persistent expression history

Autostart tutorial

Draw expression

Implement draw expressions.

Display values on graphs

Global scope persistance

Update tutorial to show all buttons in toolbar

Show dice icons for more dice types

• d100
• dFudge

Correct lexer issues

Some lexer tests fail.

Map key Ctrl+Enter to run the simulation

Keyboard shortcut in CodeMirror editor to run the simulation.

Pretty colors

Icons

Replace text with icons:

• About
• Settings
• URL
• Libraries
• History

Update tutorial

Last step must point to the documentation buttons

Roll results layout

Use BS cards

Fix README

Inform expression location

Expressions have a null location. Inform location using parser data.

Mark text area zone of error

When an error is raised: lexer, parser, or evaluation. Mark the appropriate zone in the text area.

Language reference

Cache imports

Cache imports so they aren't loaded several times.

Roll result box close button

Handle escaped characters in string literals

About box

Finish Roll result display

Roll result shall contain:

• name of the output
• result
• dice records using icons

Issue error if EOF in string litteral

Parse query in URL

The query part of the URL could contain parameters for:

• expression string
• run the string
• options: output mode, graph Y, graph centrum

Parse / toString tests

Test parse and toString()

Symbolic value types

Value types are represented as strings. Replace with objects.

Add examples in Language Reference

Improve roll record display

Recipes

Common mechanics

Check for output expression without evaluating

Currently the application evaluates the last expression to check for output.

This causes problems when there are side effects in the last expression.

This could be avoided with a Expression#hasOutput() method.

Syntax highlighting in web app

Remove history item

Standard Libraries

• DnD
• ShadowRun
• Fudge
• FATE
• Barbariabns of Lemuria

Import expression

Implement import expressions.

Access to history

Give access to expression history.

Tutorial

Make this a keyword

Currently this pollutes the function scope.

Apply license header to all sources