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:
droll --help
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 --syntax
option:
droll --syntax
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 droll
command:
droll 3d6+4
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:
drollbot --help
Information about configuring drollbot
(an important step before actually using it, hopefully for obvious reasons) is described in the config help, using the --config
option:
drollbot --config
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.