Главная страница

БОт. бот. УУстройство бота


Скачать 239.19 Kb.
НазваниеУУстройство бота
Дата05.01.2021
Размер239.19 Kb.
Формат файлаdocx
Имя файлабот.docx
ТипДокументы
#165968

УУстройство бота

Для настройки бота используется несколько элементов.

  1. Система режимов — один режим может быть либо включенным (True), либо выключенным (False). Например, если вы хотите, чтобы бот кикал за пригласительные ссылки на какую-либо беседу, следует включить режим kick_for_invite_link. Используйте для этого команду /mode.

  2. Система лимитов — какой-либо параметр может иметь числовое значение. Например, вы сами можете настраивать максимальное количество варнов или максимальную допустимую длину сообщения у пользователей. Лимиты устанавливаются командой /setlimit.

  3. Система нарушений и наказаний за них. Команда: /setpenalty.

ООписание всех режимов

  • kick_invite — запрещает приглашения в текущую беседу. При попытке пользователя с рангом Default пригласить кого-либо, бот кикает и пригласившего, и приглашенного.

  • block_title — запрещает изменять текущее название беседы. В противном случае пользователю с рангом ниже Normal выдается варн.

  • kick_leave — кикает вышедшего пользователя с рангом Default.

  • block_voting — запрещает запуск голосований за чей-либо кик.

  • block_anonym — запрещает отправку анонимных сообщений в беседу.

  • allow_lottery — разрешает лотерею в беседе (мини-игру, победа в которой дает пользователю ранг Normal, а проигрыш — бан).

  • chat_protection — включает «безопасный режим» беседы. Подробнее о режиме можно прочитать в этой статье: vk.com/@controlbot-posobie-po-zaschite-besedy.

  • kick_for_invite_link — кикает пользователя с рангом Default, если тот отправил инвайт-ссылку на какую-либо беседу.

  • kick_for_group_link — кикает пользователя с рангом Default, если тот отправил ссылку на какую-либо группу, которой нет в списке разрешенных.

  • block_audio_msg — наказывает за отправку аудиосообщения.

  • block_caps — наказывает за капс.

  • kick_menu — выводит специальную клавиатуру при выходе какого-либо пользователя с рангом Default из беседы. Не выводит, если режим kick_leave = True.

  • block_polls — наказывает за отправку опроса.

  • allow_games — фактически, разрешает или запрещает использование команд, запускающих какие-либо игры.

  • kick_info — выводит справочную информацию при выходе Default-пользователя. Не выводит, если режимы kick_menu и/или kick_leave равны True.

  • blocked_com_info — выводит справочную информацию при использовании заблокированной команды.

  • public_chat — делает чат публичным.

  • penalty_for_invite_banned — применяет наказание к человеку, пригласившего заблокированного пользователя.

  • news — присылает в беседу новости бота.

  • kick_unknown — кикает пользователей, чей возраст скрыт (если значение лимита min_age не равно 0).

  • block_stories — наказывает на отправку истории.

  • block_reposts — наказывает за репост в беседу (если была отправлена запись разрешенной группы, то не наказывает).

  • block_rp — запрещает использование РП-команд.

  • auto_unban — автоматический разбан заблокированного пользователя, если он был приглашен руководителем беседы.

  • block_comments — наказывает за репост комментария в беседу (если был отправлен коммент под постом разрешенной группы, то не наказывает).

ООписание всех лимитов

  • warns_count — максимальное количество варнов (по умолчанию — 3).

  • msg_max_length — максимальная допустимая длина сообщения. При превышении данного лимита к пользователю с рангом Default применяется наказание. По умолчанию, данный лимит = 0, то есть ограничений нет.

  • anonym_msg_interval — допустимый интервал между анонимными сообщениями в беседу. По умолчанию — 60, то есть 60 секунд.

  • min_age — минимальный допустимый возраст участников. Если новый участник младше указанного возраста, то его кикает. По умолчанию, данный режим = 0, то есть ограничений нет.

ООписание всех нарушений и наказаний

  • msg_max_length_limit — превышение допустимой длины сообщения.

  • spam_word — отправка сообщения, в котором есть слова из спам-листа.

  • caps — капс. Обратите внимание, бот применяет наказание, только если включен режим block_caps.

  • audio_msg — отправка аудиосообщения. Обратите внимание, бот применяет наказание, только если включен режим block_audio_msg.

  • poll — отправка опроса. Обратите внимание, бот применяет наказание, только если включен режим block_polls.

  • sticker — отправка заблокированного набора стикеров.

  • invite_banned — приглашение пользователя, состоящего в ЧС.

  • story — отправка истории. Обратите внимание, бот применяет наказание, только если включен режим block_stories.

  • repost — репост в беседу. Обратите внимание, бот применяет наказание, только если включен режим block_reposts.

  • mute — отправка сообщения, находясь при этом в муте.

  • comment — репост комментария в беседу. Обратите внимание, бот применяет наказание, только если включен режим block_comments.

За каждое нарушение может применяться один из трёх видов наказания:

  • kick — кикает пользователя за определенное нарушение.

  • warn — дает варн пользователю за определенное нарушение.

  • ban — отправляет в Черный Список беседы пользователя за определенное нарушение.

Например, если нам нужно, чтобы бот не кикал, а давал варн за слово из спам-листа, наказание за данное нарушение «spam_word» должно быть равным «warn».

ННачало работы

/reg — регистрирует беседу в системе у бота или обновляет её статус.

/chat — выводит информацию о беседе (в том числе, и её ID).

/info  — выводит информацию о пользователе.

/warninfo  — выводит подробную информацию о варнах пользователя.

ИИнформативные функции

/приветствие <текст> — устанавливает приветствие беседе. Если не указан текст, просто выводит его.

/правила <текст> — так же, как и с приветствием.

убрать приветствие — убирает приветствие, соответственно.

убрать правила — убирает правила, соответственно.

/link <инвайт-ссылка> — устанавливает пригласительную ссылку беседе. Если не указана инвайт-ссылка, просто выводит её.

/invite  — высылает приглашение в беседу указанному пользователю.

Н

Настройка беседы

/modes — выводит значения всех режимов.

/mode <имя режима> <имя режима> <имя режима> … <имя режима>— включает (True) или выключает (False) каждый указанный режим. Например, если мы хотим, чтобы бот наказывал за отправку аудиосообщений, следует написать: /mode block_audio_msg.

/limits — выводит значения всех лимитов.

/setlimit <имя лимита> <значение лимита> — устанавливает определенное значение указанному лимиту. Например, если мы хотим, чтобы максимальное количество варнов было равно 5, нужно написать /setlimit warns_count 5.

/penalty — выводит список всех нарушений и наказаний за них.

/setpenalty <нарушение> <наказание> — устанавливает определенное наказание за указанное нарушение. Например, если мы хотим, чтобы бот не варнил, а кикал за капс, следует написать /setpenalty caps kick.

М

Манипуляции с пользователями

/kick  (или пересланными сообщениями)— кикает указанных пользователей.

/warn  <причина> — даёт варн пользователю. Если у пользователя накопилось максимальное кол-во варнов, бот его кикает. Если причина варна не указывается, бот даёт варн по стандартной причине: «Unknown».

/mute <пересланное сообщение> <время> — даёт мут пользователю. В таком состоянии бот будет давать варн пользователю за каждое его сообщение.

/unban  — выносит пользователя из ЧС беседы. Также, для вынесения пользователя из ЧС достаточно просто пригласить его обратно. Чтобы полностью очистить ЧС, можно написать /unban *.

/unwarn  — удаляет все варны у пользователя.

/unmute <пересланное сообщение> — снимает мут у пользователя. Если написать /unmute *, то бот снимает мут со всех.

ММанипуляции с рангами

У бота есть два встроенных ранга — Helper и Normal. Также, бот учитывает и администраторов, назначаются они как обычно — создателем через меню беседы.

То есть, иерархия у бота следующая:

  • Создатель беседы.

  • Администратор беседы.

  • Normal-пользователь.

  • Helper.

  • Default-пользователь, то есть пользователь без ранга.

Функции Helper-пользователя вспомогательные, на пользователей с данным рангом не действуют ограничения (например, блокировка капса на них не работает), также им доступны команды «/зов», «убрать кнопки» и т.д.

У Normal-пользователей возможностей больше. Например, у них есть возможность кикать и заносить в ЧС людей.

Однако, у администраторов, все-таки, возможностей больше, к примеру:

  • Только администраторы имеют право управлять Игнор-Листом.

  • Только администраторы имеют право забирать у Normal-пользователей их ранги.

  • Только администраторы имеют право назначать Normal-пользователей.

  • Только администраторы имеют право давать варны Normal-пользователям.

  • Только администраторы имеют право управлять лимитами.

  • Только администраторы имеют право взаимодействовать со списком заблокированных команд.

ККоманды

/helper  — дает ранг Helper пользователю.

/helpers — выводит список всех Helper-пользователей.

/normal  — дает ранг Normal пользователю.

/normals — выводит список всех Normal-пользователей.

/admins — выводит список всех администраторов беседы.

/heads — выводит список всех руководителей беседы.

/default  — лишает ранга пользователя.
Р


Работа со спам-листом

Спам-лист уже упоминался ранее. Это специальный список слов, которые нельзя использовать в своих сообщениях, иначе последует наказание в виде кика/бана/варна. Например, если в спам-листе есть слово «инфа», бот будет кикать пользователей за любое сообщение с данным словом.



Давайте перейдем к самим командам:

/spamwords — выводит весь спам-лист.

/addword <сообщение> — заносит в спам-лист сообщение.

/delword <сообщение> — выносит из спам-листа сообщение. Если написать /delword *, то бот очищает спам-лист полностью.

Зачастую, вы будете сталкиваться с кое-какой проблемой. Дело в том, что в спам-листе обычно хранятся не слова, так таковые, а просто последовательности символов, находя которые в определенном сообщении, бот применяет наказание. К примеру, у нас есть слово «инфа» в спам-листе, но при этом бот будет кикать еще и за слова вроде «инфаркт», т.к. в нем есть подстрока «инфа» (выделил жирным).



Однако, от этой проблемы есть решение. Если мы хотим, чтобы бот кикал ИМЕННО ЗА СЛОВО, то нам стоит это вводимое слово обвести символами ^$.



Бот кикнул только за второе сообщение, а за первое — нет.

Манипуляции со стикерами

/sticker <пересланное сообщение> — возвращает ID набора данного стикера.

/bansticker  — блокирует указанный набор стикеров. Пользователь, который отправит данный набор, получит наказание. Если указать число 0, то бот будет применять наказание за любой стикер.

/bannedstickers — возвращает список всех заблокированных наборов стикеров по их ID.

/unbansticker  — разблокирует указанный набор стикеров.

ССписок разрешенных групп

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

ККоманды

/allowgroup <ссылка на группу> — добавляет группу в список разрешенных.

/allowedgroups — выводит список всех разрешенных групп.

/disallowgroup <ссылка на группу> — удаляет группу из списка разрешенных.

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

ВВывод каких-либо списков пользователей

blacklist / — выводит Черный Список беседы.

/warnlist — выводит список пользователей с варнами.

/ignorelist — выводит Игнор-Лист.

/banned — выводит список заблокированных пользователей ВК.

ББлокировка команд для пользователей

/blockcom <команда> — блокирует использование команды для пользователей. Если написать /blockcom *, то бот заблокирует все существующие команды бота.

/blockedcom — выводит список всех заблокированных команд.

/unblockcom <команда> — выносит данную команду из списка заблокированных. Если написать /unblockcom *, то бот полностью очистит данный список.

ППриватные группы

Приватная группа — группа, которую можно «привязать» к вашей беседе. И если в беседу будут заходить люди, не состоящие в данном сообществе, бот будет их кикать (если их ранг ниже Normal).

/private set <ссылка на группу> — устанавливает приватную группу.

/private unset — отвязывает приватную группу от беседы.

/private check — проверяет всех участников беседы на присутствие в приватной группе (и кикает, если они в ней не состоят, и их ранг ниже Normal).

/private — выводит ссылку на приватную группу.

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

РРассылка

Беседы могут подписываться на рассылку от каких-либо групп. И группы могут рассылать новости в подписанные на них беседы.

/sub <ссылка на группу> — подписывает беседу на указанную группу.

/unsub <ссылка на группу> — отписывает беседу от указанной группы.

/subs — выводит все подписки беседы.

/mail <ссылка на пост> — начинает рассылку в беседы, подписанные на сообщество, в котором опубликована указанная запись (команду нужно писать в ЛС).

Есть некоторые нюансы:

  • Одна беседа не может быть подписана более, чем на 5 групп.

  • Для того, чтобы начать рассылку от определенной группы, нужно быть её администратором. Бот распознает в вас администратора, если вы есть в контактах данного сообщества.

  • Нельзя начать рассылку от частной группы.



Иммунитеты

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

/imuns — выводит список пользователей с иммунитетом.

/imun add  — дает иммунитет указанному пользователю (команда для администраторов).

/imun del  — отбирает иммунитет у пользователя (команда для администраторов).

Ограничение действует только на Normal-пользователей. Администраторам можно будет воздействовать и на пользователей с иммунитетом.

ЛЛимиты-интервалы

Лимиты-интервалы — настройка, позволяющая регулировать частоту использования каких-либо команд. Например, сделать так, чтобы команду «ножки» можно было использовать только раз в 30 секунд.

/intervals — выводит список команд с установленным лимитом-интервалом.

/interval set <команда> <время (сек/мин/час/дн)> — устанавливает лимит-интервал на указанную команду (команда для администраторов).

/interval unset <команда> — удаляет лимит (команда для администраторов).

В качестве числового значения невозможно указать число больше 120. То есть, если время указывается в секундах, то не более 120 секунд. В минутах — не более 120 минут. В часах — не более 120 часов. В днях — не более 120 дней.

Ограничение действует только на Normal-пользователей и ниже. Администраторы смогут использовать команды как обычно.

ВВспомогательные команды

/id <упоминание/пересланное сообщение> — возвращает ID указанного пользователя.

/зов — упоминает всех пользователей беседы.

онлайн — выводит список пользователей в онлайн.

/kickbanned — кикает всех заблокированных пользователей ВК.

/kicknews <время> — кикает всех пользователей, зашедших в беседу за указанное время.

/самокик — кикает пользователя.

/самобан — блокирует пользователя.

убрать кнопки — убирает клавиатуру, если она есть.

/kickjun — проверяет всех участников беседы на соответствие минимальному возрасту. Если какой-то участник не соответствует — его кикает.

ККоманды в ЛС

/anon  <сообщение> — отправляет анонимное сообщение в беседу, если выключен режим block_anonym.

/join  — возвращает информацию о беседе и установленную в ней ссылку, если включен режим public_chat.

ППрофили

У каждого пользователя Admin Bot есть свой профиль, в котором можно просмотреть некоторую информацию (/profile в ЛС бота).



Команда /profile.

Также, можно устанавливать некоторые настройки приватности. К примеру, можно сделать так, чтобы бот вас больше не упоминал в беседах. Используем для этого команду /privacy.



ДДоступные настройки приватности

  • Вызовы в КНБ — настройка, от которой зависит, смогут ли другие пользователи бросать вам вызов в игре «Камень, Ножницы, Бумага».

  • Высылание приглашений в беседы — смогут ли другие пользователи высылать вам приглашения в беседы.

  • Упоминания ботом — будет ли бот упоминать вас в беседах.

  • Приглашения пользователями в беседы — смогут ли другие пользователи приглашать вас в беседу в ботом.

  • РП-действия — смогут ли другие пользователи использовать на вас РП-команды.

ППрочее

ГГолосования за кик

/votekick  — запускает голосование за кик указанного пользователя, если выключен режим block_voting.

/endvoting  — останавливает голосование за кик данного пользователя.

ЛЛотерея

/lottery — запускает лотерею на ранг Normal, если включен режим allow_lottery.

/endlottery — останавливает лотерею.

ББраки

браки — выводит список всех браков в беседе.

брак  — подает заявку на бракосочетание с указанным человеком.

развод — разводит.

расторгнуть  — расторгает брак человека (только для создателя беседы).

ННики

/ник <ник> — устанавливает ник текущему пользователю или указанному пересланным сообщением.

/ники — выводит список всех ников беседы.

/ник <+/-> — разрешает или запрещает менять текущему пользователю ник.

убрать ник — убирает ник.

ААрифметическая игра

матстарт — начинает арифметическую игру.

матстоп — останавливает арифметическую игру.

матпример — выводит текущий пример.

матстат — выводит статистику по решениям примеров данной беседы.

матрейтинг — выводит рейтинг беседы.

ККрестики-нолики

кнстарт — запускает игру.

кнвойти — входит в игру.

ММафия

мафстарт <кол-во участников> — начинает игру.

мафвойти — входит в игру.

мафинфо — выводит информацию о текущей игре.

мафголоса — выводит список голосований за чей-либо арест в текущей игре.

мафстоп — останавливает игру.

ККамень-Ножницы-Бумага

кнбвызов  — отправляет вызов указанному человеку в игре.

ДДругое

дошик — засекает время на заваривание доширака.

/me, /try, поцеловать, обнять, пожать руку, уебать, отсосать, отлизать, секс, обоссать, шлёпнуть, кастрировать, кусь, ущипнуть, погладить — РП-команды.

бутылочка — бутылочка.

бот надо <текст> — пишет, надо ли.

бот кто <текст> — пишет, кто.

выбери <текст> — выбирает между вещами, разделенных «или».

список <название> — отбирает случайных участников беседы.

ННа ночь

ножки.

ИИнформация о боте

Пишем /botinfo.

Разработчик бота — vk.com/ogaier.

Официальная беседа проекта — vk.me/join/AJQ1d3NdJws51pYb4OasFOBA.


написать администратору сайта