DCC COMMANDS for Eggdrop Bots

Speed links
For Flags see : whois
  Console
Channel conf : chaninfo
   
For All PartyLine Ops
act addlog away back bf biteme
botinfo bots bottree channel chat chinfo
console dob echo email flagnote gf
info invite irl match me motd
msg newpass nick note notes page
quit say seen store strip su
topic trace url who whois whom
For Master Ops
adduser banner bans +ban -ban binds
chaninfo chattr chbf chdob chemail chgf
chirl churl comment common dccstat debug
deop deluser fwd +ignore -ingore ignores
kick kickban op rehash reload reset
resetbans restart save servers status stick
unstick +user -user userinfo ©1999 Thicks _-_ 06/99

 

For Bot Masters
!addtopic assoc banip boot +bot -bot chaddr chnick chpass +chrec
-chrec disableban dump +host -host jump link relay subops unlink
For Bot Owners
botattr cancel cd +chan -chan chanload chansave chanset
cp desc die files filestats fixcodes flush get
hide ln loadmod ls lsa mkdir module modules
mv pending pwd quit rehelp rm rmdir set
share simul sort stats unhide unloadmod unshare
Bot Modules
assoc Console
ctcp Notes
Seen Server
Share Transfer
 
Set Commands - Bot Configuration Variables
admin allow-dk-cmds allow-fwd allow-resync altnick answer-ctcp
ban-time botname botnick bot's nick check-stoned connect-timeout
console-autosave console copy-to-tmp ctcp-finger ctcp-userinfo ctcp-version
dcc-block dcc-flood-thr default-flags default-port die-on-sighup die-on-sigterm
enable-simul flood-ctcp flood-msg force-channel help-path hourly-updates
ident-timeout ignore-time info-party init-server keep-all-logs keep-nick
log-time lowercase-ctcp max-dcc max-dloads max-logs max-notes
max-queue-msg mod-path motd my-hostname my-ip nat-ip
network never-give-up note-life notefile notify-newusers open-telnets
owner private-global private-globals private-owner protect-telnet quiet-reject
realname remote-boots require-p resync-time save-users-at server
server-cycle-wait server-online server-timeout serverror-quit servers list servlimit
share-unlinks strict-host strict-servernames switch-logfiles-at telnet-flood temp-path
trigger-on-ignore uptime use-silence userfile username version
whois-fields xfer-timeout Possibly more help by: .help set <variable>
  • All commands begin with . and all else goes to the party line.
  • Command Format is: .Command <Variable> [Optional]
  • Text starting with a , is sent ONLY to bot-masters.
  • You can get help on individual commands:   .help <command>
  • Extra help relating to loaded modules may be obtained by typing:    .help <module> module

    !addtopic <#channel> <topic string>

    Adds a topic to the rotation of topics in Channel. Can sometimes be done with a msg to the bot.

    See Also:  topic
    Return to Index


    act [channel] <text>

    Performs an action on the current console channel (or otherwise specified channel), as if the bot did it. Just like the /me command in IRC.

    See Also:  console
    Return to Index


    addlog <text>

    Writes your comment into the bot's log file. Bot masters can go back later and review the log, and will see your comment (with your handle attached). This is useful for explaining confusing activity.
    Return to Index

    adduser <nickname> [handle]

    Creates a new user record for a user on the channel, using their current hostname. It's similar to a user msg'ing the bot 'hello' except that no information is sent to that user. If the bot already knows someone by that nickname, and the user on the channel doesn't have a bot record, then it does the equivalent of an ident for that user -- except that, again, no information is sent to the user telling them that anything was done.

    If the user is using a different nickname than the bot normally knows her by, you can specify her "handle" (the nickname that the bot remembers).

    See Also:  +host -host +user -user
    Return to Index


    assoc

    Displays a list of current botnet channel names.

    assoc <channel #> <name>
    Creates a name for a channel. The name will propagate across your botnet (if you're hooked into one) and can be used instead of the channel # when changing chat channels (see chat). If you omit the channel # and name, it will just dump a list of the current named channels.

    assoc <*channel #> <name>
    Creates a name for a local channel. These channels are local to the bot itself.

    assoc <[*]channel #>
    Wipes out the name for a channel, if there was one.
    Return to Index


    away [away-message]

    Marks you as "away" on the party line. Your away message will show up in the .who list, and will be displayed to anyone who tries to send you a note. Your notes will be stored, and then displayed to you as soon as you are no longer away. Saying something on the party line will automatically remove your "away" status, or you can type .back or .away by itself.
    Return to Index

    +ban <hostmask> [channel] [comment]

    Adds a ban to the list of permanent bans stored on the bot, with an optional comment. This ban will be in effect for every channel on the bot if no channel is supplied, and is stored with your nickname and comment. Prefixing a comment with @ will make it only visible within the bot.

    See Also:  bans -ban stick unstick
    Return to Index


    -ban <hostmask OR number>

    Removes the ban from the list of permanent bans stored on the bot -- you may reference the ban by the number shown in .bans .

    See Also:  bans +ban stick unstick
    Return to Index


    banip <nick> [reason]

    Will do a channel ban of the ip address of the nick chosen. Please give a rease, even tho it is an optional part of the command.
    Return to Index

    banner <text>

    Displays a message to everyone currently using the bot's party line or file area -- useful for announcing that the bot will go down, etc.
    Return to Index

    bans [[channel] wildcard]

    Shows you a list of the global bans active on the current channel, and the list of channel-specific bans, as well as any bans that are on the channel but weren't placed by the bot. Here's a sample entry;
           [ 5] *!*habib@*frys.com (perm)
                paulie: revolving check policy
                Created 15:10 
    The number (5) can be used to reference the ban if you wish to remove it (see .-ban). Next is the actual hostmask being banned. The (perm) means that the ban is "permanent": that is, it doesn't automatically expire. If there is an elapsed time showing instead, the time displayed is how long the ban has been active. Those kind of bans expire after one hour. The second line of the ban entry is the comment ("revolving check policy" -- it would seem that paulie had to stand in line for a while) and who put the ban there (paulie). The last line shows when the ban was added, and possibly the last time the ban was activated on the channel (if it's different from the creation time).

    Sometimes there will be a ! or * right before the number. A ! means the ban is in the bot's permban list, but is not currently on the channel. A * marks a ban which is NOT in the permban list but IS on the channel.

    bans all
    If you use bans it will show you only the bans which are currently in action on the channel. If you use bans all it will show you every ban in memory (with 'perm-bans' on, these are identical).

    bans <wildcard>
    If you use bans <wildcard> it will list all the bans (active or not) that match against your wildcard. Consider it a bans all list matched against your wildcard.

    The ban list may change according to which channel you're currently viewing in the console. Different bans may be active on different channels. If you specify a channel name, that channel will be used instead of your current console channel.

    See Also:  -ban +ban console stick unstick ,   set ban-time
    Return to Index


    binds [type]

    Shows the Tcl bindings in effect, in a list similar to this:
         Command bindings:
         TYPE FLGS COMMAND      HITS BINDING (TCL)
         msg  -|-  rose            0 msg_rose
         msg  -|-  go              0 msg_go
         dcc  m|-  bind            0 cmd_bind
         pub  -|-  gross           0 pub_gross 
    The fields should be self-explanatory, except for HITS, which records the number of times that binding has been called. If not, go read the file 'tcl-commands.doc' for help on the Tcl bind command. Note that the builtin commands are now shown. You may also specify a type of binding to show (ie, .binds msg) if you want to narrow the field a bit.

    binds [type] all
    Displays all the Tcl bindings of every type (or the specified type), including the bindings for built in commands such as:

         msg  -    op                   *msg:op 
    Return to Index

    back

    This marks you un-away on the party line.
    Return to Index

    bf [boyfriend]

    Sets your boyfriend. This data isn't really used by the bot, but it will show up if someone does a whois on you. It's also used by the seen script. If you don't specify an address, the bot will show you the boyfriend entry it currently has for you (if any).

    bf none         Clears your boyfriend.
    Return to Index


    biteme

    Will display to any channel that the bot is on an offer to All Users an advertisement of the willingness of the Op's desire to have theirs private parts consumed or otherwise oraly gratified. The only message back from the bot that you will get is: What? You need .help

    This command should ONLY be used in cases of complete frustration due to a lack compatable partners.... OR after the bars are closed on a weekend night.
    Return to Index


    boot <nickname> [reason]

    Will kick a user off the party line, and display the reason if you give one. You can attempt to boot someone from another bot (boot <nick@bot> [reason] as in a botnet), though it may be rejected if that bot does not allow remote boots. You can not boot the bot's owner.
    Return to Index

    +bot <bot> <address:botport#[/userport#]> [hostmask]

    Creates a user record for a new bot with the nickname given. The hostmask table will have one entry, either that specified, a host from a current user with the given nick, or "none", and the bot b flag will be set for the user. The internet address field of the user will also be set to the address given. You can use this command and chpass to completely set up a record for a future bot, or you can let the two bots negotiate a password for themselves the first time they link. If the bot has a seperate port for bots and users they should be seperated with a slash (/).
    Return to Index

    -bot <bot>

    Exactly the same as -user', but is included for convenience. It erases a user record.

    See Also: +bot, +user, -user
    Return to Index


    botattr <nickname> [attributes] [channel]

    Lets you view and change the attributes (flags) field for a bot.
    Example:
                Sets Fred1 +share and -hub.
                    .botattr Fred1 +s-h
    Whether or not you change any flags, it will show you the bot's attributes afterwards. To get a full list of all the possible flags, do 'help whois'.
             Bot Flags:
    
               s   share (bot is sharing user records, aggressively)
               p   share (bot is sharing user records, passively)
               g   global share (share all channels)
               h   hub (bot is auto-linked at highest priority)
               a   alternate (bot is auto-linked if no hub bots can be linked)
               l   leaf (bot is not allowed to link in other bots)
               r   reject (bot will not be allowed on the net)
               i   isolate (isolate the party line across a botlink)
                   (plus 10 user-defined flags, 0-9)
    
       Bots may also have +s (share) settings for individual channels
       For Masters, if there is a comment, you will see it under "COMMENT:"
    

    Note: This command is NOT used to replace .chattr, it modifies botflags such as +s, +h, +a, +u... bot specific flags only.
    Note: You can't use this command on bots which are directly linked to your bot at the current moment.
    Return to Index


    botinfo

    Requests information from every bot currently in the botnet. Each bot should eventually send you one line listing its version and other information.
    Return to Index

    bots

    Shows the list of bots currently in the botnet.
    Example: Bots: cEvin, ruthie, Killa1

    There is no indication of which bots are directly connected to this one. Use who or bottree for that information.
    Return to Index


    bottree     or     vbottree

    Shows a tree-format diagram of the bots currently in the botnet. It's just a nice way to get a feel for how the bots are connected physically. If 2 bots are sharing, a + will be indicated, or a ? if nothing is known.

    Use vbottree if you want to see know bot versions. See Also: bots, botinfo
    Return to Index


    cancel <file(s)>

    Tells the bot to stop sending a file that is pending (either queued, waiting, or in the process of being transferred).

    See Also:  pending
    Return to Index


    cd <directory>

    Changes your current directory if possible. This works exactly like the unix command.

    See Also:  pwd
    Return to Index


    chaddr <bot> <address:botport#/userport#>

    Changes the internet address for a bot. This is the address your bot will try to telnet to in order to create a connection and link up. If the bot has a seperate port for bots and users they should be seperated with a slash (/).

    See Also: link ,   +bot
    Return to Index


    +chan <channel>

    Lets you add another channel to the bot, this cause the bot to join the channel, and for you to make changes to it's settings. This channel is not permanent unless "chanfile" has been defined in the config file, and is saved everytime the userfile is saved, or by using .chansave
    See Also: -chan , chanload , chaninfo
    Return to Index

    -chan <channel>

    This removes ALL information about a channel from the bot. It's not made permanent unless a channel-file has been defined in the user file, in which case it's saved each time the usefile is, or by using .chansave .

    *** IMPORTANT ***
    This erases ALL information about the channel, including channel settings and channel records for users -- EVERYTHING.

    DO NOT use it to have the bot temporarily leave a channel. This command is for abandoning a channel (e.g. the channel will have to be redefined and all user flags for that channel will have to be redone.
    Even if you don't have chanfile defined, it will still erase all the channel records for users on the next userfile save.

    See Also: +chan , chansave , chanload , chanset , chaninfo
    Return to Index


    chaninfo <channel>

    This lists all the settings for the bot on the given channel. It shows any of the following:
          chanmode     Which modes are enforced on the channel, both + and
                       - modes can be enforced
          idle-kick    Kick idle users (non +f's anyway) on the channel
                       after how many minutes (use 0, or no-idle-kick
                       to turn this off)
    The following can be set + or - .chanset #channel -clearbans
          clearbans    Clear all the channel bans when
                       the bot joins the channel?
          enforcebans  Kicks people who match channel bans?
          dynamicbans  Only activate bans on channel when they are needed
          userbans     Allow other users to place bans on the channl
          autoop       Automatically op users when they join the channel
          bitch        Only allow users with the +o flag
                       to be ops on the channel
          greet        Say a users info line when they join the channel
          protectops   Re-op a +o user who gets deopped?
          statuslog    Log the channel status every 5 minutes
          stopnethack  De-op anyone who enters the channel with server ops
          revenge      Take revenge on anyone who deops, kicks
                       or bans the bot or any valid user
          secret       Don't provide info about the channel over the botnet
          shared       Share user settings for this channel
                       (NOTE: this can only be set in the config file)
          autovoice    This causes the bot to also monitor channel
                       voice settings, using the +v/+q settings. 
    The following are flood settings, they are set by going .chanset flood-type number:seconds
    Where number & seconds are integers indicating the number of times in how many seconds the flood will be triggered
          flood-chan   this defines the flood level for public chatter
                       & actions
          flood-ctcp   this defines the flood level for ctcp's to the
                       channel (include PING & VERSION), except for ACTION's
          flood-join   this defines the number of joins from a give
                       user@host that constituts a flood
          flood-kick   how many kicks in the given time are a flood
          flood-deop   deops in the given time 
    Return to Index

    channel [channel-name]

    Shows you an extensive display of the users on a channel, and the current channel attributes. By default, it shows you the channel you are currently viewing on the console, but you can specify another channel if you wish.

    The first line will look like:
        Channel #hiya, 8 members, 45 users, mode +tn:
    This means that the bot is sitting on channel #hiya, where 8 other irc'ers are. There are 45 people that the bot knows by hostmask, and the channel mode is +tn. If the bot isn't on the channel it is supposed to be on, it will say "Desiring channel #hiya" instead. Next is a list of the users on the channel, with each entry looking like this:

                      NICKNAME  HANDLE    JOIN   IDLE  USER@HOST
                      @kantSF   kantSF    14:53 o  6m  josh@random.edu 
    The @kantSF means that the user's nickname is kantSF and that he is a chanop. The second kantSF is the nickname that the bot knows him by. Sometimes this will differ from the nickname a person is using. The time displayed is the time the user joined the channel. The next field is the attributes:
              n - bot owner                 o - can get ops (+o)
              m - bot master or owner       f - channel friend
              b - another bot               d - cannot get ops (+d)
    The last field is the user@host he is using irc from.

    See also:  status whois
    Return to Index


    chanload

    Reloads the channel settings from the file defined by the chanfile" setting. This allows you to return to a previous setting if you've really messed things up.
    See Also: +chan , -chan
    Return to Index

    chansave

    Saves the channel settings to the file defined by the chanfile setting. This file is reloaded during rehash and restarting the bot. This allows you to change channel modes without having to edit the config file every time.

    See Also: +chan , -chan
    Return to Index


    chanset <channel> <settings>

    Allows you to change the channel settings for a channel. (See .chaninfo for the settings). These are used until the next rehash/chanload/restart, and are saved whenever the channel settings are saved.

    See Also: +chan , -chan
    Return to Index


    chat <channel # or name>

    Changes your channel on the dcc chat connection. When you first connect to the bot, it places you on channel 0 (the party line). You can move to another channel where basically nobody can see you (except anyone else who decides to join that channel). Valid channel numbers are 1 thru 99999.

    Some channels may have assigned names if the assoc module is loaded. For those, you can specify the channel by name instead of number if you wish.

    chat off removes you from any channel at all. You can still use normal bot commands and see the console, but you can't talk to anyone except via note.

    chat on returns you to the party line (channel 0) if you were elsewhere.

    chat <*channel# or name>

    Same as above, but for channels available only to the bot you are on.
    Return to Index

    chattr [attributes] [channel]

    Lets you view and change the attributes (flags) field for a user.
    For example, to give Lamer the p and f flags: .chattr Lamer +pf
    Or to remove Denali from the global op list: .chattr Denali -o
    You may also do any combination of the above: .chattr Fred1 -m+xj-o

    You can also change the flags for Usagi on a specific channel by supplying the channel after the attributes:
    .chattr Usagi -m+dk-o #blah

    Changing global and channel specific flags within the same command line is now possible!
    Example: .chattr Bill f|o #lamer (global +f, +o #lamer)

    Whether or not you change any flags, it will show you the user's attributes afterwards.

    To get a list of the flags possible, do '.help whois'.

    NOTES: Only the owner may add or remove the 'n' (owner), 'm' (master) and 't' (bot master) flags. It is pointless to -n a permanant owner. You must remove the permanant owner in the config file. This command can no longer be used to change bot flags, they are a seprated entity, changeable with the .botattr command.

    See Also: whois
    Return to Index

    chbf <user> [boyfriend]

    Sets the boyfriend entry for a user. This info isn't really used by the bot for any reasons except to display.
    Return to Index

    chdob <user> [date of birth]

    Sets the Date of Birth entry for a user. This info isn't really used by the bot for any reason except to display.
    Return to Index

    chemail <user> [email address]

    Sets the email address for a user. This info isn't really used by the bot for any reason except to display.
    Return to Index

    chgf <user> [girlfriend]

    Sets the girlfriend entry for a user. This info isn't really used by the bot for any reasons except to display.
    Return to Index

    chinfo <user> [channel] [info-line]

    Sets the information line for a user. This line is shown via /msg commands who and whois, and if you have set greet on, it is shown when a user joins the channel. If the info line begins with a @, then it is "locked", and that user may no longer change it. If the channel name is omitted, the default info line is changed.

    chinfo <user> [channel] none Erases a user's info line.

    See Also:  +info
    Return to Index


    chirl <user> [In Real Life Name]

    Sets the 'In Real Life' entry for a user. This info isn't really used by the bot for any reasons except to display.
    Return to Index

    chnick <oldnick> <newnick>

    Changes the handle/nickname of a user record. For example, to change the nickname of user 'gavroche' to 'jamie', you would type: chnick gavroche jamie
    Return to Index

    chpass <handle> <newpassword>

    Changes a user's password on the bot. If you leave off the new password, the user effectively no longer has a password set. A password is needed to get ops, join the party line, and other things (but only required if one is set).
    NOTE: In previous versions, setting a password to nopass would clear a user's password -- with encrypted passwords, this no longer works!
    Return to Index

    +chrec <handle> [channel]

    Adds an empty channel record for the user so that channel lastons and info lines can be saved. No flags are associated with the channel.

    See Also:  chattr
    Return to Index


    -chrec <handle> [channel]

    Deletes a channel record for the user, including channel lastons, info lines, and flags.

    See Also:  chattr
    Return to Index


    churl <user> [url address]

    Sets the url addess for a users web site. This info isn't really used by the bot for any reasons except to display.
    Return to Index

    comment <user> <comment...>

    Creates or changes the comment field for a user. The comment field can only be seen via 'user' or match. Non-masters cannot see the comment field.
    Return to Index

    Common flag

    Sometimes a lot of people use irc from the same account, i.e. example, a public telnet site. In that case, many people can have the same user@host. For that reason, they can't use a traditional user record because they will appear to all be the same person.

    In such cases, create a user record for the account, and mark it +c, or "common access". Marking it as "common access" means that it shouldn't be used as a definitive address. When someone introduces themself to the bot (ie, by /msg'ing "hello")and matches as a +c user, they will be given a new user record which identifies them BY NICKNAME.

    Obviously people with that kind of user record shouldn't be given much special access, as when they change nicknames the bot will identify them as someone else.
    Return to Index


    console [channel] [modes]

    Changes your console level, so that you will see only those types of console messages that you want to. Your current console channel is the channel (that the bot is on) which you can view from the party line, and which channel-specific commands (like say and op) take affect on. Valid levels are:
         m  display private msgs/ctcps to the bot
         p  display public talk and ctcps on the channel
         k  display kicks/bans/mode changes on the channel
         j  display joins/parts/nick changes/signoffs/etc on the channel
         b  display bot links/unlinks/userfile-sharing
         s  display server messages and connect/disconnects
         w  display msgs between IRCops (wallops)
    
         Channel Master Only:
    
         c  display user commands (dcc and msg)
         o  display other bot notices [HIGHLY RECOMMENDED]
    
         Master Only:
    
         x  display file transfers and file-area commands
         d  display debug messages that only coders would care about
    The mode can also be a modifier like +p or -jk or +mp-b. If you omit the channel and modes, it will show your current console channel and setting.

    console <user> [channel] [modes]
    Is used to set the console level of another user. This can even be used on users who normally would not be able to set their own console mode.
    Return to Index


    cp <source> <dest>

    Copies a file or group of files from one place to another.

    See Also:  mv
    Return to Index


    dccstat

    Displays a table-format list of all the "dcc" connections the bot is handling. dcc means direct client-to-client communication and eggdrop expands this to cover every open socket. So any type of network connection to the bot is considered a dcc connection.

    The headings of the table are:

         SOCK  the socket of this connection (always unique)
         ADDR  the IP-number of the host the connection is to, if applicable
         PORT  the port number being used for communication
         NICK  the nickname of the user or bot, if it's a user or bot
         HOST  sometimes, the hostname corresponding to the IP address
         TYPE  the type of dcc connection (see below)
    The types of connection currently possible are as follows (but more are being added literally all the time):
         chat  user in dcc-chat command mode
         pass  user entering dcc chat (being asked for her password)
         send  raw data connection: user sending a file
         get   raw data connection: sending a file to a user
         getp  pending get (waiting for the user to acknowledge)
         lstn  telnet listening port (in place of a hostname, it will
         show  the proc to call, or mask of acceptable nicks)
         t-in  incoming telnet user (being asked for his nickname)
         file  user in dcc-chat file area
         bot   bot linked in (aka botnet connection)
         bot*  pending bot link (waiting for acknowledgement)
         rela  user in relay connection to another bot
         >rly  bot being relay'd to (one for each "rela")
         conn  pending telnet connection (chat, relay, bot-link, etc)
         new   new user via telnet, entering a handle
         newp  new user via telnet, entering a password    
    7 In addition, chat and bot have flags listed for each connection. Capital letters mean the flag is on, and lowercase letters mean the flag is off. For chat, the flags are:
         C   in file area, but allowed to return to party line
         P   party line access only (no +o access)
         T   telnet connection (instead of dcc chat)
         E   echo is on
         P   use is paging
    
         For bot, the flags are:
    
         P   ping sent, waiting for reply
         U   user-file sharing is active
         C   this bot initiated the connection
         O   user-file offered, waiting for reply
         S   in the process of sending the user-file
         G   in the process of getting the user-file
         W   warned this bot to stop hubbing
         L   leafed bot (not allowed to hub)
         I   bot is currently in the linking stage
         A   bot is being agressively shared with    
    For chat users, the party-line channel is also listed.
    Return to Index

    debug

    Will display a dump of memory allocation, assuming the bot was compiled with DEBUG defined. It's useless to anyone but programmers hacking on the bot and trying to find memory leaks.
    Return to Index

    deluser <nickname>

    Deletes a user record for a user on the channel, using their current hostname. Channel masters can remove users so long as the user isn't a bot master.

    See Also:  adduser+user -user
    Return to Index


    deop <nickname> [channel]

    Will remove chanop from the person you specify, so long as the bot is opped on that channel, and the person you specify isn't on the bot's list of authorized chanops.

    See Also:  op console
    Return to Index


    desc <file> <description>

    Changes the description for a file. If you are a master or file janitor, you can change the description for any file. Otherwise you can only change the descriptions for files you have uploaded.

    The description is restricted to 3 lines of 60 characters each, and is broken up between words. You can force a line break by putting a | in the comment.
    Return to Index


    die [reason]

    Kills the bot. The bot goes offline immediately, logging who gave the die command. You shouldn't have to use this too often. If you specify a reason, it's logged, otherwise the reason is "authorized by <nickname>".
    Return to Index

    disableban ban# delay

    Will disable one of the perm bans for X amount of time. The ban# is from doing a bans command.
    Return to Index

    dob [date of birth]

    Sets your date of birth. This data isn't really used by the bot, but it will show up if someone does a whois on you. If you don't specify an address, the bot will show you your date of birth if it currently has one for you.

    dob none         Clears your date of birth. (woah, no more showing ID ;)
    Return to Index


    dump <text>

    Dumps the text to the server. Keep in mind that this bot doesn't run through ircII, so ircII commands will most likely not work this way. They need to be raw irc codes. Read rfc1459 from ftp.internic.net for more help.
    Return to Index

    echo <on/off>

    Sets whether you want your messages echoed back to you. If it's on, then when you say something on the party line, it will be displayed to you just like everyone else will see it. If it's off, then that won't happen.
    Return to Index

    email [email address]

    Sets your email address. This data isn't really used by the bot, but it will show up if someone does a whois on you. If you don't specify an address, the bot will show you the email address it currently has for you (if any).

    email none          Clears your email address with the bot.
    Return to Index


    quit

    Exits the file system
    Return to Index

    files

    Will move you into the file transfer sub-system, if it has been enabled on this bot. From there you can browse through the files online and use dcc file transfers to download and upload.
    Return to Index

    filestats <user>

    Reports on the users upload & download statistics.
    Return to Index

    fixcodes

    Use this in those situations where the bot gets mixed up about your type of connect, eg: when you /ctcp chat the bot & it thinks you're telnetting, and you're actually using dcc. It effectively switches telnet on and off.
    Return to Index

    flagnote <[+]flag> [#channel/all] <message>

    Sends message to users with given channel or global flag. If #channel is specified, message goes to users with channel flag for channel #channel. If all is specified, message goes for users with either any channel or global flag. Otherwise message will go only to users with global flag. A %nick in message to be replaced with destination handle.
    Return to Index

    flush <bot>

    Clears the resync buffer for a share-bot. This is useful if you want to start over with a userfile transfer: you can unlink the sharebots, flush the resync buffer, and relink.

    See Also:  link chattr unlink
    Return to Index


    fwd <handle> [desto]

    This allows you to set a note forwarding address for a user. This means if a note needs to be stored for the user, the bot will attempt to pass it on to the given user@bot. If the bot is not online then the note is still stored locally. If the other user doesn't exist, the note is lost. Boohoo.
    Return to Index

    get <filename(s)> [nickname]

    Sends you the file(s) requested, over IRC. You should get a DCC SEND notice on IRC, and have your client accept it. If your nickname on IRC is different than the one you use on the bot, you should specify a nickname too. You can also use that to send files to other people. If a file you want is actually on another bot, it may take a little bit longer so be patient. If that bot isn't on the botnet right now, it will say the file isn't availble.

    There is a limit to the number of transfers you can have going simultaneously, so if you go over this limit, the remainder of your file requests will be queued. As the first files finish transferring, the queued files will be sent.

    See Also:  pending , cancel
    Return to Index


    gf [girl friend]

    Sets your girlfriend. This data isn't really used by the bot, but it will show up if someone does a whois on you. It's also used by the seen script. If you don't specify an address, the bot will show you the girlfriend entry it currently has for you (if any).

    gf none         Clears your girlfriend.
    Return to Index


    hide <file(s)>

    Marks a file as hidden, so that normal users can't see it. Only a master or file janitor using lsa can see hidden files.
    Return to Index

    See Also:  unhide, lsa
    Return to Index


    +host <nickname> <hostmask>

    Adds a hostmask to a user's record on the bot. The hostmasks are where the bot will identify that user from. Usually you will not need to use this command since a user can add hostmasks to her own record via the /MSG IDENT command, but it's here if you need it.
    Return to Index

    -host <hostmask>

    Allows you to remove a host for youself. To remove a hostmask for another user in the bots records use:
    -host <nickname> <hostmask>

    See Also: +host
    Return to Index


    +ignore <hostmask> [comment]

    Adds a hostmask to the ignore list, with your nickname and an optional comment. An ignore added manually like this becomes "permenent", ie, it will not expire automatically. To make the bot stop ignoring this hostmask, you must eventually use a -ignore command. This command can be used to either ignore users on irc, or to ignore incoming telnet connections.

    See Also:  -ignore ignores
    Return to Index


    -ignore <hostmask OR number>

    Removes the ignore from the list of ignores stored on the bot -- You may also reference the ignore by the number shown in .ignores.

    See Also:  +ignore ignores
    Return to Index


    ignores [wildcard]

    Lists the hostmasks that the bot is currently discarding msgs, etc from. The ignores are numbered, so they can be easily removed with -ignore by number. A permanent ignore looks like this:
            [  1] *!onaji@* (perm)
                  Xerxes: spamming me
                  Started 18:38 
    This kind of ignore can only be stopped by using -ignore. Xerxes is the one who added it, and his comment is "spamming me". He added it at about 18:38 today. A temporary ignore looks like this:
            [  2] *!*@shellx.best.com (expires at 19:59)
                  MyBot: msg/notice flood
                  Started 18:59 
    That means the ignore was made automatically by the bot at 18:59, because someone flooded it. It can be removed with -ignore, or it will expire an hour after it started (this is set in ignore-time).

    If you use ignores <wildcard> it will list all the ignores that match against your wildcard.

    See Also:  +ignore -ignore
    Return to Index


    info [channel] [info-line]

    Sets your info line. This is shown via /msg commands who and whois, and possibly when you join the channel. If you omit the info line, it will just show you what your current info line is. If you omit the channel name, your default info line will be displayed/changed. (This is the info line shown for channels where you have no specific info line set.)

    info [channel] none removes your info line.
    Return to Index


    invite <nickname> [channel]

    Invites someone from irc into your current console channel (or specified other channel). This is most useful when the channel is +i. A user with the +o flag can also request an invite from the bot with /MSG INVITE

    See Also:  console
    Return to Index


    irl [In Real Life Name]

    Sets your real life name. This data isn't really used by the bot, but it will show up if someone does a whois on you. If you don't specify an address, the bot will show you the 'in real life' entry it currently has for you (if any).

    irl none         Clears your real life name.
    Return to Index


    jump [server [port]]

    Makes the bot jump to another server. If you don't specify a server, it will jump to the next server in its internal list (see help servers). If you specify a server, it will jump to that server (default port is 6667), and if that server is not in the internal list already, it will add it. Jumping servers ALWAYS makes the bot lose ops! Be careful!
    Return to Index

    kick [channel] <nickname> [reason]

    Will kick a user off your current console channel (or specified other channel) with the comment given. If you omit the reason, the default kick comment is "requested".

    See Also:  kickban console
    Return to Index


    kickban [channel] <nickname> [comment]

    Kicks a user off the channel and bans her by a reasonable hostmask. Your nickname will be attached to the ban in the bot's internal ban list, and the ban will last for whatever is set in ban-time -- only on this channel. Use .+ban for a more permanent ban which will be activated on every channel the bot monitors. If you use a comment, that will also be attached to the ban in the ban list, and used as the kick comment.

    See Also:  +ban bans stick
    Return to Index


    link [some-bot] <new-bot>

    Tries to link in a new bot. if you use the form .link newbot then your bot must have a record for the new bot (see .+bot'). You can either set a password on each end or they will negotiate one the first time they link. If you use the form .link somebot newbot then the request will be sent to "somebot" for it to link to "newbot".
    Return to Index

    ln <bot:filepath> <localfile>

    Creates a link to a file on another bot. The filepath has to be complete, like /gifs/uglyman.gif. If the bot is not connected to the botnet, nobody will be able to download the file until that bot connects again. The local filename can be anything you want.

    Example: ln Snowbot:/gifs/uglyman.gif ugly.gif

    See Also:  share, unshare , get
    Return to Index


    ls [filemask]

    Displays the files in the current directory. Subdirectories are shown with <DIR> next to them, and other files will display their size (typically in kilobytes), who uploaded them (and when), and how many times each file has been downloaded. If a description of the file exists, it is displayed below the filename. You can restrict the file listing by specifying a mask, just like in unix.

    See Also:  cd, pwd, get
    Return to Index


    loadmod <module>

    Loads a module.
    Return to Index

    lsa [filemask]

    Works just like ls, but hidden files are displayed too. Hidden files are displayed with a "(hid)" next to them, and shared files are displayed with a "(shr)" next to them.

    See Also:  hide, share
    Return to Index


    match <attr> [channel] [[start] limit]

    Shows you user records with the attributes requested:   <attr> is of the form:
    <+/-><global>[&/|<channel>[&/|]]
    specifying & as the seperator, will cause AND style matching, | will cause OR style matching, channel flags are match vs the specified channel (or your console channel), and bot is match vs the sepreate bot flags. Some examples:
            .match +o        will match any GLOBAL +o's
            .match -o&+o     will match anyone without a global +o AND
                             with a channel +o on your console channel
            .match +f|+f     will match anyone with a global +f or a
                             channel +f on your console channel
            .match |f #fred  will match anyone with +f on channel #fred 
    match <wildcard-string> [[start] limit]
    Shows you user records where the nickname or any of the hostmasks match the wildcard string shown.

    The default limit is 20, meaning that if more than 20 user records match your requirements, only the first 20 will be shown. You can change this limit by specifying one on the command line, though. If you include a limit, you may also include a starting place (the default is 1).

    For example, to list the first 15 users who have hostmasks from clemson.edu: .match *clemson.edu 15

    To get the next 10 (if there are more than 15), you ask to list numbers 16 thru 25: .match *clemson.edu 16 25
    Return to Index


    me <text>

    Performs an action on the party line.
    Return to Index

    mkdir <dir> [flags [channel]]

    Creates a subdirectory from this one, with the given name. If flags are specified, then those flags are required to enter or even see the directory. You can even specify a channel that the flags are matched against. You can use the mkdir command again to alter or remove those flags.

    See Also:  rmdir
    Return to Index


    module [modulename]

    Reports the names of currently loaded modules, including dependancies & status report, you can get info only on a specific module by specifying it.
    Return to Index

    modules <botname>

    Requests a listing of the modules running on the remote bot
    Return to Index

    motd

    Will redisplay the party-line message of the day, which was shown when you first joined.
    Return to Index

    msg <nickname> <text>

    Sends a private message to someone from the bot, just as if the bot had typed /msg.
    Return to Index

    mv <source> <dest>

    Moves a file or group of files from one place to another. It can also be used to rename files.)

    See Also:  cp
    Return to Index


    newpass <password>

    Changes your password on the bot, just like the /msg command 'pass', except you don't need to type your old password.
    Return to Index

    nick <new-nick>

    Changes your nickname on the bot. That's the handle that the bot will know you as forever and ever, and what you have to use when telnetting in or IDENT'ing yourself, so remember it.
    Return to Index

    note <nickname> <message>

    Sends a private note to a user on the party line. If that user is currently on the party line, and not marked as away, they will receive the message immediately. Otherwise it may be stored and displayed the next time that user joins the party line. If you join the channel, and have notes stored for you on the bot, it will tell you. To send a note to someone on a different bot, use nick@bot for the nickname.

    See Also: whom, notes
    Return to Index


    notes

    Lets you manipulate notes that have been stored up for you while you were gone.

    notes index gives a listing of all the notes stored up: who they are from, and when they were left.
    notes read <# or ALL> lets you read some or all notes, according to a list of numbers and/or intervals separated by semicolon.
    notes erase <# or ALL> erases notes after you are done with them.
    Example: notes erase 2-4;8;16-

    See Also:  notewhom
    Return to Index


    op <nickname> [channel]

    Will grant chanop to the person you specify, so long as the bot is opped on that channel, and the person you specify isn't being actively deopped by the bot.

    See Also:  deop console
    Return to Index


    page <# or off>

    Allows you to slow down the number of lines the bot sends to you at once while you're in chat mode. With this on, any commands that send greater than the specified number of lines will stop when the number is reached, and wait for you to type another command (or press enter) to continue. If you have to many lines waiting to be seen you may be booted off the bot.
    Return to Index

    pending

    Gives you a listing of every file you've requested which is still waiting, queued, or in the process of transferring. It shows you the nickname on IRC that the file is being sent to, and, if the transfer is in progress, tells you how far along the transfer is.

    See Also:  cancel
    Return to Index


    pwd

    Tells you what your current directory is. As in "Print Working Directory".

    See Also:  cd
    Return to Index


    quit [comment]

    Removes you from the party line and disconnects your dcc chat session with the bot. If you specify a comment, it will be displayed to other users as you leave.
    Return to Index

    rehash

    Reloads the config file for the bot, which resets all the 'set' variables and reloads any TCL scripts your config loads. It also saves and reloads the user file from disk, just to give your disk a little extra wear.

    See Also:  save reloadrestart
    Return to Index


    rehelp

    This command gets the bot to recheck all it's help files for new commands that have been added.
    Return to Index

    relay <botname>

    Will relay you via telnet to another bot that your bot knows of, whether or not they are currently connected. Your dcc-chat/telnet connection to this bot will be relayed to the other bot until the other bot drops your relay, or until you send *bye* on a line by itself.

    See Also: bots
    Return to Index


    reload

    Reloads the user file of the bot, discarding any changes made since the last .save or hourly user file save. Sharebots should probably not ever do this.

    See Also:  rehash ,   save
    Return to Index


    reset [channel]

    Clears out the bot's channel information and makes it gather the information from the server all over again, as if it had just joined that channel. It's not really useful much, but could be if an odd bug causes the channel information to get scrambled. Unfortunately this command used to get a lot of use. You can omit the channel name to make it reset ALL channels.
    Return to Index

    resetbans

    Resets the ban list on the channel you're currently viewing in the console. Any bans on the channel that aren't in the ban list (either the global list or the local channel ban list) will be removed, and if there are any bans in the global ban list or channel ban list that are not currently on the channel, they will be added.

    See Also:  bans reset console
    Return to Index


    restart

    Restarts the Tcl interpreter, wipes all timers and utimers, and reloads the config file for the bot, which resets all the 'set' variables and reloads any TCL scripts your config loads. It also saves and reloads the user file from disk, just to give your disk a little extra wear. It's also the most risky command to run, because it's never ever really worked properly.

    See Also:  rehash reload ,   save
    Return to Index


    rm <file(s)>

    Erase a file for good.
    Return to Index

    rmdir <dir>

    Removes an existing directory, if there are no files in it.

    See Also:  mkdir
    Return to Index


    save

    Makes the bot write its entire user list to the disk. This is useful if you think the bot is about to crash or something, since the user file is only written to disk about once an hour.

    See Also: reload ,   rehash
    Return to Index


    say [channel] <text>

    Dumps the text to your current console channel (or other specified channel), as if the bot "said" it.
    Return to Index

    seen <nick>

    This module provides the classic seen command, which returns the last time a user was seen by the bot, both dcc & msg commands are provided.
    Return to Index

    servers

    Lists the servers that the bot has in its server list. This is the list it rotates through when changing servers. It starts with a static list which it loads from its config-file when the bot is booted up. After that, you can add servers with the .jump command. The server list will indicate which server the bot is currently on.
    Return to Index

    set <variable> [value]

    Changes the values of internal settings of the bot, or, if used without a value parameter, shows the current value of a setting. The bot starts out with settings as given in the configuration file.

    See Also:  Set Commands - Bot Configuration Variables
    Return to Index


    share <file(s)>

    Marks a file as shared. This means that other bots can get the file remotely for users on their file systems. By default, files are marked as unshared.

    See Also:  unshare, lsa, ln
    Return to Index


    simul <nickname> <text>

    If the user is on the party line, the bot will simulate them typing the text you specify. Example: .simul dweeb .quit
    Makes it just as if dweeb typed .quit . This command will not work unless eggdrop has simul enabled in the config file. Please use this command ethically.
    Return to Index

    sort

    Sorts the files in the current directory into ascending alphabetical order.
    Return to Index

    stats

    Reports your upload & download statistics.
    Return to Index

    status

    Displays a condensed block of information about how the bot is running. Here's an example from Snowbot:
        I am Snowbot, running eggdrop v1.1.1:  400 users (mem: 42k)
        Running on BSDI 2.5
        Admin: Robey <ROBEY@WC130.RESIDENCE.GATECH.EDU>
        #turtle   :  2 members, enforcing "+tn-mlk"  (greet, bitch)
        #gloom    :  3 members, enforcing "+tn-i"  (greet)
        Server minnie.cc.utexas.edu:6667
        Online for 4 days, 06:18  (background)  CPU 14:18  cache hit 55.3%
        
    The first line tells you the bot's name, what version of eggdrop it's running, the number of users the bot has records of, and the amount of memory being used.

    The second line, tell what operating system the bot is running under.

    The third line, if present, is the contents of your 'admin' line in the config file.

    Next is a line for each of the channels your bot is currently monitoring. For each channel, it lists the number of people on the channel ("members"), what channel modes it's trying to enforce, and which options are set for that channel.

    If your bot is sharing user files with anyone, and is currently either transmitting or receiving the userfile from a bot, it will say so here, and tell how many users have been received so far, or how many more users need to be transmitted.

    The next few lines show the current server, and if the helpbot is in use, its nickname and current server. To prevent server flooding, both the bot and its helpbot use queues to store replies to queries from users. If either queue has a significant amount of information in it, this status display will show how full (%)the queue is.

    The next line tells you how long the bot has been online, and whether it is operating in the background or foreground. If it's in the foreground, it will tell you whether it's in terminal mode or channel display mode. (terminal mode makes the local console simulate a dcc chat connection, and channel display mode displays a .status and .channel output every few seconds.) It will also give you an estimate of the amount of CPU time (minutes and seconds) the bot has used so far, and how well the cache is working. The cache is an attempt to keep the CPU time down, and anything over 50% or so is just great.

    If you do .status all you will see another pageful of info, showing every internal setting as specified in the config file. It should be self-explanatory to anyone who needs to use it.

    See Also:  setchanneldebug
    Return to Index


    store

    The console module provides the ability to store your console settings so that next time you use the party line they are set. You can use the .store command at any time to store it, or it may be configured to save automatically.
    Return to Index

    stick <hostmask OR number>

    Makes a ban "sticky" -- meaning the bot will always try to keep the ban active on the channel, even if the channel is using dynamic bans. Obviously if the channel isn't using dynamic bans, this has no effect.

    See Also:  bans+ban
    Return to Index


    strip [modes]

    Enables you to remove embedded 'attribute' codes from within a section of text. Valid options are:
          b  remove all boldface codes
          c  remove all color codes
          r  remove all reverse video codes
          u  remove all underline codes
          a  remove all ansi codes
          g  remove all ctrl-g (bell) codes 
    The mode can also be a modifier like +c or -bu or +ru-c. If you omit modes, it will show your current setting.
    strip <user> [modes] is used to set the strip level of another user, a master can't set their own strip flags without starting the modes with a +/-
    Return to Index

    su <user>

    Changes your username to that of another. If you are an owner this does not require a password otherwise, you must enter the password of [user].
    Return to Index

    /msg [bot] subop #Channel password

    Sets user as a subOP on channel that allows use of this setting. Gives full kick/ban/topic access
    Return to Index

    topic <text>

    Changes the channel's topic, assuming the bot is a chanop or the channel is not +t (uses your current console channel).

    See Also:  console
    Return to Index


    trace <bot>

    Sends out a trace signal to another bot. If that trace signal returns (and it should!) you will get an output something like this:
    Trace result -> Valis:Stonewall:NoBoty:SomeBoty
    It's a list of the bots between you and the destination bot. It should also return the time in seconds it took for the trace to occur.

    See Also: bots, bottree
    Return to Index


    unhide <file(s)>

    Makes a file be not hidden any more.

    See Also:  hide, lsa
    Return to Index


    unlink <bot>

    Disconnects the named bot from the botnet, assuming it was connected in the first place. Some bots (sharebots in particular) might not allow you to unlink them.
    unlink * disconnects from all bots

    See Also:   link bots ,   bottree
    Return to Index


    unloadmod <module>

    Unloads a module.
    Return to Index

    unshare <file(s)>

    Removes the shared tag from a file.

    See Also:  share, lsa, ln
    Return to Index


    unstick <hostmask or number>

    turns a sticky ban normal again.

    See Also:   bans stick ,   -ban
    Return to Index


    url [url site address]

    Sets your url address. This data isn't really used by the bot, but it will show up if someone does a whois on you. If you don't specify an address, the bot will show you the url address it currently has for you (if any).

    url none         Clears your url address.
    Return to Index


    userinfo script

    This nifty little script lets you define arbritary strings for each user that they can set for themselves or a master can set. The default script contains the entries URL, BF (boyfriend), GF (girlfried), IRL (in real life), EMAIL, DOB (date of birth). Some of these are used by other scripts (e.g. ques & seen). Each entry has a '.' command for users and a '.ch' command for masters, also there is a /msg command to change each one.
    Return to Index

    +user <nickname> <hostmask>

    Creates a new user record for the nickname given, with one entry in the hostmask table. The new user record will have no flags (i.e. not be a master, op, friend, etc) and no password.
    Return to Index

    -user <nickname>

    Erases the user record for the nickname given.

    See Also:   +user+bot -bot
    Return to Index


    who [bot]

    Lists people on this bot, or bots connected to this bot. The first section is people on your current channel (the party line, if you haven't changed channels) who are on the bot.
        A * next to the nickname means that user is an Owner.
              + means they're a Master.       @ means they're an Op.
              % means they are a Bot Master.
        
    The user's nickname, hostname, and possibly an idle time and/or away message will be displayed:
    *Robey telnet: nowhere.com

    The next section is bots directly linked to this one:
    -> MagField (14 Oct 01:16) eggdrop v1.0j

    The arrow indicates who initiated the connection -- the right arrow means this bot connected to MagField. A left arrow means they connected to us. A + next to the arrow indicates that the bot is sharing userfiles with us. The connection time (14 Oct 01:16) and bot version are also shown. Nowadays it may also show the network the bot resides on.

    The final section is a list of users on this bot who are not on your channel. (This section may be omitted if everyone is on the same channel as you.)

    If you specify a bot's name, as in .who valis, the who request will be sent to that bot, as long as that bot is on the botnet.

    Masters may also see "(con)" after a user's entry, this shows thatuser's console modes (see the .console help page).

    In the final section (users that aren't on this channel), masters will see the actual channel other users are on. Also, people in the file system will be listed (as being in channel "files") -- a + next to the nickname here means the user has access to return to the party line.

    See Also: whom
    Return to Index


    whois <nickname>

    Will show you the bot information about a user record. There are five headings:
          HANDLE  The handle (nickname) of the user
          PASS    Yes if they has a password set
                  No if they do not have a password set
          NOTES   Number of notes stored waiting for the user
          FLAGS   The list of flags for this user (see below)
          LAST    The time or date that the user was last on the channel 
    The valid flags under FLAGS are:
         o   global op (bot will op this user on any channel)
         m   master (user is a bot master)
         n   owner (user is the bot owner)
         t   botnet master (user is a botnet master)
         x   xfer (user has file-area access)
         j   janitor (user is a file-area master)
         p   party-line (user has party-line access)
         c   common (user record is a common-access site)  [see  common]
         u   unshared (not sent to other share-bots)
         b   bot (user is another bot)
         d   global deop (user cannot get ops)
         k   global auto-kick (user kicked & banned automatically)
         f   global friend (user is not punished for doing bad things)
         v   global voice (user get +v automatically on +autovoice channels)
         a   global auto-op (always op this user on join)
         h   high-light flag, user sees highlighting in text output
            (plus 26 user-defined flags, A-Z)    
    Each channel that the user has joined will have a specific record for it, with the channel-specific flags and possibly an info line. the channel-specific flags are:
         m   master (user is a master for the channel)
         n   owner (user is an owner for the channel)
         o   op (bot will give this user chanop)
         d   deop (bot will not allow this user to become a chanop)
         f   friend (user is not punished for doing bad things)
         k   kick (user is auto-kicked)
         v   voice (user gets +v automatically on +autovoice channels)
         q   quiet (user never gets +v on +autovoice channels)
         a   auto-op (always op this user on join)
            (plus 26 user-defined flags, A-Z)    
    Hostmasks for the user are displayed on the following lines. If the user entry is for a bot, there will be a line below which says ADDRESS: and gives the bot's telnet address. Some user entries may have EMAIL: and INFO: entries too. There may be additional information displayed depending on the modules loaded.
    For bots, there are additional flags seen under the BOTATTR: entry, these include:
         s   share (bot is sharing user records, aggressively)
         p   share (bot is sharing user records, passively)
         g   global share (share all channels)
         h   hub (bot is auto-linked at highest priority)
         a   alternate (bot is auto-linked if no hub bots can be linked)
         l   leaf (bot is not allowed to link in other bots)
         r   reject (bot will not be allowed on the net)
         i   isolate (isolate the party line across a botlink)
            (plus 10 user-defined flags, 0-9)    
    Bots may also have +s (share) settings for individual channels masters: If there is a comment, you will see it under COMMENT:

    See Also:  match
    Return to Index


    whom [channel]

    Will display a table of the users currently on the joint party line (formed when you have two or more bots linked together). It will show each user's nickname, preceded by a * if they are the Owner of their bot, + if they are a Master, % if they are a Bot Master or @ if they are an Op. In other columns it will show which bot the user is on, and his or her host.

    If the user is away, the away message will be shown. Likewise, if they are idle, the idle time will be displayed.

    If you are on a different channel than the party line (channel 0), then this will show the people on every bot who are on your current channel. You can also optionally give the "channel" option to list who is on a particular channel.

    See Also: who, bots, chat
    Return to Index


    set admin <admin-info>

    Specifies the admin info for your bot. It's just human-readable text that is displayed every once in a while. It shouldn't be very long (no more than about 60 characters) and ought to say who's running the bot, and maybe an email address too. Here's an example:
    set admin "Jace the Happy <jason@mtu.edu>"
    Return to Index   Return to Set Cmds

    set allow-dk-cmds 0/1

    Some say +d/+k users should be able to use all the any-user commands. Some say they shouldn't, WHO CARES :) This little setting lets you decide for yourself, I'm too weak to decide for you.
    Return to Index   Return to Set Cmds

    set allow-fwd 0/1

    This setting determines if note forwarding is permitted. If a note is about to be stored (since the user is note currently online) and they have a forwarding setting and this value is 1 the note will be forwarded to the appropriate user.
    Return to Index   Return to Set Cmds

    set allow-resync 0/1

    This setting determines if the bot will re-send the userfile every single time a sharebot reconnects, or if it will store changes that occur for resync-time seconds and send only these when the sharebot reconnects, this has been know to be a bit unreliable in the past, hence the option.

    See Also:  set resync-time
    Return to Index   Return to Set Cmds


    set altnick <nickname>

    Sets an alternate nickname to use if the preferred nickname (in nick) is in use. If the alternate nickname is also in use, or is blank, the bot will try sticking digits at the end of the preferred nick until it gets one that works.

    See Also:  set nick, set botnet-nick
    Return to Index   Return to Set Cmds

    set answer-ctcp <0/1>

    This sets the maximum number of stacked CTCP's to answer from any given message.
    Return to Index   Return to Set Cmds

    set ban-time <#>

    Specifies how long (in minutes) a temporary ban will last on the bot before being purged.

    See Also:  bans , +ban , kickban , ignore-time
    Return to Index   Return to Set Cmds


    set botname

    This read-only variable returns the current nick!user@host of the bot.
    Return to Index   Return to Set Cmds

    Return to Index   Return to Set Cmds

    set botnick

    This read-only variable returns the bots current nickname on irc.
    Return to Index   Return to Set Cmds

    set nick <nickname>

    Specifies the bot's default nickname to use on IRC and on the botnet, unless botnet-nick is set differently.

    See Also:  set altnick, set botnet-nick
    Return to Index   Return to Set Cmds


    set check-stoned <0/1>

    This setting, when enabled, will cause the bot to ping the server occasionally to make sure it's actually still connected. It also provides a 'lag-meter'. This is slightly broken on IRCNet.
    Return to Index   Return to Set Cmds

    set connect-timeout <seconds>

    Specifies how long to wait when connecting to a dcc chat, telnet, relay, bot link, or anything like that. If the connect doesn't happen after this many seconds, the bot will just give up.
    Return to Index   Return to Set Cmds

    set console <console-flags>

    Specifies the default console mode for masters and ops when they first get on the dcc chat connection with the bot. For more info about console flags, see console.
    Return to Index   Return to Set Cmds

    set console-autosave 0/1

    When this flag is set, a users console settings are automatically saved for the next time the user joins the party line.

    See Also:  store
    Return to Index   Return to Set Cmds


    set copy-to-tmp <0/1>

    Sets whether files will be copied into your /tmp directory before they are sent to users who download them from the file system. Turning this on protects ongoing transfers from being affected by people moving files around in the file system, but if you're short of disk space or using a slow disk (** NFS **), you should probably turn this off.
    Return to Index   Return to Set Cmds

    set ctcp-finger <text>

    Specifies the response to send to a CTCP FINGER request. One example is:
          Robey (robey@wc130), idle 0 seconds

    See Also:  set ctcp-version, set ctcp-userinfo
    Return to Index   Return to Set Cmds


    set ctcp-userinfo <text>

    Specifies the response to send to a CTCP USERINFO request.

    See Also:  set ctcp-version, set ctcp-finger
    Return to Index   Return to Set Cmds


    set ctcp-version <text>

    Specifies the response to send to a CTCP VERSION request. One example is:    ircII 2.8 Linux 1.2.4 :ircii 2.6: almost there...

    See Also:  set ctcp-finger, set ctcp-userinfo
    Return to Index   Return to Set Cmds


    set dcc-block <#>

    Specifies the block size to use in DCC file transfers. The ircII client defaults to 512, but admits that it may be too small. Most toolboxes set it to 1024.

    You can set this to 0, which turns on "turbo dcc". In turbo dcc mode, the bot will dump transfers as fast as possible, only stopping to count acks after it's finished. This can dramatically improve the speed of file transfers, and is recommended.
    Return to Index   Return to Set Cmds


    set dcc-flood-thr <#>

    This determines the number of messages per second a user can send to the botnet before it's considered a flood, and they should get booted.
    Return to Index   Return to Set Cmds

    set default-flags <flags>

    Specifies the flags to give to a user when they first introduce themselves to the bot with /MSG HELLO or via telnet. Obviously this has no effect if you have learn-users and open-telnets turned off. For a list of the flags, see whois.
    Return to Index   Return to Set Cmds

    set default-port <#>

    Sets the default port the bot tries to connect to when there is not a port specified in the server list.
    Return to Index   Return to Set Cmds

    set die-on-sighup 0/1

    This config-file-only variable determines whether the bot will die on receiving a HUP signal, or just rehash.
    Return to Index   Return to Set Cmds

    set die-on-sigterm 0/1

    This config-file-only variable determines whether the bot will die on receiving a TERM signal, or just save the userfile.
    Return to Index   Return to Set Cmds

    set enable-simul 0/1

    This questionable setting enables the dcc simul command which allows tcl to simulate a user typing a command, some scripts require it.
    Return to Index   Return to Set Cmds

    set flood-ctcp <#ctcps>[:<#seconds>]

    Specifies the flood threshold for CTCP queries (to the bot). If the same host dumps more than this many CTCPs to the bot within 60 seconds, they will be placed on automatic ignore. You can also specify the number of seconds to scan by adding that after a colon (:). If you set the number of ctcps to 0, you disable ctcp flood protection (including avalanche flood protection).

    See Also:  flood-msg
    Return to Index   Return to Set Cmds


    set flood-msg <#msgs>[:<#seconds>]

    Specifies the flood threshold for /MSG's. If the same host dumps more than this many /MSG's to the bot within 60 seconds, it is considered a flood and that host is put on automatic ignore. You can change the scanning time from 60 seconds by specifying the number of seconds after a colon (:). Setting the # of msgs to 0 turns off msg flood protection.
        examples:
          set flood-msg 10        (10 msgs in 60 seconds is a flood)
          set flood-msg 5:15      (5 msgs in 15 seconds is a flood)
          set flood-msg 0         (turns off msg flood protection)
        

    See Also:  Return to Index   Return to Set Cmds


    set force-channel <chan#>

    This specifies the channel to dumb users who have no stored console settings on, 0 is the party line, 1-99999 are global chat lines & 10000-19999 are bot-only chat lines.
    Return to Index   Return to Set Cmds

    set help-path <path>

    Specifies the path to the help/ directory for the bot. If you can read this, it was probably set right. :)
    Return to Index   Return to Set Cmds

    set hourly-updates <#>

    Allows you to set the minutes past the hour that the hourly event hooks will be called, this effects such things as note notfication.
    Return to Index   Return to Set Cmds

    set ident-timeout <#>

    Sets the number of seconds to wait before discarding an ident attempt for a connectiong user.
    Return to Index   Return to Set Cmds

    set info-party 0/1

    When set, this flag causes a users info line to be displayed to the *current* chat channel when they join it.
    Return to Index   Return to Set Cmds

    set ignore-time <#>

    Specifies how long (in minutes) a temporary ignore will last on the bot before being purged.

    See Also:  ignores +ignore set ban-time
    Return to Index   Return to Set Cmds


    set init-server <raw-irc-text>

    Specifies text to send to the server when first connecting there. This is usually used to set the bot's mode to +i or something equally unimportant.
    Return to Index   Return to Set Cmds

    set keep-all-logs <0/1>

    Specifies whether to keep logs older than 48 hours or not. If this is set off, at midnight, the current logfile will be re-named (logfile).yesterday and a new logfile started. The old (logfile).yesterday will be erased. If this is set on, at midnight, the current logfile will be renamed to (logfile).(date) and a new logfile started. Eventually your directory will be full of files like LameBot.log.14Jul94.
    Return to Index   Return to Set Cmds

    set keep-nick <0/1>

    Specifies whether the bot will keep trying to regain its nickname if it is forced to change nicks. If this is on, and you change the bot's nick on irc through a TCL script or the dump command, then the bot will change back to its intended nick within 60 seconds.

    See Also:  set nick, set altnick
    Return to Index   Return to Set Cmds


    set log-time <0/1>

    Specifies whether or not to time-stamp all log entries.
    Return to Index   Return to Set Cmds

    set lowercase-ctcp <0/1>

    Some IRC clients accept lowercase as well as uppercase CTCP's, changing this setting to 1 enables this.
    Return to Index   Return to Set Cmds

    set max-dcc <#>

    This sets the maximum number of dcc users you can have on the bot at any one time, this value can only ever be increased, and it always helps to have a few spare.
    Return to Index   Return to Set Cmds

    set max-dloads <#>

    Specifies the maximum number of downloads (dcc gets) a user can have going at once. To effectively disable this, set it to 99. The default is 3. When a user reaches this limit, she will be unable to 'get' any more files from the file area until either the current transfers complete, or any pending transfers eventually timeout.
    Return to Index   Return to Set Cmds

    set max-logs <#>

    This sets the maximum number of log files you can have at any one time, this value can only ever be increase, and it always helps to have a few spare.
    Return to Index   Return to Set Cmds

    set max-notes <#>

    Sets the maximum number of notes a user may have stored for them on the bot. Once this is full, no more notes will be accepted for the user.
    Return to Index   Return to Set Cmds

    set max-queue-msg <#>

    This sets the maximum number of messages the bot will store in EACH of it's message queues (it has 3) before it considers them full, and starts dropping messages.
    Return to Index   Return to Set Cmds

    set mod-path <path>

    Specifies the path to the modules directory for the bot, modules are chunks of C code that can be loaded & unloaded from the bot. If you're reading this, it's highly likely you've got this setup correctly, the default modules/ is usually sufficient.
    Return to Index   Return to Set Cmds

    set motd <filename>

    Specifies the Message Of The Day file. This should be a text file. It will be displayed to users as they enter a dcc chat session with the bot (so it shouldn't be TOO long). There are a few %-variables you can insert into the motd, which will be interpreted by eggdrop:
          %b   display bold
          %v   display inverse
          %_   display underline
          %f   display flashing via telnet, bold underline via irc
          %B   bot's nickname
          %V   current eggdrop version (ie, "eggdrop v1.3.19")
          %E   long form of %V (ie, "Eggdrop v1.3.19  (c)1997 Robey Pointer")
          %C   channels the bot is on
          %A   whatever is set in 'admin' (see 'set admin')
          %T   the current time (ie, "17:37")
          %N   the current user's nickname
          %U   the current operating system the bot is on
          %%   a percent sign ("%")
    You can also encode messages which can only be read by people with certain flags:
          %{+m}Only masters would see this.%{-}
          %{+1}Only people with user flag #1 see this.%{-}
          %{+b}This is only displayed to users doing a remote
               .motd from another bot.%{-}
          %{+|m}Only channel masters would see this.%{-} 
    Other extended % commands are:
          %{cols=N}     Start splitting output into N columns
          %{cols=N/W}   Same, but use a screen width of W
          %{end}        End columnated or restricted (ie %{+m}) block
          %{centre}     Center the following text (70 columns) 

    Return to Index   Return to Set Cmds

    set my-hostname <hostname>

    Overrides the network DNS name used by the bot to identify itself on servers, etc. This is only useful if your machine has multiple hostnames and you would like the bot to use a particular one, or if the bot has trouble detecting your hostname automatically.

    See Also:  my-ip
    Return to Index   Return to Set Cmds


    set my-ip <ip-address>

    Overrides the network IP used by the bot to identify itself over dcc connections. This is really only useful if your machine has multiple IPs and you would like the bot to use a particular one, or if the bot has trouble detecing your IP automatically.

    See Also:  my-hostname
    Return to Index   Return to Set Cmds


    set nat-ip <ip-address>

    If you are behind a NAT firewall, or using IP masquerading, you may have trouble with the bot dcc send'ing files to people, set this to your firewalls IP address to get around this problem.
    Return to Index   Return to Set Cmds

    set network <net-name>

    Names the IRC network you're connected to. (obviously, this only matters if the bot is on IRC.) It's just human-readable text that's shared with other bots on your botnet.
    Return to Index   Return to Set Cmds

    set never-give-up <0/1>

    Specifies whether the bot should loop forever. If never-give-up is set false, then the bot will shut down if it goes through the entire server list once without getting a connection. This is to keep eggdrop from going through an endless loop, if, for example, your machine gets disconnected from the rest of the net. However, some people prefer their bot to never shut down, no matter what.
    Return to Index   Return to Set Cmds

    set notefile <filename>

    Specifies the filename where bots should store notes that are sent to someone who isn't on the party line currently. Normally, you don't want to change this after the first time you load the bot. If you want to disable note storage, set this to "" (blank), or unload the notes module.
    Return to Index   Return to Set Cmds

    set note-life <#>

    Sets the number of days to hold a note before expiring it (erasing it from the bot).
    Return to Index   Return to Set Cmds

    set notify-newusers <nickname-list>

    Specifies who to inform when the bot gets introduced to new users via the /MSG HELLO command. Obviously this has no effect unless the /MSG HELLO command is activated. The bot will send a note to each user listed in notify-newusers.
    This can be just one nick:  set notify-newusers "Robey"
    or several, separated by commas: set notify-newusers "Guy, Eden@Priscilla"
    The default is HQ which stands for head quarters. If you don't want anyone to be informed, just leave it blank.
    Return to Index   Return to Set Cmds

    set open-telnets <0/1>

    Specifies whether to accept new users via a telnet connection. If set to 0, the bot will only accept telnet connections from people who already have user records. If set to 1, someone can enter NEW after telnetting to the bot, and create a new user record.
    Return to Index   Return to Set Cmds

    set owner <nickname-list>

    Specifies the user(s) who are to ALWAYS be bot owners. It is impossible to remove the +n flag from anyone listed here. If the bot was compiled with the owner flag turned off, this variable has no significance.
    Return to Index   Return to Set Cmds

    set private-global 0/1

    If you are sharing userfiles with someone else, and you don't want any global flags on the other bots propogated to your bot, set this. It overrides the setting of private-globals.

    See Also:  set private-owner, set private-globals
    Return to Index   Return to Set Cmds


    set private-globals [flags]

    If you are sharing userfiles with someone else, and you don't want various global flags on the other bots propogated to your bot, set this to the global flags you would like to remain unaffected. The setting of private-global will override this.

    See Also:  set private-owner, set private-global
    Return to Index   Return to Set Cmds


    set private-owner 0/1

    If you are sharing userfiles with someone else, and you don't want the owners on the other bots propogated to your bot, set this.
    NOTE: If you are sharing passively with someone you will lose *ALL* owners unless you also set the owner setting.

    See Also:  set owner , set private-global , set private-globals
    Return to Index   Return to Set Cmds


    set protect-telnet 0/1

    This setting, when enabled, only allows telnet connections from know user@host's. This prevents to some degree botscans. This also negates the use of open-telnet's since a new user can't even get to a prompt.
    Return to Index   Return to Set Cmds

    set quiet-reject <0/1>

    Some of the message & ctcp commands return negative messages to unknown users, whilst this is polite & usefull, it's also a possible detection method, enabling this will cause the bot to only send positive responses to know users.
    Return to Index   Return to Set Cmds

    set realname <text>

    Specifies the real name field to use on IRC. This usually shows up in a /WHOIS as the thing in parenthesis after some-one's user@host. It can be anything you want, but IRC sets a maximum length so it might get cut off if you set it too long.

    See Alsoset username
    Return to Index   Return to Set Cmds


    set remote-boots 0/1

    This config-file-only variable has 3 settings, 0 means dont allow anyone else to boot people of your bot, 1 means allow people on other sharebots to boot people of you bot, 2 means allow any bot to boot people of your bot.
    Return to Index   Return to Set Cmds

    set require-p <0/1>

    Specifies whether users with +o (global op) also need the +p flag to join the party line.
    Return to Index   Return to Set Cmds

    set resync-time <#>

    This sets the number of seconds to store resync information for a sharebot before it's assumed to be dead & buried, and therefore the userfile needs to be re-sent.

    See Also:  set allow-resync
    Return to Index   Return to Set Cmds


    set save-users-at <minute>

    Tells eggdrop when to save its userfile, which it does once an hour. This number will set the number of minutes after the top of the hour to write the userfile -- for example, setting it to 15 will make the bot write its userfile at 3:15, 4:15, etc.

    See Also:  switch-logfiles-at
    Return to Index   Return to Set Cmds


    set server

    This read-only variable returns the current server of the bot.
    Return to Index   Return to Set Cmds

    set server-cycle-wait <#>

    This sets the number of seconds to wait between successive server connects, this can be used to prevent the throttling problems with irc & connecting to quickly.
    Return to Index   Return to Set Cmds

    set servers <server-list>

    Gives the bot a list of servers to use for IRC. You can change this at any time on the fly, but if the bot's current IRC server (the one it's on right now) isn't in your new list, it will be added, to maintain coherency. Here's an example:
           set servers {  goblin.irc.com:6667
                          dragon.irc.org
                       }
        
    Note that if you omit the port, it will assume the value of the default-port setting.

    S