Pia

From Portage County Skywarn - KD8NHF
Jump to: navigation, search

Pia is a multi-purpose IRC bot, capable of performing a wide variety of tasks. She resides in #PCSW on irc.freenode.net. Pia is a Ruby-Bot.

Behavior

  • Pia will report updates to the Skywarn390.com wiki

Modules

Core

Most users will not have any need, nor any access to use these features

  • auth - Login as the bot owner
  • basics - Basic IRC commands
  • config - Maintains configuration options for other modules
  • filters - <ToBeDetermined>
  • httputil - No commands available
  • irclog - No commands available
  • remote - No commands available
  • unicode - No commands available
  • userdata - No commands available
  • wordlist - <ToBeDetermined>

Plugins

alias

Allows creation of arbitrary triggers for existing commands (Authorized users only)

autorejoin

Performs an autorejoin if the bot is kicked from a channel (No commands available)

azgame

azgame is a simple word game. Pia will select a random word from a dictionary. if you guess wrong, the bot will use the new word to restrict the range of allowed words: eventually, the range will be so small around the correct word that you can't miss it.

  • Commands
    • Start a game - !az
    • End a game in progress - !az cancel
    • Check the status of a game in progress - !az

bans

tools to automatically block undesirable behaviors. Unused, for now. Don't make me turn it on. (Authorized users only)

chanserv

interface the bot with the chanserv (Authorized users only)

deepthoughts

Think a (usually humorous) deepthought

  • Command - !deepthought

dice

Roll a set of virtual dice

  • Command - !dice <string>
    • <string> is something like:
      • d6 (roll a standard, 6-sided die)
      • 2d6 (roll two 6-sided dice)
      • 2d6+4 (roll two 6-sided dice and add 4 to the total)
      • 2d6+1d20 (roll two 6-sided dice and one 20-sided die)
      • 2d6+1d5+4d7-3d4-6 (roll two 6-sided dice, a 5-sided die, four 7-sided dice, subtract the roll of three, 4-sided dice, and subtract 6 from the result.)

This plugin was written to help true geeks expand upon their geekdom.

excuse

supplies a random, potentially humorous excuse

  • Command - !excuse

forecast

show the 2-day forecast for a location. <location> can be any combination of City, State, Country and ZIP

  • Command - !forecast <location>

googlefight

Compare the popularity of multiple keywords

  • Command - !googlefight <keyword 1> <keyword 2> ... <keyword n>

hangman

Play a game of hangman in the channel

keywords

fact learning and regurgitation.

markov

A really annoying plugin. When enabled, Pia will attempt to provide somewhat meaningful conversation by responding to comments with spliced-together phrases previously uttered by other channel users.

nickrecover

Allows Pia to recover her nickname if it is lost for some reason (Authorized users only)

nickserv

Allows Pia to handle her protected nickname(s) (Authorized users only)

note

Stores a message for another user. The next time Pia sees that user speak in channel, she will deliver the message.

  • Command - !note <nick> <string>
    • <nick> is the username of the recipient
    • <string> is the message to be delivered

quiz

Unused at this time

reaction

Allows Pia to respond to certain phrases without being specifically addressed. (Authorized users only)

roshambo

Plays roshambo (rock, paper, scissors)
  • Command - !roshambo <rock|paper|scissors>
    • Or - !rps <rock|paper|scissors>

roulette

Play a virtual game of Russian Roulette

  • Command - !roulette

rss

Manage RSS feeds (authorized users only)

search

Conduct a search in various knowledge bases

  • Command
    • Google: !google <string>
    • Wikipedia: !wp <string>
    • Uncyclopedia: !unpedia <string> <== This is a rather vulgar site. You've been warned.
    • Mathematics and conversion functions: !gcalc <string>

seen

Reports the last time Pia has seen a particular person, and the last thing that person said.

  • Command - !seen <nick>

time

The time, as reported by Pia's server

  • Command - !time

topic

Tool to manage the channel topic (authorized users only)

twitter

Shows the last reported status of a twitter user

  • Command - !twitter status <twitter name>

uno

Play a game of Uno in channel

  • Command - !help uno <== Help file for Uno

url

list URLS (website addresses) that have been recently posted in the channel

  • Command - !url list

weather

retrieves latest weather conditions from the National Weather Service or Weather Underground

  • Commands
    • !help weather nws <== NWS instructions
    • !help weather wu <== Weather Underground Instructions

Aliased Commands

  • !math <string> => !gcalc <string>
    •  !math 2+2
      • Returns: 2 + 2 = 4
    •  !math 47F in C
      • Returns: 47 degrees Fahrenheit = 8.33333333 degrees Celsius
    •  !math 144 furlongs per fortnight in millimeters per hour
      • 144 (furlongs per fortnight) = 86 214.8571 millimeters per hour
    •  !math 40 knots in mph
      • 40 knots = 46.0311779 mph