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 aboutThe
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: note,
whom
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 ,
reload,
restart
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: set, channel,
debug
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 Also: set 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