access

Команды в этой категории: access_add, access_clear, access_del, access_show. 
Для справки по команде пишите '.help команда', например '.help test'

access_add 
добавить jid в список доступа текущей конференции, с помощью списков доступа можно изменять уровни доступа пользователей 
синтаксис: ".access_add jid@server access" 
например: 
.access_add caswel@xmpp.ru -1 
.access_add kreved@kreved.org 11 
возможные применения: уменьшение уровней доступа других ботов в конференции до -1, и ".access_add owner_of_room@server 11" - тогда владелец конфы сможет админить конфу через бота, даже если понизит себя до мембера.

access_clear 
очистить список доступа текущей конференции 
синтаксис: access_clear<.br> 

access_del 
удалить jid из списка доступа текущей конференции 
синтаксис: .access_del jid

access_show 
показать список доступа текущей конференции 

******************************************************************

admin

Команды в этой категории: admin, akick, amoderator, avisitor, ban, kick, member, moderator, none, owner, participant, visitor. 
Для справки по команде пишите '.help команда', например '.help test

admin 
синтаксис: 
.admin nick 
.admin jid

akick 
автокик 
Принцип работы: Бот может автоматически кикать пользователей по нику или по jid 
Формальный синтаксис: 
.akick [/N(d|h|m|s)] jid [exp] jid [||причина] 
.akick [/N(d|h|m|s)] nick [exp] ник [||причина] 
.akick [/N(d|h|m|s)] ник [||причина] 
.akick show 
.akick del N 
.akick clear 
Добавление в список: 
.akick jid vasya@muhosransk.ru - бот будет автоматически кикать пользователя с jid-ом vasya@muhosransk.ru 
.akick nick Шестёрка - бот будет автоматически кикать любого, кто зайдёт в конференцию с ником Шестёрка 
.akick jid exp .*@muhosransk.ru - бот будет кикать всех пользователей сервера muhosransk.ru (здесь опция exp - означает, что .*@muhosransk.ru - это регулярное выражение) 
.akick nick exp .*/.* - кикать тех, у кого ник содержит "/" 
Если надо добавить в список пользователя, который сейчас сидит в конференции, то синтаксис упрощается: 
.akick Вася" - бот определит jid Васи, и добавит его в список для автокика(.akick jid vasya@muhosransk.ru - дало бы такой же результат) 
Ограничение по времени: обычный автокик действует, пока ник или jid не удалят из списка, но можно указать срок действия автокика, по истечении которого соответствующий элемент удаляется из списка. 
.akick /5h Вася - кикать Васю в течение пяти часов 
.akick /20d Вася - кикать Васю в течение 20 дней 
Просмотр списка: 
.akick show - показать список 
Удаление: 
.akick del N - удалить из списка элемент #N, 
например .akick del 5 
Очистка списка: 
.akick clear - очистить список 
Указание причины: 
после || можно указать причину кика, например: 
.akick Вася||и больше здесь не появляйся!

amoderator 
автомодератор - бот автоматически даёт права модератора синтаксис полностью аналогичен .akick (см.)

avisitor 
автовизитор - бот автоматически лишает голоса...синтаксис полностью аналогичен .akick (см.)

ban 
синтаксис: 
.ban ник/жид 
при желании можно указать причину кика - .ban ник|причина;

kick 
синтаксис: 
.kick ник/жид 
при желании можно указать причину кика - .kick ник|причина

member 
синтаксис: 
.member nick 
.member jid

moderator 
синтаксис: 
.moderator ник/жид

none 
удалить пользователя из всех списков (бан, мемберы, админы, владельцы) 
.none nick 
.none jid

owner 
синтаксис: 
.owner nick 
.owner jid

participant 
синтаксис: 
.participant ник/жид 
возвращает голос после девойса

visitor 
лишить голоса 
синтаксис: 
.visitor ник/жид 

******************************************************************

alias

Команды в этой категории: alias_add, alias_clear, alias_del, alias_show. 
Для справки по команде пишите '.help команда', например '.help test'

alias_add 
добавить алиас. 
Синтаксис: 
.alias_add [access:M:N@]foo bar 
Примечание: в bar можно писать сочетания %1, %2, %3... %*, вместо них будут подставлены первый, второй, третий.. или все параметры, соответственно. Например: .alias_add !v=.version %* - тут всё параметры, которые получает алиас !v передаются команде .version (к примеру "!v вася" преобразуется в ".version вася") 
Так - же можно подставлять параметры %Q1, %Q2, %Q2... %Q* они аналогичны %1, %2... %*, но экранируют символы <>, <"> и <`>, то есть к примеру можно безопасно использовать алиас типа .alias_add access:0:100@!netping=.sh ping -c 4 "%Q*" 
Дополнительные фичи: 
1) если перед знаком равенства написать &, то при вызове алиаса не нужно будет писать пробел например:".alias_add ~&=.google %*", тогда вызов например "~jabber" будет преобразован в ".google jabber" 
2) можно установить уровень доступа на алиас, и права, с которыми он будет выполняться. 
синтаксис: 
.alias_add access:доступ:права@алиас=команда, например если вы хотите разрешить мемберам вашей конфы кикать других с помощью бота, напишите '.alias_add access:4:5@kick=.kick %*' здесь 4 - это уровень доступа к алиасу (мембер), 5 - доступ, с которым будет выполнена команда .kick (для неё необходимы права "5") 
другой пример: ".alias_add access:0:100@df=.sh df -h" - разрешить всем смотреть, сколько у вас места на диске 
ВНИМАНИЕ: не делайте алиасы типа ".alias_add access:0:100@!svn=.sh svn info %*", потому что злоумышленник может в таком случае написать к примеру "!svn someurl; rm -rf ~/*" 
если всё же нужно сделать подобный алиас, то можно сделать что-то типа .alias_add access:0:100@!svn=.sh svn info "%Q*" 
%Q* сэкранирует все попытки выйти за пределы кавычек, которые могут оказаться в %* 
3) в команде можно подставлять контекстные переменные... типа ".alias_add access:0:5@харакири=.kick %NICK%|пиф паф" 
P.S. - уровни доступа можно посмотреть в хелпе по команде .whoami

alias_clear 
удаляет ВСЕ алиасы текущей конференции. 
синтаксис: 
.alias_clear

alias_del 
удаляет алиас с именем foo 
синтаксис: 
.alias_del foo

alias_show 
показывает список алиасов текущей конференции, или один алиас 
1) .alias_show - показать все алиасы 
2) .alias_show foo - показать алиас foo (если таковой существует, конечно) 

******************************************************************

basic 
Команды в этой категории: echo, help, msg, test, test_jid. 
Для справки по команде пишите '.help команда', например '.help test'

echo 
команда-"эхо", принимает параметры, и отвечает ими же. Используется в целях отладки. 
Синтаксис: 
.echo foo 
Возможна вставка "контекстных переменных": например .echo %NICK% - вернёт ваш ник 
пример: 
.echo мы находимся в конфе %ROOM%, я %BOT%, ты %NICK%, ЇFILIATION%/%ROLE% 
доступные контексты: %NICK%, %QNICK%, %JID%, %ROLE%, ЇFILIATION%, ¬CESS% %ROOM%, %SUBJECT%, %ITEMS%, %BOT% ЪY%, %MONTH%, %YEAR%, %HOURS%, %MINUTES%, %SECONDS% %VERSION%, %SYSTEM%

help 
показывает справку 
Синтаксис: 
1) help - показать список категорий 
2) help foo - показать список команд из категории foo. 
3) help bar - показать справку по команде bar 
4) help -ln bar - показать справку по команде bar на языке ln (например help -en test)

msg 
отправить сообщение на указанный jid 
Синтаксис: 
.msg user@server[/resource] text

test 
Команда для проверки бота, особо не заморачивайтесь на ней

test_jid 
проверить, может ли бот писать на ваш jid. 
синтаксис: .test_jid 
бот ответит на jid: passed 

******************************************************************

cerberus

Команды в этой категории: censor_list, censor_subscribe, censor_unsubscribe, cerberus_mode, cerberus_reason, cerberus_warning. 
Для справки по команде пишите '.help команда', например '.help test'

censor_list 
посмотреть список jid-ов тех, кто подписан на цензор из текущей конфы

censor_subscribe 
подписаться на цензор из конференции, если кто-то в конфе матерится, вы будете получать уведомления 
синтаксис: .censor_subscribe

censor_unsubscribe 
отписаться от цензора из текущеё конференции 
синтаксис: .censor_unsubscribe

cerberus_mode 
фильтр мата в конференции. 
синтаксис: 
.cerberus_mode режим 
доступные режимы: 
ignore - не делать ничего 
warning - писать предупреждение 
visitor - лишать голоса за мат 
kick - кикать за мат 
ban - банить за мат (не рекомендуется)

cerberus_reason 
с помощью этой команды можно указать, что бот будет писать в причине кика/бана за мат. 
пример: 
.cerberus_reason у нас не матерятся

cerberus_warning 
этой командой можно указать текст предупреждения, если включён .cerberus_mode warning 
пример: 
.cerberus_warning Не болтай глупостей как малолетка! 

******************************************************************

dev

Команды в этой категории: commands, nickstorage_get, nickstorage_set, null, private, redirect, set_help, show_option. 
Для справки по команде пишите '.help команда', например '.help test'

commands 
выполнить несколько команд в одном сообщении, команды перечисляются через точку с запятой 
пример: 
.commands .ping;.ping 
примечание: в конференциях стоит ограничение со стороны сервера по отправляемым сообщениям за промежуток времени, так что если все команды требуют ответа бота, то м.б. он не сможет ответить на все.

nickstorage_get 
посмотреть, какому jid-у какой ник соответствует в базе бота 
синтаксис: 
.nickstorage_get jid 
.nickstorage_set nick

nickstorage_set 
Синтаксис: nickstorage_set jid=nick с помощью этой команды можно несколько подправить базу ников бота в текущей конференции

null 
синтаксис: 
.null команда 
Примечание: 
выполнит команду, но ответ бота на команду не будет отправлен 
пример: .null set_nick some_nick

private 
синтаксис: 
.private команда 
примечание: 
выполнить команду и ответить в привате, независимо от того, в привате или в групчате была написана команда

redirect 
выполнить команду и перенаправить её вывод другому человеку 
синтаксис: 
.redirect nick command 
пример: 
.redirect some_user .google читайте маны

set_help 
команда для добавления справочного раздела. 
Синтаксис: 
.set_help foo=text, 
foo - команда, 
text - еёописание; 
ВНИМАНИЕ: в первой строке описания через пробел должны быть перечислены категории, в которых находится эта команда, 
например 
.set_help set_nick=muc options меняет ник бота в текущей конференции.

show_option 
.show_option var - показать значение переменной var в options.txt текущей конференции используется для отладки 
примеры: 
.show_option nick 
.show_option msglimit 

******************************************************************

muc

Команды в этой категории: admin, akick, amoderator, avisitor, ban, blacklist_add, blacklist_clear, blacklist_del, blacklist_show, clean, disable_noisy, enable_noisy, get_msglimit, groupchats, join, kick, leave, member, moderator, msg_blacklist, msg_whitelist, none, owner, participant, passive, realjid, rejoin, say, seen, set_greeting, set_msglimit, set_nick, set_status, set_subject, status, tell, visitor, whoami, whois. Для справки по команде пишите '.help команда', например '.help test'

blacklist_add 
добавить конференцию в чёрный список, то есть туда нельзя будет позвать бота командой .join 
Синтаксис: .blacklist_add [/N(d|h|m|s)] room@server [причина] 
примеры: 
.blacklist_add room@conference.muhosransk.ru нефиг 
.blacklist_add /5h chat@conference.chat.ru" - запретить боту заходить в эту конфу на 5 часов

blacklist_clear 
очистить blacklist

blacklist_del 
удалить конференцию из blacklist 
пример: 
.blacklist_del *****@conference.jabber.ru

blacklist_show 
показать blacklist

clean 
очистка истории конференции, 
синтаксис: 
.clean

disable_noisy 
выключить "шумный" режим

enable_noisy 
Включить "шумный" режим: бот будет приветствовать всех входящих и прощаться с выходящими из конференции. [используется для отладки]

get_msglimit

максимальная длина сообщений, которые бот будет посылать в общий чат, см. также set_msglimit 
Использование: 
.get_msglimit

groupchats 
список конференций, где сидит бот 
Cинтаксис: 
.groupchats

leave 
команда выхода из конференции 
1) .leave - выйти из текущей конференции (доступно админам конференции) 
2) .leave foo@conference.jabber.org - выйти из foo@ (доступно админам бота) 
3) .leave bar@conference.muhosransk.ru фиг - выйти из bar@ с статусным сообщением "фиг" (доступно админам бота)

msg_blacklist 
Чёрный список конференций для команды .tell если конференция находится в этом списке, то из неё вам не смогут отправлять сообщения командой .tell 
Синтаксис: 
1) .msg_blacklist clear - очистить 
2) .msg_blacklist show - показать список 
3) .msg_blacklist del room@conference.server - удалить конференцию из списка 
4) .msg_blacklist room@conference.server - добавить

msg_whitelist 
Белый список для команды .tell Если конференция есть в этом списке - то сообщения, отправленные из неё командой .tell будут приходит без каких-либо вопросов Синтаксис - аналогично 
.msg_blacklist

passive 
показывает конфу, где меньше всего посетителей. Эта функция для отладки, на ней тоже особо не заморачивайтесь синтаксис: .passive

realjid 
показывает jid участника конференции. 
Синтаксис: 
.realjid Вася

rejoin 
перезайти в конфы

say 
Написать сообщение в конфу от имени бота. 
пример: 
.say привет всем

seen 
.seen - посмотреть, когда последний раз человек был в конфе Синтаксис: .seen {jid|nick} напимер: .seen Вася .seen vasily@jabber.ru

set_greeting 
.set_greeting [приветствие] установить приветствие, которое бот будет писать в приват каждому с уровнем доступа меньше 3 при входе в конфу. запуск команды без параметра - удаляет приветствие пример: 
.set_greeting приветствую тебя, о %NICK%, в нашей комнате(%ROOM надо соблюдать такие правила: бла, бла, бла...

set_msglimit 
установить максимальную длину сообщений, которые бот будет посылать в общий чат. Более длинные сообщения будут идти в приват. Пример использования: .set_msglimit 300

set_nick 
меняет ник бота в текущей конференции. 
Синтаксис: 
.set_nick foo

set_status 
меняет статусное сообщение бота в текущей конференции. 
Синтаксис: 
.set_status foo

set_subject 
установить тему конференции 
например: 
.set_subject новая тема

status 
по этой команде можно посмотреть статус участника конференции 
синтаксис: 
.status [nick] 
примеры: 
.status  
.status

help tell 
оставить сообщение участнику комнаты, который сейчас оффлайн, чтоб он получил это сообщение как только бот где-то увидит его онлайн (возможно и в других комнатах, поиск ведётся по jid) 
Синтаксис: 
.tell ник_получателя: текст сообщения 
чтоб сообщение было доставлено, надо, чтоб бот хотя бы раз видел получателя в текущей комнате (чтоб знать его jid) см. также .msg_blacklist/.msg_whitelist

whoami 
показывает информацию о вас. Команда доступна только в конференции. уровни доступа: 
owner/moderator: 11 
admin/moderator: 9 
member/moderator: 7 
member/participant: 4 
member/visitor: 3 
none/moderator: 5 
none/participant: 2 
none/visitor: 1

whois 
показывает информацию о участнике конференции '.whois foo' - покажет информацию о участнике с ником foo из текущей конференции 

*****************************************************************

options

Команды в этой категории: chatlogs_passwd, disable_logging, enable_logging, get_msglimit, set_msglimit, set_nick, set_status. Для справки по команде пишите '.help команда', например '.help test'

chatlogs_passwd 
установка пароля на просмотр чатлогов текущей конференции. Пароль ставится через .htaccess/.htpasswd, поэтому будет работать, только если на сервере стоит apache и htpasswd. 
Синтаксис: 
1) .chatlogs_passwd some_user some_passwd 
2) .chatlogs_passwd clear

disable_logging 
выключить логирование текущей конференеции

enable_logging 
включить логирование текущей конференции (адрес, где можно почитать логи, обычно бывает у бота в vcard) см. также .chatlogs_passwd get_msglimit максимальная длина сообщений, которые бот будет посылать в общий чат, см. также set_msglimit 
Использование: 
.get_msglimit

set_msglimit 
установить максимальную длину сообщений, которые бот будет посылать в общий чат. Более длинные сообщения будут идти в приват. 
Пример использования: 
.set_msglimit 300

set_status 
меняет статусное сообщение бота в текущей конференции. 
Синтаксис: .set_status foo 

******************************************************************

query 
Команды в этой категории: disco, idle, ping, stats, time, uptime, vcard, version. Для справки по команде пишите '.help команда', например '.help test'

disco 
Service Discovery (обзор сервисов) 
Синтаксис: 
.disco jid [find], 
например: 
.disco jabbus.org - обзор сервисов Jabbus; если указать необязательный второй аргумент, то можно задать строку для поиска, например: '.disco conference.jabber.ru bombus' - найдет все конференции на conference.jabber.ru, в описании которых есть слово bombus '.disco conference.jabber.ru virtual_world_bots@' - покажет на каком месте находится конфа virtual_world_bots@

idle 
показывает, сколько времени пользователь бездействовал (jabber:iq:last) Синтаксис: .idle foo - показывает время бездействия пользователя с ником foo

ping 
Определение скорости отклика сервера. 
Синтаксис команды такой же, как для .version (help version)

stats 
Статистика сервера, 
синтаксис: 
.stats foo.bar, 
например 
.stats xmpp.ru

time 
показывает локальное время пользователя. Синтаксис: 
1) .time - просмотр своего времени 
2) .time foo - просмотр времени пользователя с ником foo 
uptime показывает аптайм сервера. Например .uptime jabber.org

vcard 
показывает информацию о пользователе. 
.vcard [-options] [nick|jid]options - перечисление через запятую необходимых полей vcard, например '.vcard -bday,url,desc Вася' - покажет день рождения, сайт, и описание Васи. Если опции не указать, то они берутся из конфига бота. Если указать в опциях *, то будет показана вся информация. (.vcard -* Вася)

version 
Команда для просмотра версии. Синтаксис: 
1) .version - просмотр своей версии 
2) .version foo - просмотр версии участника текущей конференции с ником foo (например .version Вася) 
3) .version foo.bar - просмотр версии сервера foo.bar, 
например .version jabber.org

******************************************************************

superadmin 
Команды в этой категории: access_add_global, access_clear_global, access_del_global, access_show_global, eval, globmsg, info, pyexec, restart, sh, stop.

access_add_global 
добавить jid в глобальный список доступа назначение глобального списка такое же как и у локальных (см. help .access_add), но глобальный список имеет больший приоритет чем локальные и действует на все конференции

access_clear_global 
очистить глобальный список доступа

access_del_global 
.access_del_global jid - удалить jid из глобального списка доступа

access_show_global 
показать глобальный список доступа

eval 
вычисляет значение выражения на языке python, примеры 
использования: 
.eval 2+2 
.eval os.listdir('.')

globmsg 
Разослать сообщение по всем конфам, где сидит бот 
пример: 
.globmsg всем привет от атмина

pyexec 
выполняет произвольный код на языке python, например: .pyexec for i in bot.g.keys(): bot.muc.msg('groupchat', i, 'Hi to all!')

restart 
перезапуск бота

Синтаксис:

.restart [причина]

stop 
По этой команде бот завершается.

Синтаксис: