Go to file
raylu f89b33a593 Remove debugging print 2011-04-20 01:41:17 -04:00
client Add github link to CTCP VERSION reply 2011-03-09 16:05:19 -06:00
goconfig@eac52d647e Update README.md and goconfig's README.mkd 2011-01-24 17:32:58 -05:00
.gitignore !add, !flags, !topic 2010-10-16 15:38:40 -04:00
.gitmodules Use new forked goconfig as a submodule 2011-01-24 17:27:13 -05:00
Makefile Make the makefile make 2011-04-10 20:46:47 -04:00
README.md Make it so one command builds everything 2011-04-09 00:52:28 -04:00
auth.conf.example Fix example owner 2011-04-09 00:52:10 -04:00
auth.go Add ignores 2011-02-04 17:21:01 -05:00
cmd-access.go Add ignore information to accesslist 2011-02-04 17:26:08 -05:00
cmd-admin.go Update rbot for the new goirc layout 2010-12-18 18:45:02 -08:00
cmd-google.go Remove debugging print 2011-04-20 01:41:17 -04:00
cmd-op.go Fix (lack of) access requirement for !ops 2011-04-11 16:25:07 -04:00
handler.go Handle youtube links only after consider commands 2011-04-10 21:37:14 -04:00
rbot.conf.example identd support 2011-03-09 23:47:07 -06:00
rbot.go identd support 2011-03-09 23:47:07 -06:00

README.md

rbot

Getting started

Assuming you have go set up (http://golang.org/),

git clone git://github.com/raylu/rbot.git
cd rbot
git submodule init
git submodule update
gomake

rbot.conf and auth.conf will be copied. Configure those and then run the bot:

./rbot

Flags

Access is configured in auth.conf, is per-channel, based on ident and host; nick is ignored. The owner is configured per server and other access is configured per channel. Owners can use any commands. Ignores are checked before access.

The following is a description of the commands enabled by each flag:

  • a: add remove ignore unignore
  • o: op halfop deop dehalfop kick|k ban|b unban|u kb
  • h: halfop|hop dehalfop|dehop kick|k ban|b unban|u kb (hop and dehop can only be used on yourself and you cannot kick or kb people with o or h)
  • v: voice, devoice
  • t: topic appendtopic
  • s: say

In addition, a user must have at least one flag to use flags and list (so users without access can't spam the bot).

Commands

All commands are prefixed with the trigger configured in rbot.conf.

Access related commands:

  • flags raylu: get's raylu's flags
  • flags: get's your flags
  • add raylu t: gives raylu the t flag
  • remove raylu t: removes the t flag from raylu
  • remove raylu: removes all of raylu's flags
  • ignore raylu: ignores all messages from raylu's host on this network
  • unignore raylu: unignore raylu
  • list: lists all users and their access
  • list raylu: searches the access list for raylu

Admin commands:

  • nick john: changes the bot's nick to john
  • say text: says text to the channel

Op commands:

  • halfop|hop: halfop yourself
  • halfop|hop raylu john: halfop raylu and john
  • op: op yourself
  • op raylu john: op raylu and john
  • deop: deop yourself
  • deop raylu john: deop raylu and john
  • dehalfop: dehalfop yourself
  • dehalfop|dehop raylu john: dehalfop raylu and john
  • voice: voice yourself
  • voice raylu john: voice raylu and john
  • devoice: devoice yourself
  • devoice raylu john: devoice raylu and john
  • kick|k raylu: kick raylu
  • ban|b raylu john!*@*: ban raylu by hostname and john by nick
  • unban|u raylu john!*@*: unban raylu by hostname and john by nick
  • kb raylu: kick raylu, then ban him by hostname
  • topic text: sets the topic and basetopic to text
  • topic: gets the current basetopic
  • appendtopic text: if the topic does not starts with basetopic, sets the basetopic to the current topic. Makes the topic basetopic+text.
  • part: leaves the channel

Google API commands:

  • tr text: detect the language of text
  • tr en|ja en|es text: translate text into Japanese and Spanish
  • roman text: translate text into romaji (see rbot.conf.example)
  • calc 1 usd in yen: convert 1 USD to Japanese yen

Commands that don't require access behave the same when sent to a channel the bot is in and when whispered to the bot.

Commands that require access are listed above as if they were sent to a channel. When sent as a whisper, the first argument must be a channel name.

The bot will accept invites from the owner to any channel and only the owner can use part.

Miscellaneous

This project was forked from jessta/goirc which is in turn forked from fluffle/goirc. Both of those projects are focused on developing the goirc framework whereas this is focused on developing a bot.