What is VDS?

ISPmanager control panel

Documentation

Software packages for VDS

FAQ

>> Installing Eggdrop Bot for FreeBSD and Linux

- Installing Eggdrop for FreeBSD

- Installing Eggdrop for Debian Linux

Eggdrop is the world's most popular Open Source IRC bot. One of the features that makes Eggdrop stand out from other bots is module and Tcl scripting support. With scripts and modules, you can make the bot preform almost any task you want.

Installing Eggdrop for FreeBSD (via ports system)

Run the below commands:

# cd /usr/ports/irc/eggdrop/
# make install clean

Leave the default options as set in the config file.

After a successful compilation, we should start to configure the bot.

Copy the config file:

# cp /usr/local/etc/eggdrop.conf.sample /usr/local/etc/eggdrop.conf

Edit your configuration file /usr/local/etc/eggdrop.conf by changing the options:

Set the ident of the eggdrop:

set username "lamest"

This line is for information purposes only.

set admin "Lamer lamer@lamest.lame.org

This is what you use to specify your bot's nickname:

set nick "Lamestbot"

You should specify multiple servers in this list, in case the bot is unable to connect to the first server. The format for this list is shown below:

set servers {
  you.need.to.change.this:6667
  another.example.com:7000:password
}

Shortly after this will be the line to set where to store information about known users:

set userfile "LamestBot.user"

The exact location of your file is /usr/local/share/eggdrop

Scrolling far down once again you will eventually find the line that says where Eggdrop will store information about channels it goes in:

set chanfile "LamestBot.chan"

The following line needs to be either commented out or deleted to allow Eggdrop to run:

die "Please make sure you edit your config file completely."

Comment out or delete this line, too:

die "You didn't edit your config file completely like you were told, did you?"

set here the port where eggdrop should listen:

listen 3333 all

After this is another die line that needs commenting out or deleting. A little after this is a commented line to choose what method of encryption you'd like to use on the passwords stored in the user file. Since blowfish is pretty much the only option available at the moment, you're pretty safe to just uncomment this line; Eggdrop will not start unless you do:

loadmodule blowfish

Create user eggdrop (DO NOT run the eggdrop as root), by the command adduser, or through the ISPmanager.

Change the permissions to the directory /usr/local/share/eggdrop

# chown eggdrop /usr/local/share/eggdrop

Log into the system with eggdrop user login name.

That pretty much concludes the minimum editing that needs to be done to eggdrop.conf in order for it to work properly.
Save it, exit your text editor and type in the following:

% eggdrop -m

Eggdrop v1.6.18 (C) 1997 Robey Pointer (C) 2006 Eggheads
[08:54] --- Loading eggdrop v1.6.18 (Thu Jan 3 2008)
[08:54] Listening at telnet port 3333 (all).
[08:54] Module loaded: dns
[08:54] Module loaded: channels
[08:54] Module loaded: server
[08:54] Module loaded: ctcp
[08:54] Module loaded: irc
[08:54] Module loaded: notes (with lang support)
[08:54] Module loaded: console (with lang support)
[08:54] Module loaded: blowfish
[08:54] Module loaded: uptime
[08:54] Userinfo TCL v1.07 loaded (URL BF GF IRL EMAIL DOB PHONE ICQ).
[08:54] use '.help userinfo' for commands.
STARTING BOT IN USERFILE CREATION MODE.
Telnet to the bot and enter 'NEW' as your nickname.
OR go to IRC and type: /msg Lamestbotibdsds hello
This will make the bot recognize you as the master.

[08:54] === Lamestbot: 0 channels, 0 users.
Launched into the background (pid: 27194)

Now you need to identify to your new bot. Create an andministrator of your bot and telnet to the bot on the port you picked (3333)

% telnet localhost 3333
Trying ::1...
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Lamestbot (Eggdrop v1.6.18 (C) 1997 Robey Pointer (C) 2006 Eggheads)

Please enter your nickname.
NEW

and enter NEW when asked for your name (administrator's name and password):

This is the telnet interface to Lamestbot, an eggdrop bot.
Don't abuse it, and it will be open for all your friends, too.
You now get to pick a nick to use on the bot,
and a password so nobody else can pretend to be you.
Please remember both!
Enter the nickname you would like to use.
admin
*** POOF! ***
You are now a master on this bot.
### POOF! ###
You are now a botnet master on this bot.
@@@ POOF! @@@
You are now an OWNER of this bot.

>YOU ARE THE MASTER/OWNER ON THIS BOT NOW
From now on, you don't need to use the -m option to start the bot.
Enjoy !!
Okay, now choose and enter a password:
(Only the first 15 letters are significant.)
password

Remember that! You'll need it next time you log in.
You now have an account on Lamestbot...


Connected to Lamestbot, running eggdrop v1.6.18
  ____ __
  / __/___ _ ___ _ ___/ /____ ___ ___
  / _/ / _ `// _ `// _ // __// _ \ / _ \
  /___/ \_, / \_, / \_,_//_/ \___// .__/
  /___/ /___/ /_/
 
Hey admin! My name is Lamestbot and I am running eggdrop v1.6.18, on FreeBSD 6.2-STABLE.
 
Local time is now 08:57
You are an owner of this bot. Only +n users can see this! For more info,
see .help set motd. Please edit the motd file in your bot's 'text'
directory.
Use .help for basic help.
Use .help all to get a full command list.
Use .help *somestring* to list any help texts containing "somestring".
 
Have fun.
 
Commands start with '.' (like '.quit' or '.help')
Everything else goes out to the party line

Stop your bot:

% killall eggdrop

and start again without using the keys:

% eggdrop

To find out what a command does, pick telnet port and use ".help " - for example, ".help channel".

Crontab is used to automatically restart the bot if the shell it's on reboots or if the bot process is killed for some other reason. You can add the task through the ISPmanager Control Panel:

% crontab -e
@reboot /usr/local/bin/eggdrop

That is all for this tutorial. You should now have a working bot that is on IRC and in the channel of your choice. You should be able to log into the partyline and the bot should recognise you as its master.

table of content | on top

Installing Eggdrop for Debian Linux (debian-4.0-mimimal)

Since we have eggdrop in the system repository, we used the apt-get package manager.

Use the line as given below for apt-cache update:

# apt-get update

This command will install eggdrop:

# apt-get install eggdrop

If you want to install telnet server package you can also use the following command:

# apt-get install telnet

Set master of the bot:

# adduser eggdrop

Log into the system with eggdrop master login name.

Extract the sample configuration file and copy it into the user home directory:

$ cd /home/eggdrop/
$ gunzip -c /usr/share/doc/eggdrop-data/examples/eggdrop.conf.gz > eggdrop.conf

Edit the config file as described in the tutorial for FreeBSD.

Now that you've compiled, installed, and configured Eggdrop, it's time to start it up. Switch to the directory to which you installed the bot and type $ eggdrop -m. Eggdrop should start up, and the bot should appear on IRC within a few minutes.

$ eggdrop –m

Connect to the telnet partyline:

$ telnet localhost 3333

Configure the bot by following the same steps, which are described in this in tutorial for FreeBSD.

After configuration, do a bit of initialization work. As a result the files .user and .chan will appear in /home/eggdrop/.

In the event our server reboots, or some other technical problem occurs, crontab will restart your eggdrop bot:

$ crontab -e

Add the line:

@reboot cd /home/eggdrop && eggdrop

Enjoy!

table of content | on top