IRC #HERP Help with the Herpbot
Dan Sanders
the #herp channel on irc.
Currently we have some pics of different animals, and some faq sheets.
Users are welcome to upload anything they think can be used or enjoyed by
others.
Everything You've Always Wanted to Know about Eggdrop*
(*but were afraid to ask)
COMPLETE USER MANUAL v1.1
Written by Jamie Rishaw<gavroche> al...@po.cwru.edu
Current to eggdrop v0.8m
Last updated 8 Jun 1994
TABLE OF CONTENTS
1. Introduction
2. Becoming Somebody
3. User Commands
4. DCC Commands
A. Return commands
B. Action commands
C. Channel commands
5. Internal Features
6. Files (DCC) area
7. Party Line
8. Telnet connections
<<< 1. INTRODUCTION >>>
Eggdrop is some new kick-ass code - It is a bot, written in C, which
in essence "Holds down the fort" of a channel, keeping illegal netsplit
riders out.. providing the standard bot features (ops, etc).. as well
as advanced features, such as E-Mail address logs, Join-Descriptions,
remote telnet access, even a multi-user DCC "Party Line". To date, I
have not seen a more complete, more packed-with-features bot, ever.
Eggdrop code was originally created before God, by Robey Pointer,
<rpo...@eng.clemson.edu>.
<<< 2. BECOMING SOMEBODY >>>
To do anything at all, you must "/MSG bot_name Hello". From that /MSG,
Eggdrop will "learn" and recognize you by your nickname and user@host.
After /MSGing bot_name Hello, the Help Bot will reply with something like
-BotHelp- Hi foo! I'm bot_name, an eggdrop bot.
-BotHelp- I'll recognize you by hostmast *!f...@bar.edu from now on.
..in addition, it will send you an "intro" file with a few commands.
It is STRONGLY advised that you immediately set a password (Anyone knows
that userids can be hacked.)
<<< 3. USER COMMANDS >>>
There are a few commands that can be issued by a user. To become a "user"
on Eggdrop, simply "/MSG bot_name Hello". He will recognize you by that
user@host address, and permit you to do a few things. Note, commands that
are marked with a * require you to have +op status.
- These commands are issued via /MSG.
PASS <password>
- Set your password. Do this immediately! /MSG bot_name pass new_password
INFO <your information>
- If enabled, displays a 1-line short description of you when you join.
IDENT <password>
- If you are logging in from a different user@host from when you originally
"Hello"'d him, IDENT will tell him that you are really you.
WHO
- Show a list of users in the channel, as well as any INFO they set.
*OP
- Give you channel ops
*INVITE
- Invites you to Eggdrop's current channel
<<< 4. DCC COMMANDS (Direct Mode) >>>
Most commands that are issued in Eggdrop must be issued in DCC CHAT.
All DCC Commands start with `.' -- Remember to include the .! =) If
you don't, Eggdrop will assume you are talking to the Party Line (discussed
later).
-< A. DCC RETURN COMMANDS >-
.quit
- Exits you from DCC Chat (closes DCC Socket and drops you from the Line).
.motd
- Re-Displays the MOTD. MOTD is automatically printed upon entering Chat.
.newpass xx
- Changes your password to xx.
.note x "Text to send"
- Files a note with user x. User will receive note immediately if s/he is
in DCC Chat; or, if user is not in Chat, note will be queued indefinitely.
User x must be recognized by eggdrop to be filed.
.files
- Enters the File Transfer area (if enabled). More on this later.
-< B. DCC ACTION COMMANDS >-
.say <Text>
- Tells Eggdrop to say to the channel <Text>
.msg x y
- Sends a /MSG to user x with text y
.me <Whatever>
- Makes Eggdrop to CTCP ACTION <Whatever>
-< C. DCC CHANNEL COMMANDS >-
(Commands listed assume that Eggdrop himself has channel op.)
.kick [nick]
- Kicks [nick] off the channel
.kickban [nick]
- Kicks and bans [nick].
.op | .deop [nick]
- <.op> Gives channel op (+o) to [nick].
- <.deop> Takes channel op away from [nick].
.bans | .resetbans | .+ban | .-ban
- <.bans> Shows you the ban-list.
- <.resetbans> Clears the ban-list so all that remains are internal perm-bans.
- <.+ban *!user@host> Bans user by pattern *!user@host
- <.-ban> Removes a ban. ".-ban 1" will remove ban#1 from permanent-ban list.
<<< 5. INTERNAL FEATURES >>>
There are many things which Eggdrop does automatically. Such include:
-Server Op
- If a user "rides in" the channel, obtaining a server op (the connecting
server propigates a +o mode), Eggdrop performs a check. If the check
fails, the user is deopped. If the user is set +friend, +op, or +master,
OR if the user had valid channel ops BEFORE s/he split off, they will not
be deopped.
-Floods
- If a user floods Eggdrop with /MSGs, NOTICEs, or CTCPs, his HOSTNAME will
be placed on ignore. (ALL users from that host will be ignored, unless they
are +master). Don't try flood-killing Eggdrop, either, because it won't
happen. Excess Flood is a client function. =)
- If a user floods the channel, s/he will be kicked. A flood is considered
to be *consecutive* messages within a certain time period.
-Revenge
- Be careful! Eggdrop code can be VERY nasty to you if it wants to. If
you have a server-op-deop script, it's strongly suggested that you
"Immunize" Eggdrop from being deopped or kicked. This also would apply
to mass-ban, mass-deop scripts that auto-kick or ban a user.
- If you deop the bot (and are not a +friend)..
- "First Offense":
- If you are +op, you are taken OFF of the +op list.
- If you are not on the +op list, you are placed on DEOP.
- "Second Offense":
- You are automatically placed on Deop list.
- The "Second Offense" can be remedied by having a bot +Master change
you back to +op, or by adding you +friend.
- If you kick Eggdrop off the channel and are not +friend, you are
placed on the Deop list regardless, and will not be allowed to hold
channel ops.
Note on Revenge: This can be enabled or disabled, depending on how sadistic
the bot "owner" feels that day.
<<< 6. FILES(DCC) AREA >>>
The DCC-Files area is the part of the bot which (duh) contains the file
listings, in a unix-like hierarchal tree. Commands issued are unix-ish
for the most part. Entering ".files" in DCC COMMAND mode will take you
to this area (you will leave the party line until you exit the files area.
Note that now that you are not on the Party Line, a "." is not necessary
when issuing commands.
.files (From DCC COMMAND mode)
- Takes you INTO the files mode.
ls
- Gives you a listing of the files and/or directories (if any) in the
current working dir.
pwd
- Prints the current working directory you are in.
cd x
- Changes the current working directory to x
get x
- Tells Eggdrop to DCC SEND you file x. File x must be in the current
working directory to be considered a valid request.
<<< 7. THE PARTY LINE! >>>
Perhaps the most fun feature of Eggdrop is his Party Line feature. This
feature is automatically enabled any time you enter DCC CHAT with Eggdrop.
It is in essence a channel within a channel - a "Subspace communication"
between you and your peers. Not only is this nice because you can talk
with a select group of people, but it bypasses server links, making your
conversation much faster than normal /MSGing. It also is immune from
being "cut off" in the middle of a conversation due to something lame like
a Netsplit.
To talk on the Party Line, simply type. No special prefixes are required.
(That is, type in a DMSG to Eggdrop).
.who
- Returns you a list of people currently in DCC Chat (On the Party Line).
A * next to the user's nickname indicates s/he is an Eggdrop Master.
.invite [nickname]
- Invites [nickname] to join you in the Party Line. Please note, however,
that even if you invite a user to the line, it doesn't necessarily mean
s/he is "cleared" to enter.
TANDEM -
If you are on a tandem network of bots, you may see people talking that look
like :
<user@BillBot> Hi, Bob.
That means, the user is on "BillBot" talking via a Tandem Link. His talking
goes to you, and your talking goes to him. Typing ".whom" will list all
people on the T-Net.
You can send a private note to user@BillBot if you wish, just like you send
a regular note. The difference: you type ".note user@BillBot Hi Joe." Or,
user@TrentBot. Or whatever.
<<< 8. TELNET CONNECTIONS >>>
At this time, we unfortunately do not have any Party Line or DCC Chat code
for users of VAXes, Macintoshes, HomerTCP, etc. But, this is Eggdrop,
not TBLameBot v3.93c. You can TELNET to the machine that the bot is on,
on the port specified by the Admin (Default port 2222, this may vary if
port 2222 is already taken, or if Admin specifies another port). Upon
connecting to the port, you will be sent Eggdrop nickname, version, and
"Identify yourself (nickname)." At this point, you type in your nickname
in which Eggdrop knows you. Next, you will be asked for your password.
Upon successful completion of "login", you will be automatically placed in
DCC COMMAND mode. You enter these commands just as if you were in DCC
Chat. This feature can be used by anyone with +op status. Cool, eh?
<<< 9. WHERE TO GO >>>
If you have any questions about Eggdrop code, feel free to send me e-mail
on it. I'm the voluntary scapegoat, to give Robey a little extra free time.
<I think I can field most questions on Eggdrop code.. :) >
If you find (GASP!) a bug or error in the code, mail either me, or Robey
directly. E-Mail addresses:
gavroche(me) Jamie Rishaw al...@cwru.edu
Robey Robey Pointer rpo...@eng.clemson.edu
--
__________________________________________
/ red...@best.com | Breeding select boa's \
\ | for fun and hopefully /
| | profit 8^) |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~