Eggdrop Installation

Installing Eggdrop

This tutorial will walk you through the installation and setup of Eggdrop on your shell. You will need an FTP program, a decompression program such as winRAR or Winzip, and a Telnet client. Putty is recommended as the preferred Telnet client. Links are included to freeware programs throughout this site.
NOTE: While notepad is acceptable to edit the Eggdrop config it is recommended you use an editor that supports scripts.

Installing Your Eggdrop Bot
  1. Download eggdrop1.8.1.tar.gz to your computer from the link provided.
  2. Decompress the eggdrop1.8.1.tar.gz
  3. Open the eggdrop.conf and edit carefully.
  4. Rename the eggdrop.conf to your chosen botnick.
  5. Using your FTP program upload eggdrop1.8.1.tar.gz to your shell.
  6. Telnet to your shell.
  7. In telnet type tar zxvf eggdrop1.8.1.tar.gz
  8. Type cd eggdrop1.8.1
  9. Type ./configure
  10. Type make config (which compiles all modules) or make iconfig (which allows you to select the modules to compile).
  11. Type make
  12. Type make install DEST=~./botdir (where botdir is the name you prefer for your bot directory.)
  13. Using your FTP program upload your edited eggdrop.conf to your new bot directory.
  14. Type ./eggdrop -m config file botnick.conf (where botnick.conf is the name you've given your eggdrop.conf.) The -m switch starts your bot in user file creation mode and is no longer necessary after initial installation.
Please Note: If you receive an error message using make or make install try gmake and gmake install.

Taking Control of Your Eggdrop Bot

After your bot has joined the channel you've set in your configuration file, you must message it and become Owner. This allows the bot to recognize you and allow you DCC chat access.

  1. If using your mIRC client type /msg botnick hello
  2. If using your telnet client type NEW
  3. You new bot will welcome you with, Hi i'm botnick, you are now the Owner of this bot. Next time you won't need to start in -m. Set a password.
  4. Follow the prompts to set a password with your bot. The bot will tell you the password is accepted.
    The syntax is /msg botnick pass yourchosenpassword.
  5. DCC Chat your bot to be sure it has accepted your password.
  6. In DCC Chat type .die, this will kill the bot.
  7. Return to your telnet client window and restart your bot normally using ./eggdrop botnick.conf
  8. When your bot returns to the channel, attempt another DCC Chat. If the bot doesn't respond it may not have remembered your password. Use the command above to again set your password.

Keeping Your Eggdrop Bot Online With Crontab

While most shell providers offer 99.9% uptime there will be times when your bot does not return to IRC. Creating a crontab, (which is a process that checks every 10 minutes to ensure your eggdrop is running) will ensure your bots online presence automatically.

  1. You will need to find your eggdrop path on the shell.
  2. Type pwd (The pwd command will tell you the eggdrop path.)
  3. Change to your Eggdrop directory using cd eggdrop. (where eggdrop is your bot directory name.)
  4. Type ./autobotchk botnick.conf -dir /home/login/botdirectory -noemail
  5. If you have more then one Eggdrop Bot running you must set a separate Crontab for each.