Skip to content

Bot for the social network VKontakte, which on command launches a vote with the exception of a certain user.

License

Notifications You must be signed in to change notification settings

N1ghtF1re/vk-voteban-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VOTEBAN BOT

Stars Total Downloads Latest Stable Version License

About the bot

The bot on command starts a vote to exclude a specific user.

Also, the bot keeps a list of excluded users, because of what an excluded user can not add to the conversation again, until the administrator unlocks it.

The bot has a built-in anti-flood system and there is a possibility to use the Captcha automatic.

Technical requirements

Python 3+ should be installed on your computer. If you did not, here's link

The following Python packages must be installed:

How to use

To start working with the bot, you need to configure the (config.py) and enter all the necessary data. If you choose to use an antikapchi, you must register at getcaptchasolution.com and get the key

After that, you need to run bot.py (the extension must be associated with Python).

Option 2: open the terminal, move through cd to the directory of this repository, and then enter

python bot.py

You can also edit the constants in const.py (the time of voting, the number of votes, etc.)

The bot commands

  • !voteban USER_ID - create a poll. The user ID is in his link after vk.com/. Voting takes 5 minutes. The conditions for exclusion: more than 5 participants in the conversation voted, more "placet" than "against";
  • !votehelp - Help with using the bot;
  • !banlist - View the blocked users in this conversation;
  • !uptime - bot's uptime
  • !unban USER_ID [ONLY FOR ADMINISTRATORS] to unlock the user.
  • !addinbanlist USER_ID [ONLY FOR ADMINISTRATORS] to force the user to add a banlist.
  • !setvotecount NUMBER [ONLY FOR ADMINISTRATORS] - sets the minimum number of people needed for voting (default: 5)
  • !setvotetime NUMBER_OF_MINUT [ONLY FOR ADMINISTRATORS] - sets the time required for voting (default: 2 minutes)

Developers

In the development of this bot involved:

RUS DESCRIPION:

О боте

Бот по команде запускает голосование за исключение определенного пользователя.

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

Бот имеет встроенную антифлуд систему и есть возможность использовать автоввод капчи.

Технические требования

На вашем компьютере должен быть установлен Python 3+. Если вы этого не сделали - вот ссылка

Должны быть установлены следующие пакеты Python

Руководство по использованию

Для начала работы с ботом необходимо настроить конфиг (config.py) и ввести все необходимые данные. Если выбрано использование антикапчи, необходимо зарегистрироваться на сайте getcaptchasolution.com и получить ключ

После этого нужно запустить bot.py (Расширение должно быть асоциированно с Python).

Вариант 2: открыть терминал, переместиться через cd в каталог этого репозитория, после чего в консоли ввести

python bot.py

Так же можно отредактировать вынесенные константы в const.py (время голосования, количество голосов и т.д.)

Команды бота

  • !voteban ID_ПОЛЬЗОВАТЕЛЯ - создать голосование. ID пользователя находится в его ссылке после vk.com/. Голосование длится 5 минут. Условия исключения: голосовало более 5 участников беседы, голосов "за" набрано больше, чем "против";
  • !votehelp - Помощь по использованию бота;
  • !banlist - Просмотреть заблокированных в этой беседе пользоваетелей;
  • !uptime - Время работы бота;
  • !unban ID_ПОЛЬЗОВАТЕЛЯ [ТОЛЬКО ДЛЯ АДМИНИСТРАТОРОВ БЕСЕДЫ] - разблокировать пользователя;
  • !addinbanlist ID_ПОЛЬЗОВАТЕЛЯ [ТОЛЬКО ДЛЯ АДМИНИСТРАТОРОВ БЕСЕДЫ] - принудительно добавить пользователя в бан-лист.
  • !setvotecount КОЛ_ВО [ТОЛЬКО ДЛЯ АДМИНИСТРАТОРОВ БЕСЕДЫ] - устанавливает минимальное количество человек, необходимое для голосования (по-умолчанию: 5)
  • !setvotetime КОЛ_ВО_МИНУТ [ТОЛЬКО ДЛЯ АДМИНИСТРАТОРОВ БЕСЕДЫ] - устанавливает время, необходимое для голосования (по-умолчанию: 2 минуты)

Разработчики

В разработке этого бота участвовали: