blogstrapping

Droll Release Party

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.