HoneyJar

HoneyJar is an IRC bot currently active on the Netgamers IRC network

Notation

denotes a mandatory parameter

[parameter]

denotes an optional parameter

HoneyJar uses aliases at many places. That means it can log your actions under a different nick than that which you currently "wear". As a default on Netgamers IRC, HoneyJar uses your P-nick as an alias if you are logged in with 'mode x' and use the netgamers host mask, for example HoneyJar.users.netgamers.org. Doing so, you can use a different nick or tags like |away, |AFK and HoneyJar will still see you under your registered nick.
However, if you don't want to use the P-nick and don't want to switch of the Netgamers hostmask, or if you don't want do use the Netgamers hostmask and still want an alias, just talk to me (Jaran) and I can add aliases manually which can even override the hostmask standard alias.

Command overview

commands to make you wiser

!google <query>

returns the first link from Google found with the query

!spell <word>

tries to give a correct spelling of the word you entered

!define <query>

tries to give you a definition of the query you entered
if you get a wrong answer please contact 'Jaran' on the network and tell him so: the entries can be corrected

!recentlines [nick/lines]

shows the last 5 lines spoken by [nick] in the current channel
if you specify no nick HoneyJar will give you a link to a website with the last 200 events of the current channel
if you specify a number instead of a nick HoneyJar will do the same as above but give you as many events as you specified (max. 5000)
the website mentioned in the last items is updated only when the !recentlines command is used

!recentlines <minutes/hours> <m/h>

returns the events of the last minutes/hours
example: '!recentlines 5 m' shows the events of the last 5 minutes whereas '!recentlines 3 h' shows the last 3 hours of activity in the current channel
no more than 5000 lines will be returned, even if more events occured in the specified time-frame

!missedlines [nick]

shows the lines since your last action up to now plus the minute before your last action
actions like joining a channel or quitting it won't reset the time of your last action, this ensures a proper history for you even after a ping timeout and rejoin
the command itself and the channel history use your alias which is either your registered nick if you use the irc-networks hostmask or an alias added manually to HoneyJar
be sure to do !missedlines as a first action of yours when you rejoin a channel since any other line you say will reset your missedlines history

!fulltext <query>

performs a fulltext search on the channels log and returns the 5 most relevant hits
the id# returned before each hit can be used with the '!showid' command

!showid <id>

shows you 6 lines around the event in the current channel which is specified by the id
this command makes sense with ids returned by the '!fulltext' command

!urls [count]

returns those log entries which contained an URL
if no count is specified up to 5 most recent URLs from the channel will be presented
more than 5 results will be shown on a website (you will be given the link to it by HoneyJar)

commands to give you stats

!top10

returns the top 10 users on the current channel counted since HoneyJar first joined the channel
returns also the top 10 users of the current channel from the last 3 hours

!top10recent

returns the top 10 users of the current channel from the last 24 hours

!recent

shows the 10 most recently active users of the current channel

!globalword <word>

returns how many times the word was used in all of the channels HoneyJar is on

!wordstat [nick]

returns some statistics for the user whose nick you specified
if you specify no nick it will return the statistics for yourself

!channellovers

returns an index of lines the 10 most active user-pairs of the channel exchanged
remember that the numbers given are not the exact number of lines the pair exchanged but only an index; higher numbers indicate more exchanged lines though

!socialnet

gives you a link to a graphics that shows a social network graph of the channel you are in
the nodes are the persons in the channel and the thickness of the connections between them shows how strong those people interact with each other

remind function

!remind <me/nick> on action <text>

reminds the person you specified the next time he joins or speaks
HoneyJar aliases are used and the reminder will only work in the channel it was added to

!remind <me/nick> in <minutes/hours> <m/h>

remind the person you specified when the minutes or hours you entered have passed
HoneyJar aliases are used and the reminder will only work in the channel it was added to
example: '!remind Jaran in 3 h hey Jaran, 3 hours have passed!'

commands for fun

!huggle <nick>

huggles the person you specified :-)

HoneyJar usage stats

!globalusage

shows how often commands have been used globally

!channelusage <channel>

shows how often commands have been used in the current or specified channel

!userusage <nick>

shows how often commands have been used by yourself or the specified person
HoneyJar aliases are used

commands for... no idea

!random <number>

gives you a random integer between 1 and <number>

!randomchain <number>

returns a randomly arranged sequence of unique numbers between 1 and <number>
only numbers between 1 and 20 are accepted

!ping

returns "pong" so that you can check if you are still connected to the network

other features

There is currently one feature that is not a command. Try writing a word and add two question marks and see what happens. Example: "HoneyJar??"
In addition to the above features, HoneyJar is conveniently capable of exterminating wasps.

Website

At HoneyJar Website you find an experimental website that can be used to retrieve some information mentioned above via a webinterface. Whereas most commands from above only return a limited set of information for not spamming the IRC channel the website will give you considerably more!

Opinions of Honeyjar users

Ethanol: it is the best bot everywhere!!!!!
Speh: HoneyJar = thesex.
#liev: HoneyJar <3

Wiki : HoneyJar