cryptofreak.org cryptofreak home projects
contact about
Riggy
NewsNews
DownloadsDownloads
DocumentsDocuments
ScreenshotsScreenshots
Mailing ListsMailing Lists
CVSCVS
TrackersTrackers
Contact: ledge


projects
Antera Antera
Commentator Commentator
Feast Tracker Feast Tracker
News Frotz
gkrellmGIMPS gkrellmGIMPS
Holy Librams! Holy Librams!
Linux Porting Linux Porting
minihuff minihuff
mod-chal mod-chal
Recipe Radar Recipe Radar
RFC 3394 RFC 3394
Riggy Riggy
Contact: webmaster


  HOWTO

To use Riggy, you must talk to him. Like most other 'bots on IRC, he responds to private messages by either executing some command or telling you what you've done wrong. His various functions are explained in detail below. In general, talking to Riggy takes the following form:
/msg Riggy <command> [<arguments> ...]
Where <command> is a single token describing the class of action he should take and [<arguments> ...] is an optional list of parameters for the action.

Online Help Docs

Since referring to this web page all the time probably isn't desirable, Riggy has a terse help message that should provide any forgotten info.

Command: help
Example:
/msg Riggy help

Game State Docs

Because Riggy wants to accommodate everyone, he supports several different game styles for the convenience of the players. White Wolf players, for instance, should not have to specify the number of sides per die since only 10-sided dice are used. Invoking this command with no arguments should reveal the current game type.

Command: game
Arguments: [basic|d20|gurps|ww|sr|mt]
Description:
basic This sets Riggy to his default mode.
d20 The primary difference between d20-style games and basic dice games is the reduced need to specify any arguments to the 'roll' command if you're rolling a d20. Further, a d20 is the default sidedness, so simply specifying a number of dice to roll will roll that many d20s.

Note that you may always specify another die type explicitly.
gurps GURPS games are played only with 6-sided dice, so the number of sides is not required. In addition, because most rolls are of the form 3d6, the '-d' argument is unnecessary.
ww Like GURPS, White Wolf games use only a single type of die: the 10-sided variety. After the '-d' argument, the number of dice to roll is still required.

This mode also changes Riggy's output. Instead of adding die results, he counts successes. See below for other options that can modify this output.
sr Shadowrun is based on successes with 6-sided dice. On critical successes, Riggy will add an additional roll result.

The inclusion of this system is due to a patch from Yves Quemener, 'quemener.yves at free.fr'.
mt The game type implements the Mirima Tyalie system. It is based on success comparisons with notions of dice chaining and dechaining. The '+' and '-' operators modify the success target, and chained criticals are denoted in Riggy's output with '-' (for failures) and '=' (for successes).

The inclusion of this system is due to a patch from B. Lee Adamson Jr., 'leaf at mirimatyalie.org'.
Example:
/msg Riggy game gurps

IRC Utilities Docs

While not as functional as some 'bots in this regard, Riggy does have a couple of handy abilities that relate to IRC.

Command: irc
Arguments: {-c <c>|-o}
Description:
-c <c> Riggy isn't completely helpless on IRC - he can change channels! Supply this command to move Riggy to channel <c>. He will part his current channel before joining the new one.
-o Riggy keeps a database of login/hostname pairs for his friends. If you happen to be one of Riggy's friends and would like operator status in a channel that is +o Riggy, this request asks him to accomplish this.
Example:
/msg Riggy irc -c #riggy

Rolling Dice Docs

Riggy's primary function is rolling dice. He's very good at it, and even fairly fast.

Command: roll
Arguments: -d <n>[d<s>][{+|-|*|/}<i>] [-m <m>] [-n] [-p <nick>] [-s <s>]
Description:
-d <n>[d<s>][{+|-|*|/}<i>] This is the primary argument. It tells Riggy to roll <s>-sided dice <n> times.

(d20, White Wolf, GURPS and Shadowrun mode only) The 'd<s>' is optional, since most rolls are made with static-sided dice.

The optional appendage applies a modifer to the roll outcome. Riggy will add, subtract, multiply or divide the result by <i> according to whether the specified operator is '+', '-', '*', or '/', respectively.
-l <s> Some games require what is sometimes called a 'live die' (eg. Star Wars, in which they are called 'Force Dice'). Riggy can roll a single live <s>-sided die for you by using this switch. The result will appear bracketed at the head of the individual dice result list.
-m <m> Supplying a '-m' switch will ask Riggy to repeat every roll he makes <m> times.
-n (White Wolf mode only) If you don't wish to count 10s as double successes (eg. damage rolls), you may supply this switch to turn 10s into normal, single successes.
-p <nick> By default, Riggy broadcasts the results of his rolls to the channel. Supplying this switch asks Riggy to instead send the results privately to the nickname <nick>.
-s <s> (White Wolf and Shadowrun mode only) Riggy normally counts successes at a default difficulty rating (DR) of 7. To make a roll easier or more difficult, a custom DR may be supplied as the argument of this switch.
Example (D&D):
/msg Riggy roll -d 1d20+5
Example (GURPS):
/msg Riggy roll
Example (White Wolf):
/msg Riggy roll -d 6 -p GM -s 8

Random Name Generation (RNG) Docs

For the overworked GM, Riggy will randomly generate a name for those Red-Shirt NPCs (or any NPC, really) that seem to come up all too often.

Riggy's names are the result of a basic Markov chain algorithm. Input data in the form of real names in a certain language provides the basis for a state machine. The output is a name that follows the basic syntactic rules for the given input set (more or less, anyway).

Command: name
Arguments: {-l|[-m <m>] -n <language> [-p <nick>] [-s {m|f}] [-{1|2|3}]}
Description:
-l View a real time list of available language databases.
-m <m> Supplying a '-m' switch will ask Riggy to generate <m> names.
-n <language> This is the primary argument. It tells Riggy to generate a name using the database named by <language>. Databases (and possible genders) are listed with the '-l' switch. Currently, the following are available:

arabceltic
englishjapan
orcsindarin
viking
-p <nick> By default, Riggy broadcasts the results of his RNG to the channel. Supplying this switch asks Riggy to instead send the results privately to the nickname <nick>.
-s {m|f} Specifies the sex of the resulting name, if the database supports such a selection. (Male names are the default.)
-{1|2|3} This command dictates the amount of whitespace to add to the hash table for each real space in the sample data. '-1' will produce the longest names and '-3' will produce the shortest (on average). '-2' is the default behaviour.
Example:
/msg Riggy name -l
Example:
/msg Riggy name -n japan -s m