Здесь находится переведенное на русский язык описание функций, которые можно использовать при создании скриптов на языке TCL. Всего существует 2 типа команд: встроенные в сам TCL (независимый язык программирования) и команды, доступные для TCL-скриптов на ботах. Взять эту станицу в виде .TXT файла можно по адресу http://bot.net.ru/tcl-commands.rus.html Перевод выполнен: . . . . . . . . . . Дмитрий Бородин (www.bot.net.ru) Канал по PHP/TCL: . . . . . . . . . . . . . . #PHPclub, eu.undernet.org ПОСЛЕДНЕЕ ИЗМЕНЕНИЕ: . . . . . . . . . . . . . . . . . . . 05.11.2002 Перевод был: . . . . . . . . . . . . . . . . . . . . начат 20.06.2001 закончен 04.06.2002 Свежую версию и другую документацию можно скачать на сайте поддержки ботов: http://bot.net.ru/. Есть вопросы или предложения? Заходите в форум на сайте. Примечание к переводу: 1. Функции со словами EXEMPT/INVITE/JUPED не применяют в обычных ИРЦ сетях (например UNDERNET), поэтому назначение их мне не известно, перевода нет. Эти функции требует от IRC сервера особых флагов +e и +I, чего в большинстве сетей нет. Все остальные функции переведены. 2. Хоть это и не описано, но большинство функций генерируют TCL ошибку, если попытаться произвести операцию с несозданным каналом или несуществующим пользователем. Не забывайте проверять наличие канала функцией validchan <channel> и существование юзера - validuser <handle> 3. Это не сухое/краткое/непонятное изложении теории. Я стараюсь по дороге объяснять многие сопутствующие вещи, так что это не формальный перевод документации, а статья об использовании всех функциий бота и недокументированных особенностей, которые мне самому приходилось открывать, чтобы добиться работоспособности программ. Существует великое множество ограничений и тонкостей в привлекательном на первый вид TCL в ботах EggDrop. 4. Существует русский перевод документации самого TCL. Если у вас тоже проблемы с английским, то изучить сам TCL без русского мана будет весьма трудно... Ссылка на русский ман TCL см. на http://bot.net.ru/bot.php 5. Данный файл криво выглядит из Оперы. Если у вас Опера - просто сохраните на диск и переименуйте в ".txt". В NN или IE никаких проблем. ************************************************************************* / Краткое содержание вступления: / Здесь находится полный список всех TCL команд, добавленных в eggdrop. Важно: этот список корректно работает только на ботах версии 1.5 и выше! Скрипты написанные для ботов 1.3/1.4 должны быть немного изменены, чтобы быть работоспособными на новых ботах. СКРИПТЫ НАПИСАННЫЕ ДЛЯ БОТОВ ВЕРСИЙ 0.9, 1.0 ИЛИ 1.1 НЕ БУДУТ РАБОТАТЬ БЕЗ СУЩЕСТВЕННЫХ ИЗМЕНЕНИЙ. ######################################################################### ######################################################################### ### ### ### Функции для отправки серверу или в логи команд/сообщений ### ### ### ######################################################################### ######################################################################### putserv <text> [options] sends text to the server, like 'dump' (intended for direct server commands); output is queued so that you won't flood yourself off the server options are: -next push messages to the front of the queue returns: nothing Послать текст серверу. Сообщение откладывается в очередь, т.к. вы не должны (случайно/нарочно) зафлудить сервер (если бы не было очереди, бота бы постоянно отключало с сообщением Excess flood). Если на очереди более одного сообщения (скажем, 10), то бот сначала отсылает первых 3 сообщения с паузой 0.5 сек, далее по сообщению через каждые 1.9 секунд. Эта и следующие очереди имеют размер примерно в 2-5 тысяч сообщений. *опции: -next поместить сообщение в начало очереди *везврат: ничего puthelp <text> [options] sends text to the server like 'putserv', but uses a different queue (intended for sending messages to channels or people) options are: -next push messages to the front of the queue returns: nothing послать текст серверу, подобно функции putserv, но используюя другую очередь (предполагается для отправки сообщений в канала или человеку, т.е. для какой-то не важной информации). Приоритет у функции ниже, чем у putserv, а сами собщения из очереди отсылаются не чаще одного раза в 2.0 секунды. *опции и возврат: см. putserv putquick <text> [options] sends text to the server, like 'dump' (intended for direct server commands); output is queued so that you won't flood yourself off the server, using the MODE queue (should be alot faster) options are: -next push messages to the front of the queue returns: nothing послать текст серверу (предполагается для прямых серверных команд); вывод откладывается в очередь "MODE". Приоретет у этой функции выше, чем у putserv. Если в очереди более одного сообщения, то бот отсылает мгновенно первых 4 (с мизерной паузой в 0.1 сек), затем с частотой, не быстрее одного сообщения в 1.9 секунды, рассылает остаток. Как видно из трех функций для отправки текста из бота в IRC ваша программа не сможет никакими способами зафлудить сервер. Однако во время лага с сервером явление "Excess flood" возможно (и изредка наблюдается). *опции и возврат: см. putserv putkick <channel> <nick,nick,...> [reason] sends kicks to the server and tries to put as many nicks into one kick command as possible. returns: nothing послать серверу команды для киков нескольких ников putlog <text> sends text to the log for any channel, marked as 'misc' (o) returns: nothing записать в лог текст, который классифицируется как 'misc' ("o" - флаг для отлавливания таких сообщений) putcmdlog <text> sends text to the log for any channel, marked as 'command' (c) returns: nothing послать текст в лог, маркируемый флагом 'c' (используется для лога выполнения команд) putxferlog <text> sends text to the log for any channel, marked as 'file-area' (x) returns: nothing послать текст в лог, маркируемый флагом 'x' (используется для лога выполнения команд в файловой области бота) putloglev <level(s)> <channel> <text> sends text to the log, tagged with all of the valid levels given (use "*" to indicate all log levels) returns: nothing послать текст во все логи (которые кто-то ловит) используя первый параметр как набор флагов. "*" замещает любой флаг (текст отразиться во всех логах). "Ловить логи" могуть только 2 объекта: боты, которые выполняют инструкцию от команды logfile и складывают все в соотв. файлы, и люди, которые с помощью ".console ххх" в боте настроили себе прием логов определенного типа - комбинации из флагов и названии канала (либо "*" - чтобы принять все). dumpfile <nick> <filename> dumps out a file from the help/text directory to a user on IRC via msg (one line per msg); the user has no flags, so the flag bindings wont work within the file. послать содержимое файла из каталога help/text человеку, используя /msg $nick ... (одна строка - одно /msg сообщение) queuesize [queue] returns: the number of msgs in all queues. If a queue is specified, only the size of this queue is returned. valid queues are: mode, server, help. вернет кол-во сообщений в очереди. Если очередь особая, то вернет ее размер. Очереди бывают: mode, server, help (см. соотв. putquick/pushmode, putserv, puthelp). Возьмите себе за правило, не выполнять какие-то общедоступные команды типа !ping или !seen, если очередь сообщений больше определенного размера (скажем, в 5 накопившихся и еще неотправленных сообщений). clearqueue <queue> returns: number of deleted lines from the specified queue очистить очередь по кодовому имени (mode/serv/help), вернет кол-во удаленных строк. Это не документировано, но при использовании 'clearqueue all' очищаются сразу все очереди. ######################################################################### ######################################################################### ### ### ### Функции для работы с базой пользователей ### ### ### ######################################################################### ######################################################################### countusers returns: number of users in the bot's database вернет кол-во юзеров в базе validuser <handle> returns: "1" if a user by that name exists; '0' otherwise вернет 1, если ханд (юзер) существует, иначе 0 finduser <nick!user@host> finds the user record which most closely matches the given user@host returns: the handle found, or "*" if none вернет первую найденный ханд по маске и "*" в противном случае userlist [flags] returns: a list of the handles of users on the bot you can use the new flag matching system here, usage: [global]{&/|}[chan]{&/|}[bot] matchs the flags relvantly, (chan matches vs anywhere), & specifies and when match, | specifies or, only the first of these is relevant the default is or. вернет список хандов, флаги которых удовлетворяют маске. Правила использования комбинации флагов см. в ФАКе. Например, флаг "o|" - глобал опы/мастера/вледельцы, "|m-n" - мастеры каких-то каналов, "|mf" - люди с флагом "m" или "f" (операция ИЛИ), "&mf" - люди с флагами и "m" и "f" (операция И). passwdok <handle> <pass> checks the password given against the user's password check against the password "" (a blank string) or "-" to find out if a user has no password set. returns: "1" if password matches for that user; "0" if not проверит, что у ханда верный пароль (получить пароль юзера нельзя, только можно сверить его с чем-нибудь) и вренет 1, иначе 0 getuser <handle> <entry-type> [extra info] this is a generic interface to the new generic userfile support, it return info specific to each entry-type, valid entry types are: BOTFL - returns the current bot-specific flags for the user (if it's a bot :) BOTADDR - (another bot-only thing :) returns a list containing the bots address, the bots telnet port, and it's relay port. HOSTS - returns a list of the host for the user LASTON - returns a list containing the unixtime last seen, and the last seen place. OR LASTON #channel returns the time last seen on the channel or 0 if no info INFO - returns the user's global info line XTRA - returns the old xtra info COMMENT - returns the master-visible only comment for the user EMAIL - returns the users email address URL - returns the users url address HANDLE - returns the users handle as it is saved in the userfile это главная функция по получению информации о ханде BOTFL - флаги бота (ханд должен быть ботом) У ботов присутствуют и обычные флаги, что и у юзеров. BOTADDR - вернет адрес бота, его телнет и бот порты (см. ".help +bot" для подробностей) HOSTS - вернет список хостов LASTON - вернет 0, если бот никогда юзера не видел, либо список из времени(unixtime) и места. Место - название канала или partyline. INFO - вернет глобал инфо-строку XTRA - вернет дополнительный параметр (getuser <hand> XTRA <имя>, см. описание ниже) COMMENT - вернет комментации, которые видны по .whois только мастерам Информацию в поле записывает сам бот, если кому-то мстит из-за опций защиты себя(бота) или друзей EMAIL - вернет поле е-мейла URL - вернет поле УРЛ HANDLE - вернет имя, под которым юзер записан в базе setuser <handle> <entry-type> [extra info] this is the counterpart of getuser, it lets you set the various values extra ones not supported about : PASS - use this to set a users password (no 3rd arg will clear it) HOSTS - for setting hosts, no extra info = clear, otherwise *1* hostmask is added :P LASTON - 2 forms: setuser <handle> laston <unixtime> <place> sets global laston time setuser <handle> laston <unixtime> sets global laston time, leaving the place field empty setuser <handle> laston <unixtime> <channel> will set a users laston time in a channel record (if it already exists) установка информации о пользователе, аналогичная фунция PASS - установить пароль. Физически пароль шифруется и заисывается в юзер лист. Шифровка гарантирует, что без полного перебора разных паролей угадать оригинальный пароль невозможно, см. описание функций encpass и md5. HOSTS - если 3й параметр не задан - очистить список хостов если задан, то он является хостом, который добавится к списку хостов юзера (setuser <hand> HOSTS <новый хост>) существует возможность писать что-угодно (value) под любым имем (name) в специальные поля: setuser <hand> XTRA <name> <value> Это не документировано, но максимальная длина 'name'+'value' где-то в районе не менее 500 символов. Часто бывают ошибки, когда программа пишет очень длинные строки, которые бот обрезает при записи. Данный способ очень удобен, чтобы хранить вечные переменные, да еще и привязанные к каким-то пользователям. Если установить "", переменная стирается. Чтобы хранить большие переменные (также вечно) и не волноваться о их длине см. http://bot.net.ru/tcl-rus.php Чтобы читать такую переменную используйте getuser <hand> XTRA <name>, описана выше. setuser <botHandle> botattr address [botport] [userport] Недокументированные возможности setuser: эта функция может изменить не только PASS, HOSTS и LASTON, а так же и другие поля (см. getuser). Изменить адрес (+порт) уже у существующего бота может только эта функция. Можно, конечно, удалить бот и сразу создать, но иногда удалять невозможно, т.к. можно потерять какую-либо информацию (аксесс бота на каналах). Из чата бота изменить адрес легко (комнда .chaddr). Собственно в поисках измения адреса бота без удаления и открыта данная возможность. | chhandle <old-handle> <new-handle> | changes a user's handle | returns: "1" on success; "0" if the handle is already used, the handle | is invalid, or the user can't be found переименовать юзера. Вернет 1 в лучае успеха и 0 при неудачи (попытка изменить свое имя на уже существующего юзера или др. ошибки) chattr <handle> [changes [channel]] changes the attributes for a user record, if you include any -- changes are of the form "+f", "-o", "+dk", "-o+d", etc; if a channel is specified, the channel-specific flags for that channel are altered you can now use the +o|-o #channel format here too. returns: new flags for the user (if you made no changes, returns current flags); if a channel was specified, the global AND the channel-specific flags for that channel are returned in the format of the new flagging system (globalflags|channelflags) -- returns "*" if that user does not exist устновить флаги для пользователя, либо глобальные (канал не нужно писать), либо на канале (3 параметра). Понимает комбинации флагов. Чтобы не перепутать локальные и глобальные флаг, всегда у локальных прав ставьте черту: chattr <hand> |+o <#channel> (иначе будет глобал-флаг!) *везврат: если указать флаги, вернет новое состояние флагов (глобальных или локальных), если не указать никаких флагов, например chattr <hand> |- <#chan>, то вернет текущи флаги, ничего не меняя. botattr <handle> [changes [channel]] similar to chattr except for bot attributes rather than normal user attributes, this includes the channel-specific +s share flag тоже, но для бота (у ботов совершенно другой набор глобальных флагов и флагов канала) matchattr <handle> <flags> [channel] returns: "1" if the specified user has the matching flags. (using the new matching system) главная функция по проверке доступа юзера (глабально или в канале) Правила комбинирования флагов см. в chattr & userlist. adduser <handle> <hostmask> creates a new user entry with the handle and hostmask given (with no pass- word, and the default flags) returns: "1" if successful, "0" if it already existed добавить юзера, хостмаска параметр не обязательных (хоть в документации написано обязательно). Новый юзер не имеет ни пароля, ни хостов, ни флагов (вернее, устанавливаются флаги по умолчанию - см.eggdrop.conf) *возврат: 1 в случае успеха, 0 - если юзер уже существует addbot <handle> <address> creates a new bot entry with the handle and bot linking address given (with no password and no flags) returns: "1" if successful, "0" if it already existed аналогична команде adduser, за исключением формата address. Его формат см. ".help +bot". Пример: "addbot ИмяБота {АдресБота БотПорт ЮзерПорт}" *возврат: 1 в случае успеха, 0 - если бот уже существует deluser <handle> attempts to erase a user record with that handle returns: "1" if successful, "0" if no such user exists удалить юзера или бота (без разницы) *возврат: 1 в случае успеха, 0 - если юзера несуществует delhost <handle> <hostmask> deletes a hostmask from a user's hostmask list returns: "1" on success, "0" if that hostmask wasn't in the list or the user does not exist удалить хост из списка хостов у юзера. Используйте "setuser <hand> HOSTS" для удаления всех хостов сразу. *возврат: 1 в случае успеха, 0 - если хоста такого несуществовало addchanrec <handle> <channel> add a channel record for the user returns: "1" on success, "0" if the user does not exist or if there isn't such a channel добавить запись о канале, где храняться права и инфо-строка для канала. Создается автоматически, если добавить на какой либо канал права юзеру. delchanrec <handle> <channel> removes a channel record for the user; this includes all associated channel flags returns: "1" on success, "0" if the user does not exist or if there isn't such a channel удалить запись о канале с правами и инфо строкой getchaninfo <handle> <channel> returns: info line for a specific channel (behaves just like 'getinfo') получить инфо-строку у юзера для канала setchaninfo <handle> <channel> <info> sets the info line on a specific channel for a user if info is "none" it will be removed. returns: nothing установить юзеру инфо-строку для конкретного канала. Будьте осторожны, строка весьма короткая. Чтобы установить глобал-инфо-строку: setuser <hand> INFO <info-line>. ГлобалИнфо показывают при входе в чат бота ("[$nick] ..info.." идет в партилайн) newchanban <channel> <ban> <creator> <comment> [lifetime] [options] adds a ban to the enforced ban list of a channel; creator is given credit for the ban in the ban list; lifetime is specified in minutes; if lifetime is not specified, ban-time (usually 60) is used; setting the lifetime to 0 makes it a permanent ban; valid options are: sticky forces the ban to be always active on a channel, even with dynamic bans on none (no effect) returns: nothing создать новый бан на канале. ban - хост маска для бана, creator - кто установил бан, comment - комментарий (возможно, его используют при кике), lifetime- время жизни бана в минутах, если не задано то время по умолчанию (eggdrop.conf). Если время рано 0, то это вечный бан опции: sticky - бот будет держать бан постоянно активным. Если кто-то (кроме мастера канала) попытается снять бан, бот его переустановит. Помните о лимите банов в одном канале Если сделать деоп+оп боту, бот выставит все баны повторно (т.е. будет следить за активностью бана). none - по умолчанию, бан не будет активным, а только при необходимости, когда кого-то надо выкинуть. Время, через которое бан будет снят (не из памяти, а с канала) устаналивается в eggdrop.conf, по умолчанию - 2 часа. newban <ban> <creator> <comment> [lifetime] [options] adds a ban to the global ban list (which takes effect on all channels); other arguments work exactly like newchanban returns: nothing добавить глабал бан (как будто бы вы создали локальные баны на всех каналах сразу). Формат см. выше. newchanexempt <channel> <exempt> <creator> <comment> [lifetime] [options] adds a exempt to the enforced exempt list of a channel; creator is given credit for the exempt in the exempt list; lifetime is specified in minutes; if lifetime is not specified, exempt-time (usually 60) is used; setting the lifetime to 0 makes it a permanent exempt; valid options are: sticky forces the exempt to be always active on a channel, even with dynamicexempts on none (no effect) returns: nothing N.B. The exempt will not be removed until the corresponding ban has been removed. For timed bans once the time period has expired the exempt will not be removed until the corresponding ban has either expired or removed newexempt <exempt> <creator> <comment> [lifetime] [options] adds a exempt to the global exempt list (which takes effect on all channels); other arguments work exactly like newchanexempt returns: nothing newchaninvite <channel> <invite> <creator> <comment> [lifetime] [options] adds a invite to the enforced invite list of a channel; creator is given credit for the invite in the invite list; lifetime is specified in minutes; if lifetime is not specified, invite-time (usually 60) is used; setting the lifetime to 0 makes it a permanent invite; valid options are: sticky forces the invite to be always active on a channel, even with dynamicinvites on none (no effect) returns: nothing N.B. The invite will not be removed until the channel has gone -i. newinvite <invite> <creator> <comment> [lifetime] [options] adds a invite to the global invite list (which takes effect on all channels); other arguments work exactly like newchaninvite returns: nothing stick <banmask> [channel] makes a ban sticky, or if a channel is specified, then it is set sticky on that channel. returns: "1" is successful, "0" otherwise unstick <banmask> [channel] makes a ban no longer sticky, or if a channel is specified, then it is unstuck on that channel. returns: "1" is successful, "0" otherwise | stickexempt <exemptmask> [channel] | makes an exempt sticky, or if a channel is specified, then it is set | sticky on that channel. returns: "1" is successful, "0" otherwise | unstickexempt <exemptmask> [channel] | makes an exempt no longer sticky, or if a channel is specified, then it | is unstuck on that channel. returns: "1" is successful, "0" otherwise | stickinvite <invitemask> [channel] | makes an invite sticky, or if a channel is specified, then it is set | sticky on that channel. returns: "1" is successful, "0" otherwise | unstickinvite <invitemask> [channel] | makes an invite no longer sticky, or if a channel is specified, then it | is unstuck on that channel. returns: "1" is successful, "0" otherwise killchanban <channel> <ban> removes a ban from the enforced ban list for a channel returns: "1" if successful, "0" otherwise удалить бан канала по его номеру (все баны нумеруются автоматически), либо по самой маске. Бан при удалении снимается с канала (если он там был). Невозможно поставить бан на существующую маску (например, с целью добавить времени), не сняв его предварительно. При операции удаления бана этой функции и мгновенной установки того же бана, в канале наблюдается побочный эффект (бот снимает бан). killban <ban> removes a ban from the global ban list returns: "1" if successful, "0" otherwise удалить глобальный бан по номеру или маске killchanexempt <channel> <exempt> removes a exempt from the enforced exempt list for a channel returns: "1" if successful, "0" otherwise killexempt <exempt> removes a exempt from the global exempt list returns: "1" if successful, "0" otherwise killchaninvite <channel> <invite> removes a invite from the enforced invite list for a channel returns: "1" if successful, "0" otherwise killinvite <invite> removes a invite from the global invite list returns: "1" if successful, "0" otherwise ischanjuped [channel] returns: "1" if the channel is juped and bot is unable to join, "0" otherwise isban <ban> [channel] returns: "1" if that ban is in the global ban list, "0" otherwise; if a channel is specified, that channel's ban list is checked too установлен ли бан (маска) как глобальный или в канале (не в реальном ИРЦ-канале, а в памяти бота для банов) ispermban <ban> [channel] returns: "1" if that ban is in the global ban list AND is marked as permanent, "0" otherwise; if a channel is specified, that channel's ban list is checked too тоже, что и isban, с условием: является ли бан вечным см. newchanban isexempt <exempt> [channel] returns: "1" if that exempt is in the global exempt list, "0" otherwise; if a channel is specified, that channel's exempt list is checked too ispermexempt <exempt> [channel] returns: "1" if that exempt is in the global exempt list AND is marked as permanent, "0" otherwise; if a channel is specified, that channel's exempt list is checked too isinvite <invite> [channel] returns: "1" if that invite is in the global invite list, "0" otherwise; if a channel is specified, that channel's invite list is checked too isperminvite <invite> [channel] returns: "1" if that invite is in the global invite list AND is marked as permanent, "0" otherwise; if a channel is specified, that channel's invite list is checked too isbansticky <ban> [channel] returns: "1" if that ban is a sticky ban in the global ban list, "0" otherwise; if a channel is specified, that channel's ban list is checked too тоже, что и isban, с условием: является ли бан постоянным см. newchanban isexemptsticky <exempt> [channel] returns: "1" if that exempt is a sticky exempt in the global exempt list, "0" otherwise; if a channel is specified, that channel's exempt list is checked too isinvitesticky <invite> [channel] returns: "1" if that invite is a sticky invite in the global invite list, "0" otherwise; if a channel is specified, that channel's invite list is checked too matchban <nick!user@host> [channel] returns: "1" if that user address matches a ban in the global ban list, "0" otherwise; if a channel is specified, that channel's ban list is checked too проверить, попадает ли юзер с хостмаской под глобальный бан или бан в канале matchexempt <nick!user@host> [channel] returns: "1" if that user address matches a exempt in the global exempt list, "0" otherwise; if a channel is specified, that channel's exempt list is checked too matchinvite <nick!user@host> [channel] returns: "1" if that user address matches a invite in the global invite list, "0" otherwise; if a channel is specified, that channel's invite list is checked too banlist [channel] returns: list of global bans, or (if a channel is specified) list of channel-specific bans; each entry is itself a list, containing: hostmask, comment, expiration timestamp, time added, last time active, and creator (the three timestamps are in unixtime format) вернет глобальный список банов или баны канала (не реальных ИРЦ каналов, а из памяти бота) exemptlist [channel] returns: list of global exempts, or (if a channel is specified) list of channel-specific exempts; each entry is itself a list, containing: hostmask, comment, expiration timestamp, time added, last time active, and creator (the three timestamps are in unixtime format) invitelist [channel] returns: list of global invites, or (if a channel is specified) list of channel-specific invites; each entry is itself a list, containing: hostmask, comment, expiration timestamp, time added, last time active, and creator (the three timestamps are in unixtime format) newignore <hostmask> <creator> <comment> [lifetime] adds an entry to the ignore list; creator is given credit for the ignore; lifetime is how many minutes until the ignore expires and is removed; if lifetime is not specified, ignore-time (usually 60) is used; setting the lifetime to 0 makes it a permanent ignore returns: nothing добавить хостмаску для игнора. Люди с такими масками будут игнорироваться ботом при отправке /msg и публичных команд, ctcp, etc. creator - кто добавил comment - комментарий lifetime - время в минутах или 0 - для вечного игнора см. ".+ignore" Если вы хотите вставить защиту от множества флуд ботов (с небольшим числом флуд ботов ваш бот сам справиться), то на странице http://bot.net.ru/irc.php описаны 2 типа игноров: всего текста со всех каналов и всех сообщений (/msg bot). Дело в том, что на IRC под каждого юзера (бота/человека) заведен буфер входных сообщений, примерно в 64Кбайта. Если на канал входит сотня флуд-ботов и каждый в бесконечном цикле шлет в канал сообщение (максимум 510 букв), то данный буфер быстро переполняется и бота отключают от IRC с сообщением "Send maxQ". Ботам на крутых выделенных линях это не грозит, т.к. как бы быстро не наполнялся бы буфер, по хорошей линии все сообщения еще быстрее уйдут к боту и переполнения не будет. Хотя если командой "/stats k" запросить от сервер список активных серверных банов (K-LINES), то сам сервер поместит в буфер очень много информации, заметит переполнение и тут же отключит. Более подробно - по указанному адресу. killignore <hostmask> removes an entry from the ignore list returns: "1" if successful, "0" otherwise удалить хостмаску из игнор-листа см. ".-ignore" ignorelist returns: list of ignores; each entry is itself a list, containing: hostmask, comment, expiration timestamp, time added, and creator (the three timestamps are in unixtime format) получить игнор-лист хостмасок см. ".ignore" isignore <hostmask> returns: "1" if the ignore is in the list, "0" otherwise проверить, ялвяется ли хостмаска элементом списка игнор-листа save writes the userfile to disk returns: nothing сохранить базу юзеров и список каналов с настройками в файлы на диске. Это происходит автоматически, раз в 10 минут. см. ".save" reload loads the userfile from disk (replacing whatever's in memory) returns: nothing уничтожить базу юзеров и списки каналов и загрузить их из созранных ранее файлов см. ".reload" - это своеобразный откат базы данных. Можно что-либо сделать и откатить изменения. backup makes a simple backup of the userfile that's on disk returns: nothing записать базу юзеров в файл "<bot.users>~bak" (сделать копию базы в запасном файле) getting-users returns: "1" if the bot is currently downloading a userfile from a sharebot (and hence, user records are about to drastically change), "0" if not вернет 1, если в данный момент проиходит загрузка юзерлиста с расшаренного мастер-бота (если вы не в курсе про это - то вам это и не надо) ######################################################################### ######################################################################### ### ### ### Функции для управления каналами ### ### ### ######################################################################### ######################################################################### channel add <name> <option-list> adds a channel record for the bot to monitor; the full list of possible options is given in the "eggdrop.complete.conf" sample config file; note that the channel options must be in a list (enclosed in {}) returns: nothing добавить канала. Чтобы ознакомиться с форматом параметров (это необязательый параметр), см. примеры в eggdrop.conf. Так же, как и в eggdrop.conf, перечисляйте параметры через пробел или \n, заключив все в кавычки или фигурные скобки. Описание параметров канала на русском языке: http://bot.net.ru/flags.html Примеры: channel all #PHPclub channel all #PHPclub +inactive - создать канал, но не позволить боту туда сразу же войти channel set <name> <options...> sets options for the channel specified; the full list of possible options is given in the "eggdrop.conf" sample config file returns: nothing тоже, что и 'channel add', но уже для существующего канала channel info <name> returns: list of info about that channel record: enforced mode, idle kick limit, need-op script, need-invite script, and then various +/- options as seen in the config file получить параметры канала, см. 'channel add' channel remove <name> destroys a channel record for the bot and makes the bot no longer monitor that channel returns: nothing удалить канал savechannels saves the channel settings to the channel-file if one is defined. returns: nothing сохранить базу каналов в файл каналов, см. 'save' loadchannels reloads the channel settings from the channel-file if one is defined. returns: nothing загрузить базу каналов из файл каналов, см. 'load' channels returns: list of the channels the bot is monitoring (or trying to) вернуть список каналов, которые мониторит бот (но не обязательно, что бот сидит на канале) | channame2dname <channel-name> | chandname2name <channel-dname> | These two functions are important to correctly support !channels. The | bot differentiates between channel description names (chan dnames) and | real channel names (chan names). The chan dnames are what you would | normally call the channel, e.g. `!channel'. The chan names are what | the IRC server uses to identify the channel, they consist of the chan | dname prefixed with an ID, e.g. `!ABCDEchannel'. | | For bot functions like isop, isvoice, etc. you need to know the chan | dnames. If you communicate with the server, you usually get the chan | name though. That's what you need the channame2dname function for. | | If you only have the chan dname and want to directly send raw server | commands, you need the chan name. Use the chandname2name function for | that case. | | NOTE: For non-!channels, chan dname and chan name are the same. isbotnick <nick> returns: "1" if the nick matches the botnick; "0" otherwise вернет 1, если ник совпадает с ником бота (его самого) Примеры: имя бота TAHK, но в канале ASD: isbotnick TAHK -> 0 isbotnick ASD -> 1 имя бота TAHK и в канале TAHK: isbotnick TAHK -> 1 isbotnick ASD -> 0 botisop <channel> returns: "1" if the bot is an op on that channel; "0" otherwise вернет 1, если бот в накале и имеет там оп botisvoice <channel> returns: "1" if the bot is has a voice on that channel; "0" otherwise вернет 1, если бот в канале и с "голосом" botonchan <channel> returns: "1" if the bot is on that channel; "0" otherwise вернет 1, если бот находится на канале isop <nickname> <channel> returns: "1" if someone by that nickname is on the channel and has chop; "0" otherwise вернет 1, если ник в канале и имеет оп | wasop <nickname> <channel> | returns: "1" if someone that just got opped/deopped in the chan had op | before the modechange; "0" otherwise isvoice <nickname> <channel> returns: "1" if someone by that nickname is on the channel and has voice (+v); "0" otherwise аналогично isop onchan <nickname> <channel> returns: "1" if someone by that nickname is on the bot's channel; "0" otherwise вернет 1, если ник в канале nick2hand <nickname> [channel] returns: handle of <nickname> on <channel> if <channel> is not specified, bot will check all of its channels if <nickname> not found, returns "" if <nickname> found but unknown, returns "*" вернет ханд по нику. Параметр #chan необязательный. Если ник вообще не найден, вернет пустую строку "". Если ник найден, но не соответствует ни одному ханду - "*". handonchan <handle> <channel> returns: "1" if the the user@host for someone on the channel matches for the handle given; "0" otherwise вернет 1, если кто-то на канале подходит под ханд, сравнивая всех по user@host. hand2nick <handle> [channel] returns: nickname of the first person on the <channel> whose user@host matches that handle, if there is one; "" otherwise if <channel> is not specified, bot will check all of its channels вернет ник по ханду. Параметр #chan необязательный. Если никто не найден, вернет "". Поиск осуществляется по user@host. ischanban <ban> <channel> returns: "1" if that is a ban on the bot's channel вернет 1, если на канале (ИРЦ канале, а не в памяти бота) установлен бан (требуется точное совпадение) ischanexempt <exempt> <channel> returns: "1" if that is an exemption (+e mode) on the bot's channel. this is only useful on networks that support +e ischaninvite <invite> <channel> returns: "1" if that is an invitation (+I mode) on the bot's channel. this is only useful on networks that support +I chanbans <channel> returns: a list of the current bans on the channel, each element is of the form {ban bywho age} age is seconds from the bots POV вернет список банов канала. Каждый элемент списка - это список из 3х элемнтов: {бан кто_поставил время}, время в секундах. Важно: это не время unixtime, а кол-во секунд назад, когда был поставлен бан. chanexempts <channel> returns: a list of the current exemptions (+e mode) on the channel, each element is of the form {exemption bywho age} age is seconds from the bots POV. this is only useful on networks that support +e chaninvites <channel> returns: a list of the current invitations (+I modes) on the channel, each element is of the form {invitation bywho age} age is seconds from the bots POV. this is only useful on networks that support +I resetbans <channel> removes all bans on the channel that aren't in the bot's ban list, and refreshes any bans that should be on the channel but aren't returns: nothing снять на калале все баны, которые не являются банами самого бота. Т.е. те баны, что установили бругие боты или люди будут сняты. Список банов бота не меняется. resetexempts <channel> removes all exemptions on the channel. this is an IRCNET feature. resetinvites <channel> removes all invitations on the channel. this is an IRCNET feature. resetchan <channel> rereads in the channel info from the server returns: nothing записать для канала настройки по умолчанию, из eggdrop.conf, см. 'channel add' getchanhost <nickname> [channel] returns: user@host of <nickname> if <channel> is not specified, bot will check all of its channels if <nickname> is not on the channel(s), returns "" вернет user@host по нику, если канал не указан - поиск ника на всех каналах, если указан - только на указанном. Если ник не найден, вернет "". getchanjoin <nickname> <channel> returns: timestamp of when that person joined the channel вернет время (unixtime) входа ника в канал. Если юзера там вообще нет, вернет TCL ошибку. onchansplit <nick> <channel> returns: "1" if that nick is split from the channel; "0" otherwise вернет 1, если ник покинул данный канал из-за сплита (о том, что человек ушел по сплиту сообщает сервер) chanlist <channel> [flags[&chanflags]] flags are any flags that are global flags, the '&' denotes to look for channel specific flags. Examples: n (Botowner) &n (Channel owner) o&m (Global op, Channel master) now you can use even more complex matching of flags, including +&- flags and & or | (and or or) matching returns: list of nicknames currently on the bot's channel that have all of the flags specified; if no flags are given, all of the nicknames are returned Please note, that if you're executing chanlist after a part or sign bind, the gone user will still be listed so you can check for wasop, isop, etc. получить список людей канала, возможно отфильтровав по общему правилу задания флагов getchanidle <nickname> <channel> returns: number of minutes that person has been idle; "0" if the speci- fied user isn't even on the channel получить время неактивности (ничего не сказал) человека в канале. getchanmode <channel> returns: string of the type "+ntik key" for the channel specified получить текущие флаги канала в виде стандартной строки (там может быть ключ и лимит). Примеры: "+" (пусто), "+n", "+ntm", "+ntk key", "+l 10", "+ntkl key 10". jump [server [port [password]]] jumps to the server specified, or (if none is specified) the next server in the list returns: nothing переконнектиться к другому ИРЦ серверу. Если сервер не указан, то выбрать следующий из списка серверов (eggdrop.conf) pushmode <channel> <mode> [arg] sends out a channel mode change (ex: pushmode #lame +o goober) through the bot's queueing system; all the mode changes will be sent out at once (combined into one line as much as possible) after the script finishes, or when 'flushmode' is called послать серверу команду изменения mode, это удобнее, чем использоваться putserv "MODE $chan : ....". Используется системная очередь сообщений (mode). Это значит, что если боту позволено комбинировать mode команды, то бот будет преобразовывать команды из очереди к наименьшему возможному числу команд, для конечной отправки IRC серверу. Например, если сказать 'pushmode $chan $nick +o' и сразу добавить флаг '+v' второй командой, то реально получиться только одна IRC-команда. Если вы попробуете забанить и кикнуть человека, то скорее всего из-за описанных особенностей вам это не получится, вернее сначала IRC сервер получит от бота КИК, а только потом БАН. Очевидно, что жертва бота может войти за это время. Чтобы такого не произошло, не используйте pushmode для установки кик/бана. Это можно сделать так: putquick "mode $chan -o+b <ник> <маска>", затем кик putquick "kick .." В остальных случаях (установка опа/других флагов, снятие банов и т.п.) функцию рекомандуется к применению. flushmode <channel> forces all previously pushed channel mode changes to go out right now, instead of when the script is done (just for the channel specified) немедленно отправить очередь mode-команд, сформированных pushmode, на сервер. В противном случае бот сделает это не сразу, а когда сам решит (но "не сразу" - не значит через час :-). На "глазок" бот ждет после первого вызова pushmode 0.1-0.5 секунд, только потом комбинирует разные pushmode к наименьшему числу команд. topic <channel> returns: string of the current topic on the specified channel получить топик канала validchan <channel> checks if the bot is monitoring that channel returns: 1 if the channel exists, 0 if not проверить, мониторит ли бот канал. Если использовать большинство функций данного раздела и не проверять на их существование данной функцией, кроме случаев, когда канал точно существует, все такие фукции будут возвращать TCL ошибку isdynamic <channel> returns: 1 if the channel is an existing dynamic channel, 0 if not вернет 1, если канал является динамическим. Все каналы делят на динамические и статические. Статические каналы задают в файле eggdrop.conf и их не нужно удалять командами -chan. Динамические каналы - это те, которые создаются в процессе работы бота и храняться в файле. Имеено такие каналы можно свободно создавать и удалять командами ".+chan" (см. 'channel add'). setudef <flag/int> <name> Description: initializes a user defined channel flag or integer setting. You can use it like any other flag/setting. IMPORTANT: Don't forget to reinitialize your flags/settings after a restart, or it'll be lost. Returns: nothing Module: channels renudef <flag/int> <oldname> <newname> Description: renames a user defined channel flag or integer setting. Returns: nothing Module: channels deludef <flag/int> <name> Description: deletes a user defined channel flag or integer setting. Returns: nothing Module: channels ######################################################################### ######################################################################### ### ### ### Функции для DCC каналов ### ### ### ######################################################################### ######################################################################### --------------------------------------------------------------------- Здесь и далее под словами 'idx' / 'DCC' / 'канал' подразумевается идентификатор DCC-канала. Это похоже на файл или сокет. Каждый присоединившийся к боту другой бот или юзер занимает по каналу. Каналы бывают разного типа: lstn - бот открыл порл для соединения dns - для DNS модуля serv - коннект к серверу bot - коннект к другому боту chat - коннект к юзеру и т.д. Любое соединение (например, к веб-серверу из бота) или с ботами/людьми является каналом, куда можно писать и иногда читать. --------------------------------------------------------------------- putdcc <idx> <text> sends text to the dcc user indicated returns: nothing послать текст в DCC канал по его номеру dccbroadcast <message> sends your message to everyone on the party line on the bot net, in the form "*** <message>" for local users, and "*** [Bot] <message>" for users on other bots послать текст всем людям в партилайне, в т.ч. и на других ботах (формат сообщения см. выше) dccputchan <channel> <message> sends your message to everyone on a certain channel on the bot net, in a form exactly like dccbroadcast does -- valid channels are 0 thru 99999 returns: nothing послать текст в чат-канал (это не IRC каналы, а типа канала для партилайна) boot <user@bot> [reason] boot's a user from the partyline returns: nothing попытаться прибить юзера на своем или чужом боте, аналогична команде '.boot' restart rehash's the bot and kills all timers note that as this will also unload and reload all the modules, your bot will also jump servers. returns: nothing перезапустить бота, стереть всю память и освободить занятые ресурсы (закрыть файлы, очистить таймеры и прочее) и отключиться от IRC сервера. При запуске будет загружены все модули и скрипты. Бот не будет выкидывать людей из DCC-чата и разрывать линки с другими ботами. rehash rehash's the bot returns: nothing перезапустить скрипты бота. Память не очищается, некоторые ресурсе освобождаются (файлы закрываются, хотя таймеры не уничтожаются). dccsimul <idx> <text...> simulates text typed in by the dcc user specified -- note that in v0.9, this only simulated commands; now a command must be preceded by a '.' to be simulated returns: nothing сказать за человека какую-либо фразу. Все будут думать (и сам бот тоже), что это сказал человек. Например, он мог написать команду. hand2idx <handle> returns: the idx (a number greater than or equal to zero) for the user given, if she is on the party line in chat mode (even if she is currently on a channel or in chat off), the file area, or in the control of a script; "-1" otherwise -- if the user is on multiple times, the oldest idx is returned вернуть по ханду юзера номер его DCC канала. Поиск идет везде: в обычном партилайне, в чатах (внутри последнего) и в файловой области. Вернет -1, если человека нет и последний найденный номер (человек может открыть к боту сразу несколько DCC чатов) idx2hand <idx> returns: handle of the user with that idx по номеру DCC канала получить имя юзера valididx <idx> returns: "1" if the idx currently exists; "0" if not проверить, существует ли такой канал на боте getchan <idx> returns: the current party line channel for a user on the party line -- "0" indicates he's on the group party line, "-1" means he has chat off, and a value from 1 to 99999 is a private channel setchan <idx> <channel> sets a party line user's channel rather suddenly (the party line user is not notified that she is now on a new channel); a channel name can be used (provided it exists) returns: nothing console <idx> [channel] [console-modes] changes a dcc user's console mode, either to an absolute mode (like "mpj") or just adding/removing flags (like "+pj" or "-moc" or "+mp-c"); the user's console channel view can be changed also (as long as the new channel is defined in the bot) returns: a list containing the user's (new) channel view, and (new) console mode, or nothing if that user isn't currently in dcc chat установить "консоль" в одном из своих каналов. Консоль - это набор флагов и либо "*", либо указание на канал. Флаги указывают, какого типа лог-сообщения и с какого канала нужно выдавать в некий DCC-канал. Таким образом, каждое лог-сообщение имеет 2 признака: принадлежность к каналу (либо отсутствие таковой) и тип (буква/флаг), что задает правила рассылки логов. Более подробно - <.help console> echo <idx> [status] turns a user's echo on or off; the status has to be a 1 or 0 returns: new value of echo for that user (or the current value, if status was omitted) вкл/выкл эхо (повторять ли юзеру его собственные сообщения), см. <.help echo>. Для большинства людей не нужно, т.к. их клиенты итак отображают сообщения при наборе. putbot <bot-nick> <message> sends a message across the bot-net to another bot; if no script intercepts the message on the other end, the message just vanishes returns: nothing послать боту сообщение. Общение в ботнете разделено на 2 части: 1. скрытый обмен служебными сообщениями, боты сообщают друг другу о том, что юзеры что-то говорят, пингуют друг друга, сообщают версии и т.п. 2. обмен сообщениями, которые создаются в TCL скриптах бота Таким образом, все, что говорят люди на ботах, преобразуется во внутреннюю команду и рассылается межлу ботами, а для программирования существует открытый канал. Не документировано: максимальная длина сообщения - около 400 символов, все длиннее будет обрезано. putallbots <message> broadcasts a message across the bot-net to all currently connected bots returns: nothing тоже самое, для всех ботов killdcc <idx> kills a party-line or file area connection, rather abruptly returns: nothing закрыть DCC канал bots returns: list of the bots currently connected to the botnet вернуть список ботов в ботнете botlist returns: a list of bots currently on the botnet; each item in the list will be a sublist with four elements: bot, uplink, version, sharing status. bot : the bot's nickname uptlink: who the bot is connected through version: its current numeric version sharing: a "+" if the bot is sharing, "-" otherwise/ вернуть список о всех ботах ботнета, где каждый элемент это список из имени бота, имени бота, куда залинкован первый, версии, и признака расшаривания юзерлиста islinked <bot> returns: "1" if the bot is currently linked, "0" otherwise находиться ли бот в ботнете dccused returns: number of dcc connections currently in use количество открытых DCC каналов, см. <.dccstat> dcclist ?type? returns: a list of active connections, each item in the list will be a sublist of six elements: {<idx> <handle> <hostname> <type> {<other>} <timestamp>} the types are: chat, bot, files, file_receiving, file_sending, file_send_pending, script, socket (these are connections that have not yet been put under 'control'), telnet, and server. получить список о всех DCC каналов где элементы это список из 1 - номера канала 2 - имя, если такое можно получить (например, у открытого сокета имя "(users)" или "(bots)", у сервера - (server) и т.д.) 3 - хост, если его можно получить (см. оговорку выше) 4 - тип канала: telnet (открытый сокет), dns, bot, server, chat (юзер) 5 - прочие параметры: у сокетов - порт, у ботов/юзеров - флаги, у сервера - текущий лаг и т.п. особенности разных типов каналов 6 - время создания whom <chan> returns: list of people on the botnet who are on that channel (0 is the default party line); each item in the list will be a sublist with six elements: nickname, bot, hostname, access flag ('-', '@', '+', or '*'), minutes idle, and away message (blank if the user is not away) if you specify a channel of * every user on the botnet is returned with an extra argument indicating the channel the user is on получить список параметров людей в ботнете или чатах. Параметр - либо номер чата в боте, либо "*" (или "0"), чтобы получить список всех людей ботнета. Элемент списка это параметры: ханд человека, бот, на котором тот сидит, хост, доступ ("-" никто, "@" оп, "+" мастер, "*" владелиц <-- все это либо о каком-то канале, либо о всем боте), idle (время неактивности) в минутах, away сообщение (если юзер поставил себе <.away msg>). Если вызвать "whom *", то это выдаст инфо о всех каналах, в результате еще в самом конце списка будет число - номер канала. При вызове "whom 0" последнего числа нет. Канал 0 - это общий канал всего ботнета. getdccidle <idx> returns: number of seconds the dcc chat/file system/script user has been idle получить idle в секундах DCC канала getdccaway <idx> returns: away message for a dcc chat user (or "" if the user is not set away) получить away-сообщение DCC канала (могут поставить только люди у себя в партилайне) или "" - если нет сообщения setdccaway <idx> <message> sets a party line user's away message and marks them away; if set to "", the user is marked un-away returns: nothing установить юзеру в DCC канале режим отсутствия away и соотв. сообщение connect <host> <port> makes an outgoing connection attempt and creates a dcc entry for it; a 'control' command should be used immediately after a successful 'connect' so no input is lost returns: idx of the new connection установить соедининие с удаленным хостом в инете (хост:порт) и вернуть номер созданного DCC канала. Управление делится на 2 варианта: можно что-нибудь написать (putdcc <idx>) и сразу отключиться (например, вызвав некую www-страницу), либо с помощью команды TCL 'control' установить функцию, которая будет отвечать за созданное соединнение. Эту функцию будут вызывать каждый раз, когда удаленный хост будет слать команды, а функция должна их обрабатывать и реагировать (слать ответ через putdcc, убить соединение через killdcc и т.п.). Примеры такого использования: www.bot.net.ru, далее ссылка 'TCL/IRC/BOT-программирование' listen <port> <type> [options] [flag] opens a listening port to accept incoming telnets; type must be one of "bots", "all", "users", "script", or "off": listen <port> bots [mask] accepts connections from bots only; the optional mask is used to identify permitted bot names; if the mask begins with '@' it is interpreted to be a mask of permitted hosts to accept connections from returns: port # listen <port> users [mask] accepts connections from users only (no bots); the optional mask is used to identify permitted nicknames; if the mask begins with '@' it is interpreted to be a mask of permitted hosts to accept connections from returns: port # listen <port> all [mask] accepts connections from anyone; the optional mask is used to identify permitted nicknames/botnames; if the mask begins with '@' it is interpreted to be a mask of permitted hosts to accept connections from returns: port # listen <port> script <proc> [flag] accepts connections which are immediately routed to a proc; the proc is called with one parameter: the idx of the new connection flag may currently only be 'pub', which makes the bot allow anyone to connect. returns: port # listen <port> off stop listening at a port returns: nothing dccdumpfile <idx> <filename> dumps out a file from the text directory to a dcc chat user; the flag matching that's used everywhere else works here too ######################################################################### ######################################################################### ### ### ### Прочие функции ### ### ### ######################################################################### ######################################################################### bind <type> <attr(s)> <command-name> [proc-name] adds a new keyword command to the bot; valid types are listed below; the <attr(s)> are the flags that a user must have to trigger this command; the <command-name> for each type is listed below; <proc-name> is the name of the Tcl procedure to call for this command (see below for the format of the procedure call); if the proc-name is omitted, no binding is added -- instead, the current binding is returned (if it's stackable, a list of the current bindings is returned) yes, you can use the new flag binding method here too, and this is where it becomes truely phearfull since you may never need to check attr's inside functions again...imagine: bind pub -o&+o command command_proc to only allow channel-spec ops to use it! no problem! works fine! returns: name of the command that was added, or (if proc-name was omitted), a list of the current bindings for this command добавить функцию, которая будет вызываться при некоторых условиях. Другими словами, заставить бота реагировать на некие события. Это весьма сложная для описания фукнция, зато понять ее легко. У каждого сообщения есть тип, например: DCC - команда в DCC чате, PUB - фраза на каком-то канале, KICK - соотв. событие в канале, BOT - получение команды от другого бота, TIME - настроить вызов функции в определенное время (например по четвергам в 23:59 или каждые 2 минуты) - похоже на крон в Юникс компьютерах и т.п... Список всех типов приведен ниже в этом разделе (рекомендуется с ним ознакомиться, очень интересно). У большого числа событий причина - это действие пользователя в канале/сообщении/чате (некоторые собития не имеют такого признака, например событие наступающего 'die'). Если причиной события является человек (бот), то с помощью набор флагов глобального и локального (в канале) уровня можно ограничить доступ к ней. Проверка принадлежности идет по простому сравнению хоста человека с юзерлистом бота. Затем, так же у большого числа событий бывает некая текстовая часть. Например, в чате - начало сообщения. Такую часть (это первое слово всего сообщения) называют командой и ее можно использовать, чтобы поставить событие только для нужной команды. Последни параметр - имя функции, которая будет вызвана для обработи события. Формат функций (кол-во и назначение аргументов) отличается и описан в этой главе ниже. На одно и тоже событие может быть повешано много функций-обработчиков, они будут вызваны все по очереди. Очередность должен задать программист, в зависимости от требуемого порядка. unbind <type> <attr(s)> <command-name> <proc-name> removes a previously-made binding returns: name of the command that was removed удалаить созданное ранее событие, нужно перечислить теже самые параметры, чтобы указать на нужное событие: тип, флаги, команду и имя функции-обработчика | binds ?type/mask? | returns: a list of tcl binds, each item in the list will be a sublist of | five elements: | {<type> <flags> <name> <hits> <proc>} получить список созданных событий по фильтру (или без него, для получения всего списка) logfile [<modes> <channel> <filename>] creates a new logfile, which will log the modes given for the channel listed -- or, if no logfile is specified, just returns a list of logfiles; "*" can be used to mean all channels; you can also change the modes and channel of an existing logfile with this command -- entering a blank mode and channel makes the bot stop logging there returns: filename of logfile created, or (if no logfile is specified) a list of logfiles like: "{mco * eggdrop.log} {jp #lame lame.log}" установить логирование сообщений в логфайл filename. Каждое событие имеет свой флаг (буква или цифра 0-9) и название канала (либо "*"). Modes - перечень флагов (слитно, пример "pjk"). Channel - канал (либо "*"). "*" - для того, чтобы писать в лог сообщения со всех каналов, либо тех сообщений, что просто не имеют признака принадлежности к каналу. См. <.help console> maskhost <nick!user@host> returns: hostmask for the string given ("n!u@1.2.3.4" -> "*!u@1.2.3.*", "n!u@lame.com" -> "*!u@lame.com", "n!u@a.b.edu" -> "*!u@*.b.edu") построить на основе ник!хостмаски новую хостмаску. Использовать не рекомендуется, т.к. функция не знает о национальных/географических/и т.д. типа доменов. Например, хостмаска TAHK!TAHK@poputka.com.ru будет преобразована в *!TAHK@*.com.ru. Если использовать такую хост маску для автоопа бота, то любой человек, зарегистрировавший домен в общедоступном/бесплатном домене .com.ru может прикинуться ботом. В других странах используют доменты типа .co.uk для тех же целей. В ботах ТАНК применяется правильная функция с учетом множества общедоступных доменов, кроме того, учтены домены кривых провайдеров, которые своим клиентам выдают адреса типа ppp-212.193.6.??.moldnet.md (212 - старшая цифра, ?? - номер диалап линии). Понятно, что бот не догадывает о глупостях некоторых админов провайдеров и создает неправильную маску. timer <minutes> <tcl-command> executes the tcl command after a certain number of minutes have passed returns: a timerID Выполнить скрипт нужный скрипт каждые ХХ минут. Обычно используют для вызова функции. Внимание! Распространенная ошибка заключается в том, что эту функцию помещают в глобальную область TCL-скриптов бота, из-за чего при КАЖДОМ <.rehash> будет запущен ПОВТОРНЫЙ вызов тойже функции. Чтобы избежать ошибки, на http://bot.net.ru/tcl-rus.php (странице советов) прочитайте главу "как зафиксировать RESTART/REHASH". Только вставив защиту от <.rehash> можно будет использовать данную функцию и <.rehash> в боте, не нарушая логику программы и не загромождая напрасными таймерами. Время указывать в минутах. utimer <seconds> <tcl-command> executes the tcl command after a certain number of seconds have passed returns: a timerID тоже самое, но время указывать в секундах timers returns: list of active minutely timers; each entry in the list contains the number of minutes left till activation, the command that will be executed, and the timerID получить список активных таймеров (созданных командой timer). Элементы списка состоят из параметров: 1 - кол-ве минут, оставшихся до очередного срабатывания функции (или tcl скрипта) 2 - само имя функции (или сррипт) 3 - идентификатор таймера (это не число, пример: timer123) utimers returns: list of active secondly timers, identical in format to the output from 'timers' тоже самое, только относительно функции utimer killtimer <timerID> removes a minutely timer from the list returns: nothing остановить минутный таймер (от функции timer) по его идентификатору killutimer <timerID> removes a secondly timer from the list returns: nothing остановить секундный таймер (от функции utimer) по его идентификатору unixtime returns: a long integer which is the current time according to unix вернуть стандарное время, это кол-во секунд, прошедших с 00:00:00 часов 1 января 1970 года (или немного позже - из-за разных поясов времени). Будьте осторожны - на время обработки события, бот не следит за временем. Эта проблема и решение описаны в http://bot.net.ru/tcl-rus.php Тоже самое число-время вернет функция [clock seconds] (но unixtime писать короче). duration <seconds> returns: the number of seconds converted into years, weeks, days, hours, minutes, and seconds (ie: 804600secs is turned into 1wk 2days 7hrs 30mins). вернуть словестное описание диапазона времени. Чтобы русифицировать функцию, найдите ее в исходниках бота и либо там измените, либо перенесите ее, адаптировав от С к TCL, в скрипты бота. strftime <formatstring> [time] returns: a formatted string of time using standard strftime format, uses the value of time, or now if no time specified отформатировать время. Пример: strftime "%d %h %Y" [unixtime] (вернет 20 Jul 2001). Описание в точности совпадает со встроенной в TCL функцией [clock format ...], см. описание в русском мане. ctime <unixtime> returns: a string of the date/time represented by the unix time given (ie "Fri Aug 3 11:34:55 1973") преобразовать время в стандартное строковое Юникс-время. Его используют все программы при записи в лог и других частых случаях. myip returns: a long number representing the bot's IP address, as it might appear in (for example) a DCC request вернуть IP адрес бота, которое ему выдал сервер, в виде long-числа, а не стоковом, типа "123.45.67.89". Обычно используется, чтобы открыть чат для юзера бота. rand <limit> returns: a random integer between 0 and limit-1 вернуть случайное число в диапазоне от 0 до limit-1. В исходниках ботах видно, что функция на языке С соответствует команде: random()%limit. См. встроенну функцию в TCL: [expr rand]. control <idx> <command> removes a user from the party line and sends all future input from them to the Tcl command given; the command will be called with two parameters: the idx of the user, and the input text; the command should return "0" to indicate success and "1" to indicate that it relinquishes control of the user back to the bot; the idx must be for a user in the party line area or the file area; if the input text is blank (""), it indicates that the dcc user has dropped connection. Also, if the input text is blank, never call killdcc on it, it will fail with 'invalid idx'. returns: nothing получить контроль над DCC каналом. Команда (вернее, функция 'command') будет вызвана при поступлении из команды каких-то данных (строки). Функция получит 2 аргумента - номер канала и сами данные (строку). Подробнее описана в connect. sendnote <from> <to> <message> simulates what happens when one user sends a note to another (this can also do cross-bot notes) returns: "1" if the note was delivered locally or sent to another bot, "2" if the note was stored locally, "3" if the user's notebox is too full to store a note, "4" if a Tcl binding caught the note, "5" if the note was stored because the user is away, or "0" if the send failed link [via-bot] <bot> attempts to link to another bot directly (or, if you give a via-bot, it tells the via-bot to try returns: "1" if it looks okay and it will try; "0" if not подлинковаться к ботнету, соединившись с ботом 'bot'. Либо, подлинковать к себе бота, который еще не присоединен к ботнету. unlink <bot> attempts to remove a bot from the botnet returns: "1" if it will try or has passed the request on; "0" if not отлинковаться от бота encrypt <key> <string> returns: encrypted string (using blowfish), encoded into ascii using base-64 so it can be sent over the botnet закодировать строку с помощью ключа/пароля. Если вы собираетесь шифровать команду перед отправкой в ботнет, то помните о длине - максимум 400 символов, и о том, что строка после шифровки увеличивается в длине на 20-35%. Т.е. вам не удасться отправить команду, длиннее 300 символов. decrypt <key> <encrypted-base64-string> returns: decrypted string (using blowfish) расшифровать строку encpass <password> returns: encrypted string (using blowfish) зашифровать пароль тем же способом. Какой именно будет использован ключ - решит бот. Однако, на всех ботах одному и тому же зашифрованному паролю соответствует оригинальный пароль (т.е. можно взять из чужого юзера листа кодированный пароль и внести в свой лист). Коренное отличие от encrypt состоит в том, что расшифровать пароль невозможно, либо очень турдно (и только методом перебора), см. подробности в md5 die [reason] causes the bot to log a fatal error and exit completely; if no reason is given, "EXIT" is used завершить бота, указав причину, которая пойдет в лог и ботнет unames returns: The current operating system the bot is using. соответствует строке, получаемой после вызова 2х команд операуионной системы: uname -s <-- вернет название (наример: Linux) uname -r <-- вернет версию Все вместе будет, например, "Linux 2.2.17-21mdk". | dnslookup <ip-address/hostname> <proc> [[arg1] [arg2] ... [argn]] | Issues an asynchronous dns lookup request. The command will block if | dns module is not loaded, otherwise it will either return immediately | or immediately call the proc (e.g. if the lookup is already cached). | As soon as the request completes, <proc> will be called as follows: | <proc> ipaddress hostname status [[arg1] [arg2] ... [argn]] | status is 1 if the lookup was successful and 0 if it wasn't. All | additional parameters (called arg1, arg2 and argn above) get appended | to the proc's other parameters. | md5 <string> | returns: the 128 bits MD5 "message-digest" of the specified string. закодировать строку в цифровую подпись. Подпись - это число из 128 бит. Функция вернет не само число, т.к. оно очень большое и бот его не может обрабатывать, а как текст, например: [md5 "password"] вернет строку "5f4dcc3b5aa765d61d8327deb882cf99". Главная идея md5 в том, что зная цифровую подпись, невозможно никакими способами узнать оригинал (в нашем примере - шифруемый пароль). Пример. Составим пароль из букв английского алфавита (пусть их всего 30 - только нижний регистр). Длина пароля - 10 букв. Компьютер, который хочет подобрать пароль, должен будет перебирать пароли (типа 'aa', 'ab', 'af'...), кодировать их md5 и сравнивать с шаблоном. Если компьютер - Pentium II 233, то на полный перебор уйдет 123287 лет. Чтобы еще более усложнить задачу (до 10^30 лет /10 в степени 30/) или сделать ее нерельной для владельцев суперкомпьютеров, читайте http://bot.net.ru/botnet.php | compressfile [-level <level>] <src-file> [target-file] | uncompressfile <src-file> [target-file] | Compress or uncompress files. The level option specifies the compression | mode to use when compressing. Available modes are from 0 (minimum CPU | usage, minimum compression) all the way up to 9 (maximum CPU usage, | maximum compression). | If you don't specify the target-file, the src-file will be overwritten. | iscompressed <filename> | Determines whether <filename> is gzip compressed. Returns "1" if it is, | "0" if it isn't and "2" if some kind of error prevented the checks from | succeeding. -------------------------------------------------------------- ######## ГЛОБАЛЬНЫЕ ПЕРЕМЕННЫЕ (GLOBAL VARIABLES) ########### -------------------------------------------------------------- (All config-file variables are global, too. But these variables are set by the bot.) Все переменные из конфиг файлов являются глобальными, т.к. конфиг - это обычный TCL скрипт. Можно писать свои скрипты хоть в нем. Но в этом разделе идет описание не конфа, а встроенных в бота переменных. Не забывайте объятвить их глобальными в функциях. Чтобы обратиться к переменной с "-" (минусом), используйте фигурные скобки. Пример: putlog "мой хост: ${my-hostname}, ник: $botnick" botnick current nickname the bot is using, ie 'Valis' or 'Valis0', etc текущее имя бота (ник в IRC). Не используйте botnick для каких серьезных дейсвий, типа создание лога с использованием ник бота. Для этого есть не меняющийся $botnetnick. botname current nick!user@host that the server sees, ie 'Valis!valis@crappy.com' текущая маска бота в IRC. До коннекта к IRC серверу принимает значение из предполагаемого ник + предполагаемоего хоста (их задает владелец бота в конфиге). Первое берется из $nick, затем $user и ${my-hostname} (или ${my-ip}, если переменная ${my-hostname} не указана). Но после коннекта к серверу (примерно, через 4 секунды при отсутствии лага) данная переменная меняется с предполагаемого на реальное значение. Т.е. на реальную хостмаску, под которой будут видить бота все остальные посетители IRC (и сам бот, конечно). Время в 3-4 секунды (стабильно) получено из опыта на локальных ботах и локальном IRC-сервере. server current server the bot is using, ie 'irc.math.ufl.edu:6667' текущий сервер и порт version current bot version (ie: "1.1.2+pl1 1010201 pl1"); first item is the text version, second item is a numerical version, and any following items are the names of patches that have been added версия бота numversion current numeric bot version (ie: "1010201"); Numerical version is "MNNRRPP" where: M is the Major release number NN is the Minor release number RR is the sub-release number PP is the patch level for that sub-release формальный вариант номера версии: число из 7-8 цифр (в примере - 7), где M - самая старшая цифра версии бота, номер релиза NN - младшая цифра номер релиза бота и т.д. uptime unixtime value for when the bot was started время (стандарное unixtime) запуска бота как процесса server-online unixtime value for when the bot connected to its current server время (стандарное unixtime) соединения к IRC-серверу lastbind The last command binding which triggered. This allows you to identify which command triggered a tcl routine. | isjuped | value is 1 if bots nick is juped(437) 0 otherwise. handlen (добавлено в 1.6.10) Value: the value of the HANDLEN define in src/eggdrop.h Module: core значение максимально возможной длины ника на боте config (добавлено в 1.6.10) Value: the filename of the config file eggdrop is currently using Module: core имя конфига файла, который анализировал бот для запуска --------------------------------------------------------------------------- ######### COMMAND EXTENSION / описание событий бота, функции ############ ######### bind/unbind и формат вызываемых функций-обработчиков ############ --------------------------------------------------------------------------- You can use the 'bind' command to attach Tcl procedures to certain events. For example, you can write a Tcl procedure that gets called every time a user says "danger" on the channel. The following is a list of the types of bindings, and how they work. Under each binding type is the format of the bind command, the list of arguments sent to the Tcl proc, and an explanation. Вы должны юзать команду bind, чтобы повесить на определенное событие вашу TCL функцию. Например, чтобы узнать, когда кто-то в канале пишет слово 'danger', нужно написать TCL процедуру и создать связь между событием типа PUB и именем этой новой процедуры. Формат параметров данных процедур особый и описан ниже. Т.е. в каждом параметре вызываемой процедуры (из-за событий) будут определенные данные. Some bindings are marked as "stackable". That means that you can bind multiple commands to the same trigger. Normally, for example, a binding of "bind msg - stop msg_stop" (which makes a msg-command "stop" call the Tcl proc "msg_stop") will overwrite any previous binding you had for the msg-command "stop". With stackable bindings, like 'msgm' for example, you can bind to the same command or mask again and again. When the binding is triggered, ALL the Tcl procs that are bound to it will be called, one after another. Некоторые bind'ы помечены словом stackable - стековый bind. Это значит, что если на одно и тоже событие и триггер (ключевое слово - 'command' в описании ниже) повесить разные функции, т.е. вызвать bind 2 раза с одним и тем же набором параметров, но разными именами функций, то СТЕКОВЫЕ bind'ы вызызовут ВСЕ повешенные процеруды. А не стековые - только один раз. Т.е. если повесить на не стековый bind несколько функций, вызвана будет только последняя. To remove a binding, use "unbind". For example, to remove that binding for the msg-command "stop", use "unbind msg - stop msg_stop". Для удаления связи между событиями и функциями используйте unbind. Важно, чтобы параметры unbind в точности совпадали с параметрами при bind, иначе будет ошибка. Чтобы узнать список текущих связей, используйте '.binds all' в чате бота или команду binds, которая вернет полный список всех bind'ов. Кроме 4-х параметров (тип события - type (msg/pub/...), флаги юзера - flags, команды (маски) - command и названия вашей процедуры - proc) будет еще и кол-во вызовов данного bind (счетчик). (1) MSG bind msg <flags> <command> <proc> procname <nick> <user@host> <handle> <arg> used for /msg commands; the first word of the user's msg is the command, and everything else becomes the argument string сообщения от юзеров IRC по /msg; первое слово из собщения - команда, остальная часть сообщения(без первого слова) идет в $arg (почти во всех следующих событиях точно так же). Пробел после первого и второго слова удаеляется, т.е. не идет в $arg. Локальные флаги не действуют. Досточно иметь где угодно указанный локальный доступ, чтобы команда выполнилась. В DCC политика флагов такая же. (2) DCC bind dcc <flags> <command> <proc> procname <handle> <idx> <arg> used for commands from a dcc chat on the party line; as in MSG, the command is the first word and everything else is the argument string; the idx is valid until the user disconnects; after that it may be reused, to be careful about storing an idx for long periods of time сообщение из чата бота (DCC-chat или telnet). Idx - номер DCC канала юзера. (3) FIL bind fil <flags> <command> <proc> procname <handle> <idx> <arg> the same as DCC, except this is triggered if the user is in the file area instead of the party line (THIS IS ONLY AVALIABLE WHEN THE filesys.so MODULE IS LOADED) для файлов области, обычно ее (loadmodule filesys) на боте нет (4) PUB bind pub <flags> <command> <proc> procname <nick> <user@host> <handle> <channel> <arg> used for commands given on a channel; just like MSG, the first word becomes the command and everything else is the argument string сообщение на канале. Локальная часть флага действует как фильтр для канала, откуда поступает сообщение. (5) MSGM (stackable) bind msgm <flags> <mask> <proc> procname <nick> <user@host> <handle> <text> matches the entire line of text from a /msg with the mask; this is more useful for binding Tcl procs to words or phrases spoken anywhere within a line of text тоже самое, что и MSG, за исключение: команда заменяется на маску, что дает возможность использовать спец символы типа "*". Например, на маску "*" функция поймает все сообщения. (6) PUBM (stackable) bind pubm <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> <text> just like MSGM, except it's triggered by things said on a channel instead of things /msg'd to the bot; the mask is matched against the channel name followed by the text, ie, "#nowhere hello there!", and can contain wildcards тоже, что и PUB, но вместо команды - маска (см. MSGM). На маску "*" функция поймает весь текст всех каналов (7) NOTC (stackable) bind notc <flags> <mask> <proc> | procname <nick> <user@host> <handle> <text> <dest> | destination will be a nickname (the bot's nickname, obviously) or | a channel name; matches the entire line of text from a /notice with the mask; it is considered a breach of protocol to respond to a /notice on IRC, so this is intended for internal use (ie, logging, etc) only | new Tcl procs should be declared as | proc notcproc {nick uhost hand chan text {dest ""}} { | global botnick; if {$dest==""} { set dest $botnick } | ... | } | for compatiblity сообщения-notice. Они бывают для всего канала или только для бота. Используйте пример функции notcproc, где последний параметр необязателен. (8) JOIN (stackable) bind join <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> triggered by someone joining the channel; the <mask> in the bind is matched against "#channel nick!user@host" and can contain wildcards кто-то (или сам бот) вошел на канал (9) PART (stackable) bind part <flags> <mask> <proc> | procname <nick> <user@host> <handle> <channel> <msg> triggered by someone leaving the channel; as in JOIN, the <mask> is matched against "#channel nick!user@host" and can contain wildcards. if no part message is specified msg will be set to "". | new Tcl procs should be declared as | proc partproc {nick uhost hand chan {msg ""}} { ... } | for compatiblity кто-то (или сам бот) покинул канал нормальным спосом (нормальность: выход с канала, а не из IRC, и выход не методом кика). MSG - сообщение при выходе с канала. Для демонстрации редкого явления (наличия MSG), в mIRC'е попробуйте команду </part #канал сообщение> и наблюдайте из другого клиента или бота за этим. (10) SIGN (stackable) bind sign <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> <reason> triggered by a signoff, or possibly by someone who got netsplit and never returned; the signoff message is the last argument to the proc; wildcards can be used in <mask>, which contains the channel name выход из IRC (11) TOPC (stackable) bind topc <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> <topic> triggered by a topic change; can use wildcards in <mask>, which is matched against the channel name and new topic установка топика. Будьте осторожны, тут есть много недокументированных особенностей. Привожу собственные наблюдения. При входе на канал с топиком (бывает, что топика нет) боту шлют 2 события о установке топика. При таках фальшивых сообщениях (топик-то на самом деле никто не ставил при входе бота) в переменных nick, user@host и handle содержиться строка "*". Итак, если топик кто-то дейсвительно ставит, бот генерирует нормальное событие. Если бот входит на канала и получает топик, то бот генерирует 2(два) одинаковых фальшивых сообщения. Одно из них, разумеется, надо отбрасывать. (12) KICK (stackable) bind kick <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> <target> <reason> triggered when someone is kicked off the channel; the <mask> is matched against "#channel target" where the target is the nickname of the person who got kicked off (can use wildcards); the proc is called with the nick, user@host, and handle of the kicker, plus the channel, the nickname of the person who was kicked, and the reason; <flags> is unused here кик: человек с nick/uaer@host/handle кикнул на канале channel человека с ником target и причиной reason. В момент кика вы еще можете использовать nick2hand для определения ханда жертвы (хост тоже можно получить - nick2host) и выполнения каких-то действий, типа мести nick'у за кик target. (13) NICK (stackable) bind nick <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> <newnick> triggered when someone changes nicknames; wildcards are allowed; the mask is matched against "#channel newnick" смена ника (14) MODE (stackable) bind mode <flags> <mask> <proc> proc-name <nick> <user@host> <handle> <channel> <mode-change> <victim> mode changes are broken down into their component parts before being sent here, so the <mode-change> will always be a single mode, like "+m" or "-o" and victim will show the value of the mode change (for o/v/b) otherwise ""; flags are ignored; the bot's automatic response to a mode change will happen AFTER all matching Tcl procs are called; the <mask> will have the channel prefixed (ie, "#turtle +m") if it is a server mode <nick> will be "", <user@host> is the server address and handle is * note that "victim" was added in 1.3.23 and that this will break tcl scripts that were written for pre-1.3.23 versions and use this binding. An easy fix (by guppy) is as follows (example): Old script looks as follows: bind mode - * mode_proc proc mode_proc {nick uhost hand chan mc} { ... } To make it work with 1.3.23+ and stay compatible with older bots, do: bind mode - * mode_proc_fix proc mode_proc_fix {nick uhost hand chan mc {victim ""}} { if {$victim != ""} { append mc " $victim" } mode_proc $nick $uhost $hand $chan $mc } proc mode_proc {nick uhost hand chan mc} { ... } использование MODE на канале. Далее подробности для ботов версии 1.5.0 и выше. Всего в функцию передают 2 параметры: mc - обязательный и victium - нет. Если на канале за одну команду MODE происходит сразу несколько изменений типа /mode #phpclub +oo DlMA TAHK, то бот генерирует 2 события. Первое событие: mc - "+o", victrum - "DlMA". Второе событие: mc - "+o", vicrtum - "TAHK". С банами, голосами - точно так же. Но некоторые флаги не имеют дополнительных аргументов, например /mode #phpclub +i. В таком случае бот генерирует событие и передает только первую переменную "+i". В случае установке ключа на канал или лимита передается два параметра (т.к. это парные флаги). *** Еще бывает команда </mode $botnick +/-флаги>, но на счет прихода события от такого - не проверял (обратите внимание, что $botnick - имя бота, а не имя канала) *** Еще бывает команда </mode #phpclub> (вообще без аргументов) - описание команды и способ поймать ответ (бытия MODE не будет) читайте на http://bot.net.ru/tcl-rus.php Еще тонкость состоит в том, что если вы получили событие MODE (например -t) то бот считает что этого еще не произошло, т.е. команда проверки флагов канала скажет, что "t" установлен. Просто не нужно проверять то, что бот сообщил данным событием. (15) CTCP bind ctcp <flags> <keyword> <proc> proc-name <nick> <user@host> <handle> <dest> <keyword> <arg...> destination will be a nickname (the bot's nickname, obviously) or a channel name; keyword is the ctcp command and arg may be empty; if the proc returns 0, the bot will attempt its own processing of the ctcp command сообщение CTCP. Dest - всегда имя бота. Keyword - команда (первое слово сообщения). Arg - аргументы сообщения (сообщение без первого слова). При пинге бота в keyword будет "PING", а в arg - фраза, которую надо переслать назад (в этом смысл пинга). МИРК поместит в фразу [unixtime]. Боты типа SG поместят тутда "[unixtime]_<канал>", чтобы знать, на какой канал отвечать. Поэтому вы можете заставить СГешного бота отвечать что угодно и на какой угодно канал. Боты ТАНК помещают в arg специльное число, типа номера сессии (понятие из веб-языков PHP/Perl/ASP), в зависимости от котого бот будет знать, кому и куда ответить при пинге. В ходе экперимента установлено, максимальная длина строки пинга в mIRC'е - 22 символа, потом он перестает отвечать. (16) CTCR bind ctcr <flags> <keyword-mask> <proc> proc-name <nick> <user@host> <handle> <dest> <keyword> <arg...> just like ctcp, but this is triggered for a ctcp-reply (ie, ctcp embedded in a notice instead of a privmsg) сообщение-ответ на запрос CTCP. См. описание выше. На примере пинга: таким образом бот получает ответ от тех, кого он пинговал. МИРК получит [unixtime] (время), вычислит разницу между текущим временем и пришедшим временем, сообщит о том, что от nick пришел пинг, пинг составляет ту самую разницу. Боты типа SG вычислят разницу точно также, а из второй половины узнают, на каком именно канале nick использовал функцию пинга (чтобы ответить на нужный канал). Боты ТАНК по ответу, являющимся номером сессии, узнают: действительно данный nick использовал пинг, когда (сколько сек. назад) пинг был использован - чтобы разницу вычислить, на каком канале пинг был использован. Далее, разумеется, бот уничтожает сессию (чтобы второй раз нельзя было воспользоваться) и шлет ответ в канал. Все это нужно, чтобы бот обрабатывал не более NN параллельных запросов !ping и чтобы нельзя было обмануть бота. (Если какой-то бот типа ТАНК не реагирует на !ping - просто у него максимально наполнен буфер, который очищается при ответе на пинг или по прошествию какого-то большого времени, типа таймаута от юзера). (17) RAW (stackable) bind raw <flags> <keyword-mask> <proc> procname <from> <keyword> <arg...> previous versions of eggdrop required a special compile option to enable this binding, but it's now standard; the mask is checked against the keyword (either a numeric like "368" or a keyword like "PRIVMSG"); from will be the server name or the source user (depending on the keyword); flags are ignored; the order of the arguments is identical to the order that the IRC server sends to the bot -- the pre-processing only splits it apart enough to determine the keyword; if the proc returns 1, eggdrop will not process the line any further (THIS COULD CAUSE YOUR BOT TO BEHAVE ODDLY IN SOME CASES) На счет этого типа сообщений подробно расписано на http://bot.net.ru/tcl-rus.php в главе "RAW: получение ВСЕГО текста от сервера" (не вижу смылса сюда копировать большую главу). (18) BOT bind bot <flags> <command> <proc> proc-name <from-bot> <command> <arg> triggered by a message coming from another bot in the botnet; works similar to a DCC binding; the first word is the command and the rest becomes the argument string; flags are ignored сообщение от другого бота. Первое слово сообщение - команда (фильтр command), второе - аргументы (т.е. вся фраза, за исключением первого слова). (19) CHON (stackable) bind chon <flags> <mask> <proc> proc-name <handle> <idx> when someone first enters the "party-line" area of the bot via dcc chat or telnet, this is triggered before they are connected to a chat channel (so yes, you can change the channel in a 'chon' proc); mask matches against handle; this is NOT triggered when someone returns from the file area, etc юзер входит в чат боты (DCC/telnet). Если в результате каких то условий ваш бот решит юзера выкинуть (т.к. ему нельзя входить), то на боте произойдет 2 TCL ошибки, т.к у бота вызовутся какие-то 2 внутренние функции, которые попытаются в idx что написать и, разумеется, им это не удасться (idx окажется ошибочным, потому как вы только что убили DCC канал функциями boot или killdcc). Если убивать boot - юзер получит вашу причину. Если делать так: putdcc $idx "Access denied"; killdcc $idx - юзер увы не получит сообщение, т.е. его бот отключит раньше, чем он мог бы получить сообщение. Если убить юзера при получении события CHON, то никто (ни на боте, ни в ботнете) не узнает, что кто-то входил и был выкинут (т.е. это хорошо - не будет флуда лишнего). handle - ханд входящего юзера, idx - номер DCC канала, который бот создал для юзера. События не происходит, если юзер переходит из файловой области в партилайн. Не документировано: бот генерит это событие при перезапуске по <.restart>, после окочательной разгрузки скриптов, разумеется.. иначе ловить не кому =) (20) CHOF (stackable) bind chof <flags> <mask> <proc> proc-name <handle> <idx> triggered when someone leaves the party line to disconnect from the bot; mask matches against the handle; note that the connection may have already been dropped by the user, so don't send output to that idx юзер вышел из чата, передается его ханд и номер закрытого уже dcc канала (21) SENT (stackable) bind sent <flags> <mask> <proc> proc-name <handle> <nick> <path/to/file> after a user has successfully downloaded a file from the bot, this binding is triggered; mask is matched against the handle of the user that initiated the transfer; nick is the actual recipient (on IRC) of the file; the path is relative to the dcc directory (unless the file transfer was started by a script call to 'dccsend', in which case the path is the exact path given in the call to 'dccsend') (THIS IS ONLY AVALIABLE WHEN THE transfer.so MODULE IS LOADED) только для файловой области бота (22) RCVD (stackable) bind rcvd <flags> <mask> <proc> proc-name <handle> <nick> <path/to/file> triggered after a user uploads a file successfully; mask is matched against the user's handle; nick is the nickname on IRC that the file transfer originated from; the path is where the file ended up, relative to the dcc directory (usually this is your incoming dir) (THIS IS ONLY AVALIABLE WHEN THE transfer.so MODULE IS LOADED) только для файловой области бота (23) CHAT (stackable) bind chat <flags> <mask> <proc> proc-name <handle> <channel#> <text> when someone says something on the botnet, it invokes this binding; flags are ignored; handle could be a user on this bot (ie "DronePup") or on another bot (ie "Eden@Wilde") and therefore you can't rely on a local user record; the mask is checked against the text только для создания каналов (отдельных чатов) в партилайне. Как я понимаю, это создание изолированного чата для отдельного общения группы людей (24) LINK (stackable) bind link <flags> <mask> <proc> proc-name <botname> <via> triggered when a bot links into the botnet; botname is the botnetnick of the bot that just linked in; via is the bot it linked through; the mask is checked against the bot that linked; flags are ignored Событие означает, что бот $botname подлинковался к боту $via в ботнете. Если $via - это наш бот ($botnetnick), то получается, что подлинковадись к нам. Важная особенность события состоит в том, что когда подключается не один бот к какому-то другому боту, а бот, к которому уже было подлинковано много ботов, то срабатывает сразу несколько событий LINK. Из-за этой особенности сразу при подключении сети ботов мы узнаем об иерархии ботнета, т.е. как именно кто и кому подключен, пример - '.bottree'. (25) DISC (stackable) bind disc <flags> <mask> <proc> proc-name <botname> triggered when a bot disconnects from the botnet for whatever reason; just like the link bind, flags are ignored; mask is checked against the botnetnick of the bot that left Отлинковка бота от ботнета. (26) SPLT (stackable) bind splt <flags> <mask> <proc> procname <nick> <user@host> <handle> <channel> triggered when someone gets netsplit on the channel; be aware that this may be a false alarm (it's easy to fake a netsplit signoff message); <mask> may contain wildcards, and is matched against the channel and nick!user@host just like join; anyone who is SPLT will trigger a REJN or SIGN within the next 15 minutes Юзер уходит с IRC из-за сплита. (27) REJN (stackable) bind rejn <flags> <nick!user@host> <proc> procname <nick> <user@host> <handle> <channel> someone who was split has rejoined; <mask> can contain wildcards, and contains channel and nick!user@host just like join Вошел юзер, который недавно (не позже 15 мин. назад) ушел из-за сплита. (28) FILT (stackable) bind filt <flags> <mask> <proc> procname <idx> <text> DCC party line and file system users have their text sent through filt before being processed; if the proc a blank string, the text is considered parsed; otherwise the bot will use the text returned from the proc and continue parsing that Событие срабатывае, когда кто-то что-то пишет в чате бота. Маска может быть *, чтобы взять все подряд. Но в этом случае вы теряете возможность писать любые команды, типа '.restart', т.к. бот их уже не получит. | (29) NEED (stackable) | bind need <flags> <type/mask> <proc> | procname <channel> <type> | | this bind is triggered on certain events, like when the bot needs | operator status or the key for a channel; the types are: op, unban, | invite, and key; <type/mask> can contain wildcards, and contains | the channel and the type of need request; flags are ignored Вызывается, когда бот чего-то хочет - опа на канале или войти на канал из-за бана/лимита/инвайта/ключа. Не особо актуально, т.к. все это можно определить через need-op need-unban и т.п. параметры команды '.chanset'. (30) FLUD (stackable) bind flud <flags> <type> <proc> procname <nick> <user@host> <handle> <type> <channel> any floods detected through the flood control settings (like 'flood-ctcp') are sent here before processing; if the proc returns 1, no further action is taken on the flood; if the proc returns 0, the bot will do its normal "punishment" for the flood; the flood type is "pub", "msg", "join", or "ctcp" (and can be masked to "*" for the bind); flags are ignored Вызывается при определении флуда, встроенным детектором флуда в боте. Смотрите для подробностей bot.net.ru/flags.php, где описаны типы флуда и их параметры. (31) NOTE bind note <flags> <handle> <proc> procname <from> <to> <text> incoming notes (either from the party line, someone on IRC, or someone on another bot on the botnet) are checked against these binds before being process; if a bind exists, the bot will not deliver the note; the handle must be an exact match (no wild- cards), but it is not case sensitive; flags are ignored для notes модуля (32) ACT (stackable) bind act <flags> <mask> <proc> proc-name <handle> <channel#> <action> when someone does an action on the botnet, it invokes this binding; flags are ignored; the mask is checked against the text of the action (this is very similar to the CHAT binding) срабатывает, когда кто-то использует в ботнете команду '.me любой текст', что аналогично /me в ИРЦ канале (33) WALL (stackable) bind wall <flags> <mask> <proc> proc-name <handle> <msg> when the bot receives a wallops, it invokes this binding; flags are ignored; the mask is checked against the text of the wallops msg Прием текста, сказанных irc-опами. Чтобы бот автоматически логировал такой текст в лог, используйте logfile с типом 'w'. И при входе бота в irc пишите 'MODE $botnick +w' (это, вроде, и делается по-умолчанию). (34) BCST (stackable) bind bcst <flags> <mask> <proc> proc-name <botname> <channel#> <text> when a bot says something on the botnet, it invokes this binding; flags are ignored; the mask is checked against the text Бот пишет в канал какой-то текст. Например, info-line человека, который только что вошел в ботнет. (35) CHJN (stackable) bind chjn <flags> <mask> <proc> proc-name <botname> <handle> <channel#> <flag> <idx> <from> when someone joins a botnet channel, it invokes this binding; flags are ignored; the mask is checked against the text кто-то вошел на бота в ботнете (36) CHPT (stackable) bind chpt <flags> <mask> <proc> proc-name <botname> <handle> <idx> <channel#> when someone parts a botnet channel, it invokes this binding; flags are ignored; the mask is checked against the channel кто-то ушел с бота из ботнета (37) TIME (stackable) bind time - <mask> <proc> proc-name <min> <hour> <day> <month> <year> allows you to schedule procedure calls at certain times, mask matches 5 space seperated integers of the form: "min hour day month year" min, hour, day, month have a zero padding so they are exactly two characters long, year is extended to four characters in the same way if needed ;) Поставить срабатывание события на определенное время. Это напоминает scheduler в windows или cron в unix. Параметр mask в bind'е - это 5 чисел через запятую. Что значат - написано выше. При срабатывании функции ей передают текущее время. Год состоит из 4-х цифр. Чтобы сделать событие на 0 минут каждого часа, используйте: "00 * * * *". Чтобы сделать событие на 7, 17, 27, 37, 47 и 57 минут каждого часа (6 раз в час), используйте "*7 * * * *". Как видите, все цифры должны быть 2-х значными (или 4-х значными - год). (38) AWAY (stackable) bind away - <mask> <proc> proc-name <botname> <idx> <text> triggers when a user goes away or comes back on the botnet, text is the reason than has been specified (text == "" when returning) Юзер в ботнете ушел в away, либо наоборот вернулся из away (если $text пустая строка) (39) LOAD (stackable) bind load - <mask> <proc> proc-name <module> triggers when a module is loaded. загрузка модуля. Обычно, модули загружаются только на этапе старта бота, из файла eggdrop.conf (40) UNLD (stackable) bind unld - <mask> <proc> proc-name <module> triggers when a module is unloaded. выгрузка модуля. Например, при завершении бота тот выгружает все модули и это событие можно отловить в программе. (41) NKCH (stackable) bind nkch - <mask> <proc> proc-name <oldhandle> <newhandle> triggered whenever a local users handle is changed (in the userfile) смена ника пользователем бота по команде '.handle' или TCL команде (42) EVNT (stackable) bind evnt - <type> <proc> proc-name <type> triggered whenever one of these events happens. valid events are: sighup (called on a kill -HUP <pid>) sigterm (called on a kill -TERM <pid>) sigill (called on a kill -ILL <pid>) sigquit (called on a kill -QUIT <pid>) save (called when the userfile is saved) rehash (called just after a rehash) prerehash (called just before a rehash) logfile (called when the logs are switched daily) | | connect-server (called just before we connect to an irc server) | init-server (called when we actually get on our irc server) | disconnect-server (called when we disconnect from our irc server) Срабатывает до или после определенного события: sighup, sigterm, sigill, sigquit - когда кто-то вызывает kill с соответственным параметром. Это удобно, т.к. из шелла можно что-то сделать. Например при событии -HUP рехешить бота или перегружать. Событие -TERM идет после kill без параметров, к примеру так ОС пытается выгрузить бота перед перезагрузкой или завершением ОС. save - после записи юзерлиста на диск rehash - после перезагрузки скриптов и совершении rehash. И даже после анализирования всех скриптов, иначе вашей программы, для отлова события, просто не будет в памяти. prerehash - до рехеша logfile - после ротации логов connect-server, когда установлен коннект к IRC серверу, в самый первый момент. Это не означает входа в IRC сеть, а только факт наличия соединения. init-server - после входа в IRC disconnect-server - после отключения от IRC | (43) LOST (stackable) | bind lost <flags> <mask> <proc> | proc-name <handle> <nick> <path> <bytes-transferred> <length-of-file> | | Triggered when a DCC SEND transfer gets lost, i.e. the connection is | terminated before all data was successfully sent/received. This is | typically caused by a user abort. | (THIS IS ONLY AVALIABLE WHEN THE transfer MODULE IS LOADED) только для файловой области бота | (44) TOUT (stackable) | bind tout <flags> <mask> <proc> | proc-name <handle> <nick> <path> <bytes-transferred> <length-of-file> | | Triggered when a DCC SEND transfer times out. This may either happen | because the dcc connection was not accepted or because the data | transfer stalled for some reason. | (THIS IS ONLY AVALIABLE WHEN THE transfer MODULE IS LOADED) только для файловой области бота (A) RETURN VALUES - О возвращаемых значениях Several bindings pay attention to the value you return from the proc (using "return $value"). Usually they expect a 0 or 1, and failing to return any value is interpreted as a 0. Некоторые bind'ы, вернее процедуры, которые их обрабатывают, должны возвращать определенные значения (0 или 1), т.к. эти значения имеют некоторый смысл. Имеется ввиду завершение процедуры-обработчика по "return 0", "return 1", "return" или вообще без return. Here's a list of the bindings that use the return value from procs they trigger: Это типы bind'ов и что значит возвращаемое значение: MSG Return 1 to make the command get logged like so: (nick!user@host) !handle! command Верните 1, если нужно записать это событие в лог бота (иначе в лог не попадет факт вызова команды). Далее с DCC, FIL (для файловой области) и PUB аналогично. При 0 - команда в лог не идет (вообще никак). DCC Return 1 to make the command get logged like so: #handle# command FIL Return 1 to make the command get logged like so: #handle# files: command PUB Return 1 to make the command get logged like so: <<nick>> !handle! command CTCP Return 1 to ask the bot not to process the CTCP command on its own. Otherwise it would send its own response to the CTCP (possibly an error message if it doesn't know how to deal with it). Верните 1, чтобы бот не обрабатывал данный CTCP запрос боту. FILT Return 1 to indicate the text has been processed, and the bot should just ignore it. Otherwise it will treat the text like any other. Вот здесь я не понимаю документацию, т.к. чтобы бы вы не вернули, этот текст уйдет в ботнет как простой текст. Только при возврате "" ничего не проиходит. Т.е. даже "1" и "0" идут в ботнет как текст от человека. Наблюдал на eggdrop 1.6.10. Официальная версия: верните 1, чтобы бот игнорировал событие и не обрабатывал его. FLUD Return 1 to ask the bot not to take action on the flood. Otherwise it will do its normal punishment. Верните 1, чтобы бот не реагировал на попытку фдуда. Иначе бот обрабатывает событие по своим правилам (идет наказание за флуд). RAW Return 1 to ask the bot not to process the server text. This can affect the bot's performance (by causing it to miss things that it would normally act on) -- you have been warned. Верните 1, чтобы бот не обрабатывал событие. CHON Return 1 to ask the bot not to process the partyline join event Верните 1, чтобы бот не обрабатывал событие входа человека в ботнет. Очень полезно, когда в чат боту входит тот, кого нужно сразу выкинуть из чата. CHOF Return 1 to ask the bot not to process the partyline part event Верните 1, чтобы бот не обрабатывал выход человека из чата. WALL Return 1 to make the command get logged liked so: !nick! msg Верните 1, чтобы бот не логировал разговоры irc-опов. (B) CONTROL PROCEDURES Using the 'control' command you can put a DCC connection (or outgoing TCP connection) in control of a script. All text that comes in on the connection is sent to the proc you specify. All outgoing text should be sent with 'putdcc'. Используя команду 'control' (повешенную на какий DCC канал, наример на сокет к веб-серверу или FTP) вы можете реагировать на приходящий от туда текст. Реагировать можно по разному, например, отвечаю в ответ, в данный канал с помощью putdcc. Весь текст (построчно), который пишут на той стороне канала, заставит бота каждый раз вызывает процедуру, которая была повешена как контрольная на dcc-каналом с помощью 'control'. Таким образом, вы можете привязать любую свою процедуру на событие прихода текста из dcc-канала. The control procedure is called with these parameters: procname <idx> <input-text> This allows you to use the same proc for several connections. The idx will stay the same until the connection is dropped -- after that, it will probably get reused for a later connection. Контрольная процедура вызывается с 2-мя аргумерами - номеров канала и пришедшим текстом (целая строка, без символов перевода каретки). Связь между каналом и процедурой живет до закрытия канала, а потом процедуру никто не вызывает (если только ее опять не поверят или не испольщуют для контроля многих каналов). To indicate that the connection has closed, your control procedure will be called with blank text (the input-text will be ""). This is the only time it will ever be called with "" as the text, and it is the last time your proc will be called for that connection. Dont call killdcc on the idx when text is blank, it will always fail with 'invalid idx'. Для сообщения котрольной процедуре, что канал был закрыт, ее вызывают с параметрами номера канала с пустым вторым параметром, т.е. строкой "". Это бывает только, когда канал уже был закрыт. Т.о. через контрольную процедуру никогда нельзя узнать, что в канал писали пустые строка. Процедуре передают только не пустые строки и целиком за один раз. Когда прислали "" канал уже закрыт и ничего нельзя туда писать (или пытаться закрыть по killdcc). If you want to hand control of your connection back to eggdrop, your proc should return 1. Otherwise, return 0 to retain control. Если вы контролируете DCC-чат с человеком, то верните 1, чтобы бот обрабатывал его. Если вернете 0, то бот проигнорирует посланную человеком строку текста. При контролировании TCP сокетов это не имеет никакого значения. (C) TCP CONNECTIONS Eggdrop allows you to make two types of TCP ("telnet") connections: outgoing and incoming. For an outgoing connection, you specify the remote host and port to connect to. For an incoming connection, you specify a port to listen at. Об этом я написал уже выше.. Eggdrop в состоянии организовывать TCL соединения типа "просто соединение" и обработка "прослушивание порта". Для примера. Первый тип - это браузер, который открыл сокет на порт сервера, забрал страницу HTML-текста или другой документ и отключился. А второй тип - это наоборот сервер, к примеру Веб-сервер, который открыл порт и ждет, чтобы туда кто-то подсоединился. Так вот, вы можете связять оба таких соединения со своей функцией, если используете control. All of the connections are *event driven*. This means that the bot will trigger your procs when something happens on the connection, and your proc is expected to return as soon as possible. Waiting in a proc for more input is a no-no. To initiate an outgoing connection, use: set idx [connect "hostname.goes.here" 3333] (as an example). $idx now contains a new DCC entry for the outgoing connection. Для организации соединения первого типа нужно для начала открыть сокет к хосту и его порту. Используйте не то, что написано выше, а мой код: if {[catch {set idx [connect "hostname.goes.here" 3333]}]} { putlog "Соединение не удалось установить" # обязательно прервать работу: return } # а это - если соединение успершно установлено и номер сокета # (dcc канала) хранится в $idx. Самое время повесить свою # дополнительную функцию на этот сокет. All connections use non-blocking (commonly called "asynchronous", which is a misnomer) I/O. Without going into a big song and dance about asynchronous I/O, what this means to you is: * assume the connection succeeded immediately * if the connection failed, an EOF will arrive for that idx Все коннекты по умолчанию являются "не блокирующего" типа. Чтобы понять, что значит блок. или не блок. тип соединения, вспомните файлы. Когда вы пишите "puts <файл> <текст>", то ваш процесс ПОДВИСАЕТ на время произведения записи. Т.е. если неожиданно к моменду puts у вас сдохнет винчестер, то ваш процесс навсегда зависнет, т.к. он вынужден будет ЖДАТЬ ОКОНЧАНИЯ ПЕРЕДАЧИ. Такое поведение чего-то либо с каналами данных (сокет, файл и т.д.) называется блокирующий тип передачи данных. А не блокирующий ничего не ждет, но и не обязан ничего вам выдать! К примеру, у нас открыт блокирующий и не блокирующий сокеты. Если попробовать прочитать из канала строку, то процесс1 подвиснет до момента получения из сокета строки (реально будет ждать), а второй просто ничего ждать не будет, а обратиться к буферу приема. Если в буфере будет уже накопленная строка, то второй процесс получит строку текста, как и просил. Если же текста нет, то он получит пустую строку, но не подвиснет. Свойства не блокирующего канала: - соединение происходит не мгновенно, а откладывается - отправка данных происходит не мгновенно, а как только ваша ОС это сможет передать, главное, ваш процесс не ждет ничего - когда соединение прервано, канал имет флаг EOF, что можно проверить по команде eof The only time a 'connect' call will return an error is if you gave a hostname and it couldn't find the IP for that hostname (this is considered a "DNS error"). Otherwise it will appear to have succeeded, and if the connection failed, you will immediately get an EOF. Команда connect может вернуть TCL ошибку, если боту не удалось преобразовать имя хоста в ip или соединение действительно не удалось установить. Поэтому факт установки соединения нужно проверять на наличии TCL ошибки, см. мой пример выше. Right after doing a 'connect' call, you should set up a 'control' for the new idx (see the section above). From then on, the connection will act just like a normal DCC connection that has been put under the control of a script. If you ever return "1" from the control proc (indicating that you want control to return to eggdrop), the bot will just close the connection and dispose of it. Other commands that work on normal DCC connections, like 'killdcc' and 'putdcc', will work on this idx too. 'killdcc' will fail with 'invalid idx' if you attempt to use it on a closed socket, ie when text is blank. Сразу после команды connect можно использовать команду control, чтобы привязать свою процедуру (по имени) и номер нового канала (сокета). После этого можно ничего не делать, а соединение станет стандарным DCC-каналом и будет управлятся с помощью контролирующей процедуры. Если вернуть 1 в контрольной процедуре (это означает, как говорилось выше, что вы хотите передать обработку соединению боту), то бот закроет соединение. Разумеется, бот не в курсе, как имено обрабатывать ваше личное соединение непонятно с кем. Поэтому в контрольной процедуре не используйте return, или используйте 'return 0', чтобы бот не закрывал соединения. Для закрытия сокета используйте killdcc и для записи в сокет - putdcc. Как видите, каналы (DCC-чата) и сокеты - это одно и тоже. Только по разному называется. To create a listening port, use: listen 6667 script grabproc which will create a new listening port at 6667, and assign it to the script 'grabproc'. Для прослушивания порта, т.к. установки второго типа соединений (см. начало этой главы), используйте listen. В нее нужно передать номер порта, который бот начнет слушать, и имя некой процедуры, но не подобно той, что мы привязывали выше к control. Параметр script - это просто слово, не меняйте его. Оно означает, что вы хотите открыть порт и повесить на соединение свою функцию. When a new connection arrives, eggdrop will connect it up and create a new idx for the connection. That idx is sent to 'grabproc'. The proc will generally want to immediately put this idx under control: proc grabproc {newidx} { control $newidx my_control } Once your grabproc has been called, the idx behaves exactly like an outgoing connection would. Когда произойдет соединение, то будет вызвана процедура grabproc, которой передадут номер открытого соединения. Вот тогда то и можно (нужно) повесить для нового соединения контролирующую процеруду. Возможно, тут нужно сделать другие действия, например закрыть сокет, если он вам не нравится, или написать туда любой текст и тогда закрыть. The best way to learn how to use these commands is to find a script that uses them and follow it carefully. Hopefully this has given you a good start though. (D) MATCH CHARACTERS Many of the bindings allow match characters in the arguments. Here are the four special characters: Во многих bind'ах, в параметрах 'command' можно писать не фиксированные слова, а целые маски: ? matches any single character любой один символ (но не пусто) * matches 0 or more characters of any type любая строка от 0 и более символов % matches 0 or more non-space characters (can be used to match a single word) любая строка не пробельных символов (буквы, цифры, символы) ~ matches 1 or more space characters (can be used for whitespace between words) один или более любых пробельных символов (просто пробел) Будьте осторожны. Хоть тут это и написано, да на практике многое не работает. В частности у pubm можно использовать "*", но "?" и другие не работают. Кроме документации на базовые функции существуют модули. Их документация в каталоге docs/ бота. Её я не перевожу, т.к. ни разу никаких модулей не использовал за их ненадобностью. Данный документ принадлежит только его автору - Дмитрий Бородин, и может быть доступен в Интернете только на сайте bot.net.ru. Любое копирование, кроме личного использования, запрещено. Что значит "лично использование", думаю каждый в курсе. Задолбали уже ламеры, которые берут и полностью копируют этот сайт, включая даже главную страницу. Smiles.