NAME

Bot::Backbone::Service::OFun - A set of Bot::Backbone services optimized for fun

VERSION

version 0.142230

SYNOPSIS

    service code_name => (
        service         => 'OFun::CodeName',
        adjectives_file => 'adjectives.txt',
        nouns_file      => 'nouns.txt',
        db_dsn          => "dbi:SQLite:codename.db",
    );
    
    service dice => (
        service => 'OFun::Dice',
    );
    
    service insult => (
        service  => 'OFun::Insult',
    );

    service "karma" => (
        service     => 'OFun::Karma',
        db_dsn      => "dbi:SQLite:karma.db",
    );

    service "hailo" => (
        service    => 'OFun::Hailo',
        brain_file => "hailo.db",
    );

    dispatcher "chatroom" => as {
        redispatch_to 'code_name';
        redispatch_to 'dice';
        redispatch_to 'insult';
        redispatch_to 'karma';
        redispatch_to 'hailo';
    };

DESCRIPTION

This is a collection of modules designed for use with Bot::Backbone to help make it easy to create bot with various fun features. Many of these services require additional input files or configuration and may also require a database for persistent storage of information. As much as possible, I've tried to implement these in a standardish way.

In the case of persistent storage, I had to choose something, so I chose DBI, which is made avaialble through the Bot::Backbone::Service::Role::Storage.

Here's a list of the included services and what they each do:

  • Bot::Backbone::Service::OFun::CodeName. This is a service that gives you a !codename command that will generate a code name for a word or phrase, which can be a fun way of assigning secret names to your project. It requires storage to save the code names as they are assigned and a couple of word lists.

  • Bot::Backbone::Service::OFun::Dice. This is a very simple service that provides a few commands related to picking numbers at random. The <!roll> command will roll a set of dice according to standard dice notation. The !flip command will flip a coin. The !choose command can choose items from a list. The !shuffle command takes a list and shuffles it to display again.

  • Bot::Backbone::Service::OFun::Hailo. This is a conversation generator. If someone addresses the bot directly, the bot will respond using Hailo. This will save the markov chains learned and used to generate the conversation in a SQLite database.

  • Bot::Backbone::Service::OFun::Insult. This provides a !insult command based upon the Acme::Whoresone::Scurvy::Bilgerat insult generator.

  • Bot::Backbone::Service::OFun::Karma. This provides a karma/score tracker. Any time someone uses a ++ or -- notation on a word or phrase, that word or phrase will have a score recorded. You can then see the list of highest and lowest scores or score for a specific item with the !score command. This requires some storage to track the scores.

CAVEATS

This release also include Bot::Backbone::Service::Role::Storage, which does not belong here. It will likely be moved into a seperate distribution in the future.

AUTHOR

Andrew Sterling Hanenkamp <hanenkamp@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Qubling Software LLC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.