BS-2 wiki

Дата: Среда, 22.06.2011, 18:59 | Сообщение # 1

Полковник

Группа: Администраторы

Сообщений: 196

Статус: Offline

Для работы бота требуется Python 2.6 (or 2.7), а так же установленная библиотека py-sqlite3.

Чтобы скачать бота вам необходима система контроля версий - Subversion.

Командуйте в консоли:

svn checkout http://blacksmith-2.googlecode.com/svn/trunk Black-2

Далее:

В папке "static" есть 2 файла с расширением "ini" - это файлы конфигурации. Для начала переименовываем "config_.ini" в "config.ini". За тем заполняем его.

Пример корректного заполнения (после # - комментарии):

Code

[STATES]

# Использование безопасного соединения (True/False - вкл/выкл)

TLS = False

# Работа без прав администратора

MSERVE = True

# Отправка уведомлений об ошибках на жид владельца

GETEXC = True

# Язык бота (сейчас доступны: EN - Английский, RU - Русский)

LANG = RU

[CLIENT]

# Сервер на котором размещен аккаунт бота

SERV = jabber.ru

# Порт сервера

PORT = 5222

# Аккаунт бота

USER = SlackSmith

# Используемый хост (в большинстве случаев хост равен серверу)

HOST = xmpp.ru

# Пароль от аккаунта бота

PASS = *****

[CONFIG]

# Ресурс

RESOURCE = Black-2 by WitcherGeralt

# Статус бота по умолчанию

STATUS = Пиши «ХЕЛП» если не в теме...

# Ник бота по умолчанию

NICK = Black-2

# Jabber ID верховного администратора бота

ADMIN = manbearpig@xmpp.ru

[LIMITS]

# Лимит использования оперативной памяти (в мегабайтах)

MEMORY = 48

# Лимит длинны входящих сообщений (в знаках)

INCOMING = 10240

# Лимит длинны сообщений, отправляемых в чат

CHAT = 1024

# Лимит длинны приватных сообщений

PRIVATE = 2024

Если вам нужно чтобы бот использовал несколько JID`ов - переименуйте "clients_.ini" в "clients.ini" и впишите туда поля в виде "[CLIEN1]", "[CLIENT2]" и т.д. И заполните их аналогично блоку "[CLIENT]" в основном файле конфигурации. Или же добавьте их по команде "клиент"/"client".

Для получения помощи по командам - используйте команду "хелп"/"help". !НО - На данный момент в пакете присутствует неполный набор help-файлов.

Добавлено (22.06.2011, 18:59)
---------------------------------------------
Разбор описания синтаксиса команд в help-файлах на примере команды "ростер":

>> ростер (jid бота/номер jid`а) ([+/-] [jid] (nick) (админ))

В () круглых скобках записаны необязательные параметры, а так же блоки, обобщающие необязательные параметры, для указания обязательных (если блок используется) параметров внутри блока. В [] квадратных скобках указаны обязательные параметры. Через / слеш внутри скобок указаны параметры на выбор, но если / слеш один в скобках { (/) or [/] } - это значит, что он является одним из параметров.

Т.е. c командой "ростер" не обязательно использовать параметры, но если использовать их больше одного, то (смотрим в блок) ко второму параметру [+ или -] уже обязательно должен прилагаться третий [jid], а 4й и 5й опять же не обязательны, даже внутри блока.