Welcome to the home page of Dice Rolling System.
|
General presentation
Dice Rolling System version 2 (dice2) is a complete C library to
roll dices, handling complex dice code parsing and evalution,
syntax tree building from dice code strings, and a fuzzy
logic-powered engine to estimate outcomes of dice rolls.
It is
Free
Software, available under the terms of the GNU General Public
License version 2, or, at your option, any later version as
published by the Free Software Foundation. You're welcome to submit
comments, ideas, patches, bug reports to
kilobug@freesurf.fr.
It contains:
- A full-featured ISO C library,
- Two command-line POSIX programs, to roll dices and use the fuzzy logic simulator from command-line,
- Python bindings to the library.
API overview
Functions available from both C and Python libraries include:
- Simple, high-level functions to evaluate and roll a string like 3d6+(2d4)d8+5;
- Conversion of strings into syntax trees, avoiding to redo the parsing operation if the same dice code is to be rolled frequently;
- Retrieval of the detailed result of each roll done;
- Fuzzy-logic data type, and functions to handle it;
- Functions to evaluate dice codes or syntax trees into a fuzzy integer.
Supported games
Dice2 handles basic dice rolls (3d8 or similar), keeping the best
results of a pool of dice (4.3b6 to keep the 3 best of a pool of
4), keeping the nth result (4.3n6 to keep the 3rd result (starting
from the smaller)), unlimited die rolls (rerolling and adding as
long as the result is close enough to the maxmimal possible one)
and the special rules of the following games: Rolemaster, World of
Darkness (Vampire, Werewolf, Mage, ...), Ars Magica, INS/MV,
Arkeos. If you want to submit a patch to support a new dice rolling
method, feel free to. If you want to add a new dice rolling method
but don't know how to hack, or don't have the time to, feel free to
ask me, I'll try to add it by myself.
Downloads
By downloading and using dice2 or pydice, you accept to the follow
the rules of the GNU General Public License version 2, or, at your
option, any later version as published by the Free Sotfware
Foundation. Basically, it means you can use it, distribute it,
change it, and distribute changed versions as you wish, if you
grant to other users the same freedom you were granted at first. I
remind you that this software is provided as is, WITHOUT ANY
WARRANTY, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
- Dice 2 (library and apps) source code: Version 0.6.2
- PyDice source code (requires dice2): Version 0.6.2
- Debian packages: Debian GNU/Linux i386 Sid. You can add the following line to your sources.list if you trust me enough for that:
deb http://kilobug.free.fr/code/debian ./
- GnuPG signed md5sums are available here
42
|