Forums » Community Projects

Guild IRC Relay Bot

Jul 17, 2010 slime73 link
Relay Version 1.0

I've been working on this for a while now. It's a fully functional Guild chat <-> IRC relay, with some extra features.

/relay brings up the interface.
/relay toggle toggles it on or off (set it up in the interface before doing this)

There are several things which need to be set before it can run (all are found in the interface):
Username - The username your bot will have
Nickname - Its nickname (IRC name)
Nickserv Password - You need this if the nickname is registered
Server - irc.slashnet.org by default - I have not tested other servers
Guild Acronym - It will try to set it by default - change it if it's wrong
Channel Relay Channel - Your desired [100] relay (only if you have the toggle on)

There are also several toggle options to specify what information you want to relay:
Sector Chat - Relay chat from the bot's sector. IRC commands: !sector or /s. !listsector lists the people in-sector.
System Chat - Relay chat from the bot's system (warning: displays location). IRC commands: !system or !sys
Group Chat - Relay chat from the bot's group. IRC commands: !group or !g
Channel Chat - Relay chat to/from the bot's active channel. You need to set channel relay channel. It will relay from the IRC channel with !message
Debug Print - Display all incoming lines from IRC on the bot's client. Can get spammy.
Bank Updates - Relay bank information to IRC via the !bank command. Also relays deposits and withdrawals.
MOTD Command - Enable/disable the use of !motd from IRC to display the Guild MOTD
Relay All IRC Chat - When disabled, only relay IRC chat to your guild which starts with "!". Disabled by default.
Relay All Guild Chat - When disabled, only relay Guild chat to IRC which starts with "!". When enabled, guild messages starting with "!" will not be relayed. Enabled by default.
Format as [#chan] instead of [irc] - Useful if the bot is relaying to Guild chat from multiple channels. Changes the guild output to show the channel.

You will need to set the channel(s) you wish to relay from (not the channel chat channel). Add a channel by entering it into the text field and clicking "Add Channel".
Only add multiple channels if you wish to relay Guild chat to those channels.

You can also add IRC Admins who are able to execute arbitrary Lua code in the bot's client, from within IRC. Add the IRC nickname(s) of the admin(s) you want by entering their names in the text field and clicking "Add Admin".
To execute code as an admin, message the Relay bot from within IRC with the message remote <lua code>
For example, /msg relaybot remote print("hello world")

I have set up a very simple process for adding your own !commands to the relay. The code you wish to use does not have to be in this plugin. See the relay.lua file for more details.

Note: If you have set a NickServ password and your nickname is in use, the relay will attempt to automatically NickServ Ghost the nickname with the NickServ password and set its nickname to the desired one.

 

Please post any suggestions or bugs you might have.
Jul 23, 2010 look... no hands link
Oh I have a suggestion.

ACTUALLY PLAY THE DAMN GAME!!!
Jul 23, 2010 slime73 link
I bet my time logged in in the past 3 weeks beats yours (as long as you don't include the time all your alts are online at once).
Jul 24, 2010 tarenty link
He has been on quite a bit, slime. You've been semi-afk in VO mostly.
Jul 24, 2010 slime73 link
No I haven't. :)
Jul 24, 2010 tarenty link
You haven't seemed very active when you are on. Sitting in D-14 or Latos N-2 isn't active, by the way.