CBK
ICQ Chat бот v1.4:: Справка

[Содержание]

• Отличия от версии 1.1
• Что нового в версии 1.3;1.4
• Возможности чата
• Настройка чата
  • Настройка общих параметров
  • Настройка базы данных
  • Настройка команд
    • Расширяемые команды
  • Настройка интерфейса
  • Настройка сообщений
  • Фильтры
  • Дополнения
    • Рассылка новостей
    • Система голосования
    • Викторины
    • Квесты
    • Оповещения
  • Админские команды, админство и модераторство
  • Переход с более ранних версий, обновление
  • FAQ
  • Системные требования
• Полезные советы

  ---

Отличия от версии 1.1[наверх]

1. Добавлен ID. ID - уникальный номер пользователя чата. Пока ID используется в новых командах приват, кик и бан, а также в оружии. В следующих версиях бота ID можно будет использовать и в старых командах. ID обнуляются раз в сутки, и присваиваются пользователям по мере их попадания в чат. Сделано это для того, чтобы ID не были слишком большими (например если в вашем чате 20-50 тыс. человек)
2. Добавлено оружие. Теперь пользователи могут тратить свой рейтинг, покупая оружие. Конфигурируется оружие на вкладке "Команды". Подробнее о нем написано в разделе о командах
3. Добавлен приват [ура, товарищи!))]. Хоть долгое время разработчик был категорически против привата, и говорил чтоб смотрели инфу и писали в личку, но его так достали что он все закодил.
4. Теперь можно указать несколько админов чата (на первой вкладке, через ";" )
5. Реализованы мелкие пожелания, такие как скрыть подсказки о командах reg/go, управлять фильтрацией ссылок.

Отличия от версии 1.2 [наверх]

1.3

[Добавлено]

1. Теперь программа работает бесплатно для всех, без ключа, при условии что в чате зарегистрировано не более 10 человек (демо режим). Для снятия этого ограничения требуется купить ключ
2. Отныне программа называется CBK
3. Возможность удаления пользователей из программы
4. Опция отключение повторного бана (перебан)
5. Опция привелегии администрации: модераторы и администраторы получают следующие привелегии: не вылетают из чата при молчании; не поддаются действию оружия и команд других модераторов.
6. Квесты: Администрация чата может задавать коды, устраивая тем самым квесты(например спрятав где-то в городе или и Интернете). Пользователи должны разгадывать квесты, победитель получает прибавку к рейтингу.

[Исправлено]

1. Баг с сообщением о проблемах соединения
2. Команды администрирования (при акузании нескольких админов)
3. Бан через программу

1.4

1. Атозагрузка
2. Перераспределение ID по рейтингу, правка ID
3. Оповещения по таймеру от [SERVER]
4. Более удобные команды по умолчанию
5. Добавлено сжатие и оптимизация БД

Возможности чата [наверх]

Общие:
[+] Не нуждается в установке
[+] Высокая устойчивость (справляется с большим числом пользователей онлайн, вместительная база данных)
[+] Автоматизация (автоматически перезаходит при потере соединения, соблюдает выдаваемые сервером таймауты)
[+] Интерфейс чата можно полностью менять (комнаты, сообщения, лимиты)
[+] Контроль за порядком (автокик за мат, админство, модераторство)
[+] База данных формата MS Office Access (удобно хранить, подключать/отключать, менять, редактировать)
[+] Возможность редактирования БД в самой программе
[+] Все команды можно настроить, изменив имена, указав их явное использование с символом "!" или без него
[+] Возможность добавлять свои команды на чтение/запись из файлов (например можно подключить погоду, анекдоты, если имеются обновляемые со стороны файлы)
[+] Возможность менять статусы
[+] Возможность добавления рекламы в чат
[+] Фильтр на ссылки (препятствует блокировке UINа)
[+] Возможность удаленно менять модераторов, включать/выключать/менять рекламу
[+] Все настройки собраны в файл базы данных
[+] Полная совместимость с более ранними версиями. Все настройки конвертируются, сохраняются

Ограничения:
[+] Можно установить лимиты на количество комнат и пользователей в чате
[+] Ограничение длины сообщения в чат

Модули:
[+] Рассылка новостей
[+] Система голосования
[+] Викторины
[+] Оружие
[+] Квесты [new]
Функции:
[+] Поиск по UINу
[+] Пользователи имеют возможность создавать свои комнаты
[+] Возможность создания серверных комнат, в отличии от пользовательских они не распускаются
[+] Пользователи имеют возможность переходить по комнатам, заходить сразу в нужную комнату (находясь в чате или вне чата)
[+] Полная статистика (загруженность, пользователи, аптайм...)
[+] Автоматическое выкидывание из чата в случае долгого молчания
[+] Пользователи могут указывать свои города. Города прописываются в чат
[+] Пользователи могут указывать сою инфу, читать инфу других,
[+] Ведется рейтинг активности пользователей, имеется топ. (1 ед. рейтинга = 1 проведенному в чате часу)
[+] Автокик за мат (словарь можно редактировать)
[+] Запуск из командной строки с параметром (автостарт, сворачивание)
[+] Имеется лог
[+] Передача рейтинга
[+] Приглашение
[+] и многое другое...

Настройка общих параметров [наверх]

Перед вами окно программы, вкладка "Общее". Здесь настраивается основные параметры, рассмотрим их подробно:

• UIN - уин вашего чата
• Пароль - пароль вашего чата
• Админы - уин администратора (в данном случае ваш UIN) или несколько UINов через запятую. С данного уина можно назначать и удалять модераторов, включать, выключать, менять рекламу.
• Статус - ICQ статус вашего бота
• Таймаут отпр. - очень важный параметр. Он определяет величину пауз между отправкой сообщений ботом. По умолчанию сервер позволяет отправлять сообщения не чаще чем каждые 1.5с (1500мсек). Но этот параметр не постоянный, он зависит от количества пользователей ICQ онлайн, у которых в контактлисте ваш бот. Например если бот достаточно раскручен, можно понижать этот параметр (!осторожно). Например на одном из моих ботов (~25 400 пользователей) этот параметр ~300мс. Еще один момент: когда бот становится очень популярным (у многих в листе), сервер может ставить ему статус "невидим". Делается это в целях предотвращения перегрузок.
• Таймаут чата - тут все просто. Это интервал, через который происходит сбор и рассылка накопившегося чата по пользователям.
• Подключить - при нажатии этой кнопки чат переходит в режим онлайн, заходит в сеть и перезаходит при разъединениях.
• Вести лог - если включить эту опцию, все приходящие на UIN бота сообщения будут записываться в файл chatlog.txt
• Админы - Список админов чата (через ;)
• Автозагрузка - Запускат ьпри старте Windows

Настройка базы данных [наверх]

• Бот использует базу формата MS Office Access, что позволяет работать с базой и при помощи Access. Здесь все достаточно просто. В поле "Файл базы" указан путь к файлу базы данных бота, это всегда base.mdb, находящийся в папке с программой. Для обновления данных базы в программе имеется кнопка . Для изменения инфы какого-либо пользователя выбираем его в списке (для быстрого поиска имеется фильтр - поле под списком), в группе "Информация" вносим изменения и нажимаем на дискетку для сохранения данных. Базу можно редактировать и в Access, причем даже когда бот работает.

Настройка команд [наверх]

• Регистрация. Пример: reg Денис
• Вход. Команда для входа в чат. Пример: go
• Выход. Выйти из чата. Пример: exit.
• Установить город. Устанавливает город пользователя. Пример: mygorod Москва. Для удаления города отправляется команда без параметра (просто mygorod)
• Установить инфу. Команда устанавливает инфу пользователя. Пример: myinfo 19 лет, программист. Для удален инфы используется без параметра (просто myinfo)
• Читать инфу. Эта команда собирает всю информацию о пользователе (ник, кин, инфа, город, рейтинг, число переименований, бан). Пример: info денис.
• Переименование. Команда меняет ник. Пример: rename *дениска*.
• Создать комнату. Команда создает комнату. При этом не важно где находится пользователь. Если он не в чате, то при создании комнаты он автоматически в нее перемещается. Чат оповещает пользователей о всех перемещениях пользователей и изменениях комнат. Пример: skom знакомства.
• Перейти в комнату. Команда говорит сама за себя. Пользователь может перейти в комнату находясь в чате или вне чата. Пример: kom знакомства.
• Список кто в комнате. Команда отправляет список кто в комнате. Если имя комнаты не указано, отправляет список пользователей текущей комнаты. Пример: vkom общая.
• Список кто в чате. Простая команда. Показывает комнаты, пользователей и их суммарное количество. Пример: users.
• Справка. Отправляет справку бота. Редактировать её можно нажав на кнопку . Пример: help.
• Правила. Отправляет правила. Пример: rules.
• Написать админу. Команда принимает сообщения от пользователей. Просмотреть их можно нажав на кнопку справа. В строке указывается дата, ник, уин и сообщение. Пример: adm отличный чат, спасибо!.
• Топ. Команда отправляет ТОП XX пользователей, где XX - количество. Пример: top.
• Статистика. Отправляет статистику. Пример: stat.
• Кикнуть. Команда, доступная модераторам и администратору, выкидывает пользователя из чата. Использование: kik ник;причина. Пример: kik олень;вы олень
• Забанить. Команда банит пользователя на определенный срок. Использование: ban дни;ник;причина. Пример ban 10;олень;Вы олень. Для разбана: ban 0;олень;Вы прощены
• Кикнуть по ID - аналог предыдущей команды, только вместо ника нужно писать ID, а вместо ; пробелы. Пример: кик 5 Не материтесь
• Забанить по ID - тоде бан, только не по нику а по ID. Пример: бан 15 5 Бан на 15 суток
• Голосование - Отправляет текущее голосование (заголовок и варианты). Пример: vote
• Проголос. - Проголосовать. Пример: ivote 3
• Результ. гол. - Результаты голосования. Пример: rvote
• Пер. Рейтинг - Отправить рейтинг другому пользователю. Пример: sendrat 5;danila
• Викторина - Отправить ответ на викторину (в момент её проведения). Пример: vic 15547
• Пригласить - Приглашает нового пользователя в чат. Пример: inv 123456789
• Поиск по UIN - Аналог команды Info, только поиск идёт не по нику а по уину. Пример: uinfo 123456789
• Приват ID сообщение- отправить личное сообщение пользователю. Пример: #5 ты мне нравишься ;)
• Не подсказывать команды - бот не будет подсказывать как называются команды для регистрации/входа в чат. Включите эту опцию если вы хотите ограничить доступ к чату.

Оружие:

• Купить <оружие> - команда для покупки оружия. Пример: купить wbomba
• Справка - отправляет список оружия бота, как его использовать и сколько оно стоит. Пример: weapons
• wkiker ID - выдидывает пользователя из чата. Пример: wkiker 10
• wreplacer ID1 ID2 - меняет местами ники у 2 пользователей. Пример: wreplacer 5 10
• wrenamer ID ник - переименовывает пользователя. Пример: wranemer 10 Лосяшшшка
• wratkiller ID - обнуляет весь рейтинг пользователя. Пример: wratkiller 10
• wbomba ID Секунды / Wbomba ID - Запускает/передает бомбу пользователю. По истечении времени бомба взрывается и ее обладатель попадает в бан на сутки. Прмимер: wbomba 10 60 или wbomba 15 (первый пример - запускает бомбу в пользователя 10 на 60 секунд, второй - перелать бомбу к пользователю 15)
  

Квесты:

• Отправить код- этой командой отправляем боту найденный в квесте код. Пример: code 96554147
• Текущий квест - Показывает текущий активный квест (если таковой имеется). Пример: quest
• Добавить квест - добавляет в очередь новый квест. Админскач команда. Использование: addquest код;рейтинг;задача;[шаг](шаг - не обязательный параметр, указывается если квест должен отрыть следующий квест) Пример: addquest 123456;300;Найти под деревом код;шаг
  addquest 668877;300;отсчитать от дерева пять шагов на север
• Удалить квест - Удаляеет текущий квест. Пример: delquest
• История квестов - Вадает список пройденных в боте квестов. Пример: quests
• Сообщать о квесте каждый час - если включить эту опцию, то каждый час во все комнаты бота будет сообщаться текущий квест

* Команды бан и кик можно использовать не находясь в чате, собственно как и все остальные.
При включенной опции 'Игнорировать "!" перед командой', бот не будет обращать внимания на символ "!". Например команды !help и help будут восприниматься одинаково. Для явного разделения команд от сообщений можете отключить эту опцию (например чтобы команды не попадали в чат при опечатках).

Расширяемые команды [наверх]

В боте имеется возможность добавления своих команд (расширяемые команды). Это могут быть команды на чтение/запись файлов. Например вы можете обновлять (вручную или с помощью сторонней утилиты) файлы с погодой, анекдотами, задав в боте команды на их чтение.

Настройка интерфейса [наверх]

• Выкидывать после: Чат будет выкидывать пользователей, которые долго ничего не пишут.
• Лимит пользователей: максимальное количество пользователей, одновременно находящихся в чате.
• Лимит комнат: Максимальное число одновременно открытых комнат.
• Max. длина сообщения в чат: ограничение на длину сообщения, отправляемого пользователем в чат.
• Добавлять рекламу: бот будет дописывать ко всем сообщениям (кроме чат-сообщений) рекламу из файла \files\reklama.txt. Это может быть какое-либо объявление или оплачиваемая со стороны реклама.
• Включить автокик за мат: Бот какнет пользователя, если обнаружит в его сообщении мат. Словарь хранится в файле \files\matbase.txt. Описывайте по 1 слову(корню) в строке. Регистр значения не имеет. Бот не обращает внимания на символы " ", ".", ",".
• Включить города: полезная опция если в вашем чате сидят люди из разных городов. При включенной опции перед ником в чате будет прописан город.
• Пришел/ушел: бот будет оповещать пользователей о тех кто вошел в чат и вышел из чата. Удобно когда в чате сидит не много человек.
• Удалять пустые комнаты. Бот будет 2 раза в минуту смотреть есть ли пустые комнаты, если есть - будет удалять их. Бот не удаляет серверные комнаты.
• * Серверные комнаты - эти комнаты бот будет автоматически создавать при запуске. Они не могут быть удалены автоматически.
• Скрывать UIN - uinы пользователей не будут отображаться в инфе.
• Не прис. свои сообщ. - при включённой опции пользователь не увидит в чате своих сообщений. (Экономит трафик но сидеть в чате некомфортно)
• Отображать ID - при  включении этой опции в чате будут отображаться ID пользователей
• Не фильтровать ссылки - при включении опции бот не будет стирвать ссылки (внимание, при чатсой рассылки ссылок с UINа, последний рискует получить блокировку от сервера ICQ)
• Не стирать переносы строк - в чат будут попадать многострочные сообщения в той форме, в которой их отправили
• Отключить перебан - запрет повторного бана/снятия бана другими модераторами
• Привилегии администрации - модераторы и администраторы получают следующие привилегии: не вылетают из чата при молчании; не поддаются действию оружия и команд других модераторов.

Настройка сообщений [наверх]

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

Фильтры [наверх]

В боте предусмотрены автоматические фильтры:

• Запрет на ник SERVER
• В нике не допускаются символы: ` " ' ; [ ]
• Все ссылки стираются (http://, http, www, .ru, .com, .net ...)
• В бот проходят только отображаемые символы (кириллица, латиница, цифры, необходимые символы)
• * Писать сообщения в несколько строк сможет только админ. Это бывает необходимо при смене рекламы.

Дополнения [наверх]

Рассылка новостей [наверх]

Иногда возникает необходимость сообщить всем пользователям чата какую-либо новость. Для этих целей создан данный модуль. Для рассылки достаточно заполнить текст новости, выбрать круг получателей и нажать на "начать". Сперва бот соберёт список получателей, затем начнет рассылку новостей. Скорость рассылки можно изменять в процессе работы, но если она начнёт мешать работе чата, бот сам понизит скорость до необходимого уровня.

Система голосования [наверх]

Также бывают случаи, когда требуется опросить пользователей чата. Для этих целей создан модуль "Голосование". Как видно из скриншота, достаточно заполнить поле "Текст голосования", добавить варианты и поставить галочку "Голосование включено". Пользователи смогут голосовать и смотреть результаты. Для создания нового голосования отредактируйте его текст, варианты, затем нажмите на "Сброс".

Викторины [наверх]

Этот модуль сделан для развлечения пользователей. Смысл прост - с определённой частотой бот включает в чате викторину, рассылая сообщение по всем комнатам. Бот формирует арифметический пример (сложность настраивается в модуле), это может быть например 15+9*7/2, первый кто отправит верный ответ получит к своему рейтингу указанное число единиц, причем это может быть и отрицательное число. Для создания викторины в текущий момент времени нажмите на кнопку "Создать сейчас".

Квесты [наверх]

Данная затея состоит в следующем: организаторы (админы чата) прячут по городу или в Интернетах коды, забивают их в бот, а несчастные пользователи должны их разгадывать/отыскивать. Первый нашедший получает прибавку к рейтингу

Оповещения [наверх]

Этот модуль позволяет отпарвлять в чат сообщение от имени вервераа, с указанной периодичностью (например объявление)

Админские команды, админство и модераторство [наверх]

Админские команды (* использовать их может только администратор)

• setmoder uin - назначить модератора. Пример: setmoder 123456789
• delmoder uin - снять модератора с должности. Пример: delmoder 123456789
• setrekl text - изменить рекламу. Пример: setrekl Сегодня в 6 вечера сходка на фонтане
• reklon - включить рекламу. Пример reklon
• rekloff - выключить рекламу. Пример rekloff

Админство и модераторство

• Модератор имеет право кикать и банить, при этом не имеет значения, находится он в чате или нет.
• Админ имеет право кикать, банить и использовать админские команды.

Модераторские команды

• забанить: !бан срок;ник;причина или !бб сток ID причина
• разбанить: !бан 0;ник;причина или !бб 0 ID причина
• кикнуть: !кик ник;причина или !кк ID причина

Переход с более ранних версий, обновление ие [наверх]

Более поздние версии бота совместимы с ранними, а это означает что они могут импортировать их настройки. Поэтому для обновления бота вам необходимо:

1. Скачать новую версию с www.i-chats.net
2. Распаковать полученный архив в любую папку
3. Заменить старый exe файл бота на новый
4. Запустить бот

О переходе с версии 1.0 на 1.1:

1. Отпадают проблемы с кодировкой
2. Не нужно таскать с ботом кучу файлов
3. Упрощение и оптимизация

При обновлении с версии 1.0 до 1.1 бот автоматически сконвертирует все настройки, удаляя старые файлы. Рекомендуется перезапустить бот после обновления.

О переходе с версии 1.1 на 1.2 и выше:

Просто замените exe-файл бота. Программа при первом же запуске сама произведет все необходимые изменения

FAQ[наверх]

Q: При запуске программы вылетает ошибка инициализации. Пишет что-то про .NET Framework и 0xc0000135
A: У Вас отсутствует (или старая версия).NET Framework. Для работы программы необходим .NET Framework 3.5 и выше. Скачать его можно тут.

Q: При запуске программа выдаёт ошибку, пишет что-то про ADODB.
A: У Вас отсутствуют библиотеки ADODB. Для решения проблемы скопируйте в папку с программой этот файл.

Q: Вы удалены из чата. Причина: 10 минут ничего не писали, Как сделать так чтоб не удалялось из чата когда не пишеш больше 10 минут???
A: Не рекомендую повышать, а уж тем более отключать этот параметр, т.е. это приведёт к зависанию чата (в чате должны быть только те кто пишут). но если вам так хочется отключить эту опцию, просто повысьте параметр "Выкид. после" на вкладке "Интерфейс чата" до 100..200 или более минут.

Q: Как сделать чтобы те сообщения которые ты отправил не показывались в чате?
A: Свои сообщения должны показываться в чате, иначе сидеть в нём будет некомфортно. Тем более в противном случае не будет видно куда попало сообщение и как обработалось фильтром. У многих возникает такой вопрос в начале использования программы, т.к. на этот момент число пользователей в чате очень мало. Когда пользователей много то всё сливается в один поток и всё понятно. Если вы всё-таки решили отключить эту функцию, перейдите на вкладку "Интерфейс чата" и включите "Не прис. свои сообщ.".

Q: Как и где можно приобрести регистрационный ключ?
A: Вся информация по этому вопросу доступна на нашем сайте: www.i-chats.net.

Q: Почему у меня чат виснет, сообщения не доходят, хотя в чате совсем мало человек?
A: Вы неверно настроили таймауты. Очень осторожно меняйте эти настройки. Поставьте по умолчанию (таймаут чата: 10с. таймаут отправки: 1500мс). В дальнейшем можете аккуратно снижать таймаут отправки, по мере роста популярности бота.

Системные требования [наверх]

• ОС: Windows 2000 Service Pack 3; Windows 98; Windows 98 Second Edition; Windows ME; Windows Server 2003; Windows XP Service Pack 2; Windows Vista; Windows 7
• Предустановленное ПО: .NET Framework 3.5 или выше
• Место на жёстком диске: 100 Mb
• Скорость соединения: от 56 kbit/s и выше

Полезные советы [наверх]

1. Выключайте авторизацию у ботов! (в QIP это: настройки->общие->авторизация)
2. Не делайте слишком низкий таймаут отправки. Снижайте его осторожно, по мере роста популярности бота. Если заметите что не все сообщения доходят, повышайте его.
3. Не делайте слишком много модераторов, ставьте только проверенных людей.
4. Не делайте слишком большой словарь мата для чата, т.к. это может привести к зависанию чата. Достаточно занести туда 10-20 корней ругательных слов.
5. Делайте как можно более короткие и запоминаемые команды.
6. Если хотите чтобы ваш чат зарекомендовал себя с хорошей стороны, установите хороших модераторов, сформируйте правила, следите за порядком.
7. Старайтесь чтобы ваш чат как можно больше времени находился в онлайн, иначе пользователи будут убывать.
8. Для автозапуска бота, запускайте его с параметром start, например "c:\bot\chat.exe" start. В таком случае он сам зайдет в сеть и спрячется в трей.
9. Со временем база данных разрастается. Для сжатия откройте ее в Access, сервис->служебные программы->сжать и восстановить базу данных.
10. Если статус бота "не в сети" но он работает, то зайдите с его UINа (через QIP например). Установите статус "в сети", затем "не в сети". После этого закройте QIP и запустите бот.

Об ошибках сообщать на .
Спасибо за проявленный интерес, желаю успехов. Разработчик CBK icq чат бота.