ServerWatch goes to IRC (and any Instant Messenger Network).

This is a really powerful feature in ServerWatch because it can connect you to a normal IRC Server or with the help of a gateway like http://bitlbee.org/ it can provide a way to let the ServerWatch bot be in any IM Network. Like MSN, ICQ, AIM, Jabber, Yahoo.

What a ServerWatch IRC BOT can do for you ?

It work like any other IRC bot. You can also read the stuff about the SWIM Bot below to get an idea whats up?
Set a irc server, a channel and a username. Fire it up.
The bot will show up in the channel and you can start to communicate with it.
You can download a sample IRC Trigger setup here:
http://serverwatch.daniel-rudolph.de/download/IRC.zip

What a ServerWatch Instant Messenger Bot (SWIM BOT) can do for you ?

Would it be cool to manage your gameserver from your favorite Instant Messenger like ICQ, MSN or whatever ?

That SWIM BOT can be used to control the Server and also to stay in contact with the users playing on it.

How that works?

A player in the Server can send a chat message "!needadmin". It then notifies all admins marked as admins that can handle such calls will get a message to there Instant messanger that somebody needs an admin on the gameserver.
The admin can accept the call by sending !accept to the SWIM BOT if he recieved a call.

What happens when that connection is created?

If the user writes something in the server, the admin will also see it in the Instant Messenger. The same for the user - if the admin writes something to the SWIM BOT, it is also sent, (it use's the COD tell function per default, that can be disabled).
The admin can close the session account by by sending !close to the SWIM BOT.

The SWIM BOT also can handle some more commands like !chat, and !rcon.

With !chat you open a general chat session with the server, all that you type is sent to the server, and all what the users type in the server, is send to you (the admin that opened the session). If you are done you can do a !closechat and that session stops.
The !rcon command can be used to send rcon commands to the server just with sending !rcon to the server.

ll this stuff needs privileges that can be set up different for every single user that can come from an Instant Messenger Network you are connected to.

You can download a sample trigger setup here (The triggers are used to provide features in the SWIM BOT - for example !help is included in that sample):

http://serverwatch.daniel-rudolph.de/download/IRC.zip

How can I use the IRC to connect to Instant Messengers ?

The (game) server provider http://www.eliott-ness.com is also running a BitlBee gateway at bitlbee.eliott-ness.com:6667 so you can use that if you want to connect to the IM stuff. How to get BitlBee work? Well that can be explained by BitlBee itself the best. So just take a normal IRC Client and connect to a BitlBee Server and the root Bot will help you to make it work. You can also use it straight forward in ServerWatch and use the Debug – IRC Window to setup the connections at the BitlBee Server.

A "short" example to make it work in ServerWatch:

Connect to the BitlBee Gateway

1. Enter a BitlBee Server ip and port (ip:bitlbee.eliott-ness.com port:6667 would do fine)
2. Remove the channel name from channel
3. Remove any channel key
4. Enter a nick you like and what is not used already by any other user at the BitlBee server you use.

Dont forget to unmark the SWIM BOT as disabled and reconnect.
If you enter the Debug – IRC window now you should see that you are in the channel #bitlbee click on it and then you can send messages to it.
At anytime you can send help top the #bitlbee channel and BitlBee will help you.

Create the account on the BitlBee Server to remember your settings

send register yourpass to the #bitlbee channel

How can i login into the BitlBee Server again and restore my remembered settings?

send identify yourpass to the #bitlbee channel

Create the account for the Instant Messangers you want to use

Now i want to explain how to make it work with a msn account. Notice that you can add several different IM Networks in the same connection so you’re SWIM BOT can be in every Network at the same time.
f you just send "help" to the channel you should see a list of commands BitlBee understands. I will now only list the commands that are necessary to add an msn account and make it connect.

1. add the account: account add msn yourhotmailaccount@email.domain yourpassword
2. bring it online: account on 0
3. add an admin that should be able to use the SWIM BOT: add 0 admin@email.domain admin1
   Where admin 1 will be the nickname you can see that person from now on.

Thats it if you now want to use the SWIM BOT from that account you have to add it to the userlist.

• NickName: admin1
• Ident: empty

Rights maybe chat and rcon – depends what you want..
Also mark "can handle admin calls" if you want to enable the !needadmin feature for that admin
Max trigger is used to use the possible Message Triggers this user can use. A user can only actiavte Message Triggers with a lower level then he have.

What can happen is that BitlBee will ask you in the #bitlbee channel if you allowed that somebody add the SWIM BOT his contact list - you can answer that with sending a yes as reply to the #bitlbee channel. You should do that with the admins else the SWIM BOT will not displayed as online user.

Bring it online

If you added your users you need to reconnect the msn account sometimes - because only after doint it the bot become visible to the added users (where you accepted the add request)

1. account 0 off
2. account 0 on

How to make ServerWatch connect to the BitlBee Server fully automatic?

As you need to send the identify with your password to the #bitlbee channel to login at the server. ServerWatch need to send that on the Start.
To make that work you can use the SendOnJoin list. Just enter #bitlbee as channel and as message you put in identify yourpass

What if i have more questions or i cant get it to work?

But reports: http://serverwatch.daniel-rudolph.de/bug
Forum: http://www.majorkillingforce.com


I hope that helped you to show you how BitlBee works and i would also like to that that opportunity to thx the guys from that project. That really make my life easier.

Now have fun with your ServerWatch Bot that can be in all Instant messenger networks.
Enforcer