Today is my official droll release party, and you're all invited.
One of two Ruby gems I currently maintain is a dice roller library (primarily designed with roleplaying gamers in mind) that comes with command line and IRC dicebot front ends, called droll (the other is CharsetMove, aka
cmv, a filename transcoder). As of just a few minutes before I started composing this announcement, I pushed a release version 1.0 of droll to RubyGems. You can see it at the RubyGems Droll Page.
For those who have already been using droll, the major difference from droll version 1.0rc5.4.0 is that you no longer have to use the
--pre option when using the
gem command, and the
--version option for the
droll utility will give you a different version number string. I have also updated the README slightly, and uploaded a gem bundle for "manual" download and installation to the Bitbucket download page with the new version number.
As for people interested in the source code, the public repository now has two branches -- the
v1 branch for release version 1.0, and the
default branch where continuing development beyond release version 1.0 will occur.
I have plans for future development, of course, but I have been sitting on the release candidates for long enough. It really is worthy of release v1.0 status, I believe. It is still licensed under the terms of the Open Works License, which is about as unfettered a copyfree license as you're likely to find without being pathologically nonlegalistic (that is, the OWL is probably on much firmer ground for purposes of legal rigor than something like the WTFPL or Crowley Thelemic License, or an attempt at unadorned public domain dedication).
If this is the first you've heard of it, and all you want to do is use the thing, you can start by either reading about it on the main droll page or using the
--help documentation. If you wish to use the command line
droll utility, use this command:
An important bit of extra help is the syntax help, which tells you how to specify particular types of die rolls to have the
droll utility simulate. This syntax help is accessed with the
If you want the quickstart version for normal rolls in, for instance, Pathfinder RPG (a Paizo Publishing trademark) or Dungeons and Dragons (a Wizards of the Coast trademark), just use the same die code format used for decades, involving a(n optional) number of dice to roll, followed by the (lowercase) letter "d", followed by the number of sides the die type has; an optional plus-or-minus modifier may be attached to the end. For instance,
1d10 would roll a single ten-sided die, and
3d6+4 would roll three six sided dice, add the results together, and add four to the result. To use this with
droll, you supply a die code as an argument to the
drollbot IRC dicebot uses the same die code syntax as the
droll command line utility. For an IRC channel with a
drollbot instance signed in, any message sent to the channel that starts with a valid die code will be treated as a die code for
drollbot to resolve.
Additional information about how to use
drollbot is described in the
--help documentation for that tool:
Information about configuring
drollbot (an important step before actually using it, hopefully for obvious reasons) is described in the config help, using the
I hope you enjoy it. Drop me a line (see the link to my contact page) if you have any questions or comments that are not ready for the issue tracker, or look me up in the ##copyfree channel on the freenode IRC network if you want to talk in real time.