

                       The UNofficial Eggdrop Bot Faq
                       ------------------------------

	The EggDrop bot is Copyright 1994,1995 Robey Pointer

	Document By

		Guy Martin <guymart@netcom.com>
		Aka MiltryPet on ircII
		Aka Guy@OffBeat
		Operator of OffBeat (EggDrop Bot)

		Updated: Jan 28, 1994

		Updates available via anon ftp:

		ftp://ftp.netcom.com/pub/gu/gumart/eggdrop/eggdrop.faq
		ftp://ftp2.netcom.com/pub/gu/gumart/eggdrop/eggdrop.faq

-----------------------------------------------------------------------

                  Current Public Release Version of EggDrop

                                    0.9i

                                 Bug Fixes:

1) Fix in misc.c.  Caused last context 153, segment violations.

                                 Known bugs:

1) AIX/ Tcl Timers cause the bot to crash randomly.

-----------------------------------------------------------------------
                     Important information for everyone
                      concerning updates to the eggdrop
                           code and this document

Robey Pointer has declared that he will no longer release the code to
the eggdrop bot.  Robey may release one more version (0.9j).  Further
code modifications will be taken over by another party.  At this point
in time, it is unknown who will be doing so.

It is unknown if Robey will continue the eggdrop mailing list, and/or
give technical support for the software at this time.  Or even provide
bug fix information to the current version.

Robey has decided that he will continue development on his own eggdrop
(SnowBot), yet will not release the code.  Further development to the
'public' version of the eggdrop may not be technically compatible with
Robeys' SnowBot.

This document will support ONLY the public version of eggdrop.  SnowBot
or any other bot operating under Robeys personal code, will NOT be
supported.

	Known eggdrop bots NOT supported by this document:

	Snowbot		Robeys Personal Beta Bot
	NoBoty		This bot has been modified by Fred1 and
			and frequently performs incorrectly.

-----------------------------------------------------------------------

                              Requirements

      Except for the obvious [computer connected to the InterNet]
              An ircII client capable of DCC CHAT and LOAD

                                   or

                        telnet (better yet, tf)

-----------------------------------------------------------------------

                          "First things First"
                          --------------------

To use the bot via IRC:

	1. Get a copy of NTALK v2.0 for use with EggDrop bots.

		ftp ftp.netcom.com (or ftp2.netcom.com)

		/pub/gu/guymart/eggdrop/ntalk

-----------------------------------------------------------------------

                 These next steps are for when you are
                 going to connect with a different bot
                    on the BOT NET that you have not
                       previously connected with.

                  FIRST TIME CONNECTION TO A BOT ONLY!
                  ------------------------------------


0. Run your ircII client [usually irc].

1. Leave ALL channels you are on.  This makes it easier.

2. Find an EggDrop Bot on IRC.

	This list has shrunk due to many masters removing the ability
	to get on the bot unless you are a master.  They have decided 
	that the PartyLine is an elite 'channel'.

	Some common EggDrop bots are:

	KillerM		OffBeat		Gambot
	Stonewall	QRDSrv

3. Introduce yourself to the bot.

	/Msg <bot> Hello

   The bot should reply back with a greeting meaning the bot recognizes
   you and a simple help screen.

	If the bot does not reply:

	1) The operator of the bot has removed the ability to learn
	   new users.  In this case, there is nothing that can be done.

	2) The bot is severly lagged.  Try later.

	3) Goodness only knows why.

4. Create a password for your account.  (Passwords are required for
   accounts that will be accessed via telnet/tf.

	/Msg <bot> pass <my.password>

-----------------------------------------------------------------------

                     The next set of steps are used
                     in daily actions to connect to
                     any EggDrop bot that you have
                          connected to before.


Using IRC:

5. Load the NTALK script for easier use of EggDrop bots.

	 Warning: You may have got your NTALK script from another
		  location. This is ok, but be sure you understand
		  what it does before using the /Load command.

	/Load ntalk

	You should get a message similar to "*** NTALK v2 loaded"

6. Now you need to make the actual connection to the bot [and therefore
   the BOT NET].  To do so, you will use the NTALK script.

	/ntalk <bot>

	It should connect up in a new window on your screen.  It may
	take a few moments for the connection to actually occur (1-60
	seconds).

7. Enter your password.



	q: /Lastlog doesn't work well with IRC's DCC CHAT command.

	a: /Set Lastlog_Level ALL,DCC
		Will allow you to use /Lastlog on the Eggdrop channels.

-----------------------------------------------------------------------

Using telnet:  (Note: Telnet sessions with the bot are not pretty)

                               Prerequisites:

		Requires you to have a password on the bot.

		BEFORE you can use telnet/tf you will need to know
		two things.

		1) The address to the bot (Visible in the
		   /whois <bot>)

		2) The port of the bot.  You'll need to ask
		   someone on the botnet (via IRC method).


5. At your unix/vms prompt, type:

		telnet <address> <port>

		For OffBeat: telnet acs3.bu.edu 1987

6. Enter the nickname that you used when you /MSG <bot> Hello

7. Enter your password.

-----------------------------------------------------------------------

Using tf (TinyFigue):  (This is a NICE client, support color!)

                               Prerequisites:

		Requires you to have a password on the bot.

		BEFORE you can use telnet/tf you will need to know
		two things.

		1) The address to the bot (Visible in the
		   /whois <bot>)

		2) The port of the bot.  You'll need to ask
		   someone on the botnet (via IRC method).


5. At your unix prompt, type:

		tf

6. Enter:

                /telnet <address> <port>

7. Enter the nickname that you used when you /MSG <bot> Hello.

8. Enter your password.


Some helpful comments on using tf with eggdrop:

	If you get a "MORE" prompt, press TAB to continue.

	Get .tfrc from the anon ftp listed above.  It's got the
	neccesary configurations for eggdrop.

-----------------------------------------------------------------------

                  You are now on the EggDrop BOT NET.

-----------------------------------------------------------------------

                     Frequently Used Commands (FUC)
                     ------------------------------

.help
	Provides a listing of available commands (on MOST bots).

.help <command>
	Provides specific help on a command.

	Note: The help system is old.  Some of the things may not work
		like they state in the help system.  This document does
		not cover all of the commands.  Only those used most
		often.

-----------------------------------------------------------------------
EggDrop Bot Command       | Notes | Irc Command Equivalent
--------------------------+-------+------------------------------------
.away <reason>            |See #1 | /away <reason>
.bots                     |       | /links
.bottree                  |See  2 | /links
.files                    |See  3 |
.me <action>              |       | /me <action>
.motd <bot>               |       | /motd
.nick <newnick>           |       | /nick <newnick>
.note <nick>[@bot] <text> |See  4 | /msg <nick> <text>
.notes read|list|erase    |See  5 |
.quit                     |See  6 | /quit
.who <bot>                |See  7 | /who #<channel>
.whois <nick>             |See  8 | /whois <nick>
.whom                     |See  9 | /who *
--------------------------+-------+------------------------------------
.chat On|Off|#####        |See 10 | 
-----------------------------------------------------------------------

     Notes:

1.   The away works the same as with irc, except ONE thing.  If you type
     a public or private note, the away status will be removed.

2.   BotTree allows you to see the topology of the bots.  In other
     words, which bot connects to which other bot(s).

3.   Files provide a way of allowing you access to dcc download new
     files.  Such as updates to NTALK, User Gifs, Documents, executable
     programs.  Some bots do not provide this service.

4.   If the person you wish to send a note to is on a different bot
     [designated by user@bot] the note command changes slightly:

        .note <nick@bot> <text>

5.   .Notes allows you to list/read/erase notes that you were sent
     while not online to the bot, ethier physically or via .away.
     This command is only valid on eggdrops 0.9g/h/i.

6.   The .QUIT command does not quit irc, but disconnects you from the
     bot net only.

7.   Who only display who is attached to the bot you are currently
     attached to.  Default bot is the bot you are attached to.
     Otherwise, you need to provide a botname.

        .who		Who is on the bot you are connected to.
        .who botie	Who is on botie only.

8.   (This command requires you to be an op or master)

     The whois command shows the following information:

HANDLE    HOSTMASK(S)                             PASS      ATTR      LAST
Guy       *!guymart@192.100.81.*                  (yes)     omfxp     08:56
          *!guymart@*.netcom.com
          INFO: Guy / San Diego, Gif, OffBeats Owner

	Some of this information may not be active for all users.
	All users have a HANDLE.  This may or may not be the same
	as their handle on irc.

	ATTR is the attributes that user/bot has.  I will state the
	most used.

	[Users]

	x = Xfer	(Access to the .files section)
	p = Party	(Access to the PartyLine)
	o = Operator	(ChanOps given to the user by the bot)
	f = Friend	(No Revenge taken against this user)
	m = Master	(A demi god, runs the bot)

	[Bots]

	t = TandemBot	(Another bot)
	r = Reject	(Rejects the bot from connecting to the botnet)
	s = Share	(Shares the userlist with other bots)
	l = Leaf	(Only allowed to have ONE connection
			 the the net)

	INFO is the line displayed to the channel when the user joins.
	EMAIL is the users email address.
	COMMENT would be a comment about the account (Masters only)

9.   The whom command shows the following information:

     Nick        Bot        Host
      ---------  ------------------------------
     *Guy        OffBeat    telnet from netcom19.netcom.com
     *Fred1      Stonewall  egg@speedway.net [AWAY] [idle]
     @answer     Vasha      fun@tiac.net [idle]
      Shantar    Gambot     simple@McGill.CA

     *MiltryPet  Calvin     guymart@netcom.com [AWAY] [IDLE]
     ----------  ------     ------------------ ------ ------
    [1]  [2]       [3]             [4]           [5]    [6]


	1. This small symbol, either blank, @ or * represents that
	   users access level to the bot.

		Blank : Just a normal user.
		@     : An Operator
		*     : A Master

	2. This is the users nickname.

	3. This is the bot that the user is connected to.
 
	4. This the the users login@domain address.  It may also say
	   the user is attached via TELNET.

	5. [AWAY] means that the user has set his .away msg and is
	   now storing notes sent to him or her [automatically done by
	   the bot].

	6. [idle] means the user has not typed anything publicly or in
	   private in over 5 minutes (Approximately).

10. The .CHAT command is available only in eggdrop 0.9i or higher.
    The .CHAT ##### is available only in eggdrop 0.9i(b) or higher.

    ON|OFF
	It allows a user to remain online to the bot, yet not appear
	in the .whom listing (Yet will appear in a .who botnick).
	While a user is .Chat off they can not see any partyline
	chatter, yet they can send and receive .notes.

    #####
	It allows you to effective join channel #####.  Channels are
	1-99,999.  The partyline is 0.

-----------------------------------------------------------------------

Information on getting the EggList:


Just so everyone knows, the correct address to send subscribe/unsubscribe
requests is:

   TO: eggdrop-request@wc130.residence.gatech.edu
 Subj: Whatever...
 Text: subscribe eggdrop

(This may or may not work, I've got to find out the correct Text)

-----------------------------------------------------------------------

How to get the EggDrop code:

Currently, EggDrop compiles on:

	SUN/OS	(Talk to Guy/MiltryPet)
	Linux
	BSD
	AIX	(Sorta, talk to Guy/MiltryPet, or Tolim)
	SRV4	(Maybe, talk to Knight__ / VERY BETA)
	SunOS 5	(Maybe, talk to Knight__ / VERY BETA)

To get the code via automatic transfer, at your unix prompt, type:

        telnet maverick.math.uic.edu 1994 | sh

and follow the simple directions.

Attempt to compile with TCL support, it's worth it, and not too
difficult.  If you can't compile due to disk space limitations,
try to compile from the /tmp directory on your system.

-----------------------------------------------------------------------

                     (Further Construction Coming!)

-----------------------------------------------------------------------

Looking for interesting (tcl) scripts for a library, send them to:
Questions, answers, comments, additional info:

        Email: guymart@netcom.com
               guy_martin@f905.n202.z1.fidonet.org

                                 -eof-
