Привет, Хабр! Хочу вам рассказать о своём исследовательском проекте, в котором я создал игрового ботеца для ВКонтакте.
Ахтунг!
Я не являюсь профессиональным разработчиком, я обычный девятиклассник, любящий иногда покодить на совершенно разных языках. Здесь я просто рассказываю о своём проекте и опыте участия в конкурсе проектных работ.
Эта статья не является пошаговым руководством по созданию бота для ВКонтакте - их достаточно и на Хабре, и за его пределами.
Что за проект?
Я, как администратор немаленькой беседы во ВКонтакте (на тот момент это было ~670 человек), столкнулся с проблемой ужасной активности. Ну серьёзно, человек много, а не пишет никто, очень много незаинтересованных молчунов, которые лишь цифру создают для беседы. Подавляющее большинство пользователей из тех 670 человек просто входили и не появлялись в списке сообщений ни разу.
Чтобы решить эту проблему, я решил попробовать написать своего бота с некоторыми игровыми механиками. Сразу хочу оговориться, что пусть и код писал я сам, мне два раза проводил код ревью мой замечательный приятель, поэтому, пусть сам проект, сама задумка довольно простая, - это не помешало мне набраться опыта от более продвинутого в кодинге человека.
С ботом и своей темой я отправился прямиком на конкурс "Большие вызовы", съездил в лагерь, где с экспертами (а с одним из них мы общаемся до сих пор) я допиливал презентацию, чутка сменил цель, всё подкорректировал, успешно защитился. Сейчас меня ждёт только последний тур заключительного этапа, но это уже совсем другая история.
Что же за системы есть в боте?
В общем и целом, по сути я вдохновлялся другим ботом, в которого любил играть продолжительное время (и закончил только потому, что они его отрубили и делают сейчас игру в приложении ВК).
У меня бот намного проще, но подошёл для проекта в школе и для проекта в конкурсе. Основными характеристиками пользователя являются игровая валюта и опыт. Фактически, всё сводится к фарму опыта и денег ради фарма опыта и денег. За опыт можно устроиться на работу, каждая последующая работа будет давать всё больше денег в 24 часа (без фарма, получение зарплаты только командой раз в сутки), в свою очередь за деньги можно купить машину получше, которая будет давать больший множитель к опыту. Опыт даётся за каждое сообщение кроме команд посимвольно, затем умножается на множитель от автомобиля. Это самое основное, чего я стал требовать от бота. Также есть выдача предупреждений (максимальное их количество - 4).
Да, такого бота я делал около 6 месяцев, постоянно что-то изменяя, добавляя и удаляя.
Давай о реализации уже!
Делал я бота на языке программирования Python с использованием асинхронной библиотеки для написания ботов vkbottle. Работает на CallBack API, в качестве сервера использую aiohttp.
Во входном файле bot.py происходит инициализация сервера, прописаны все роуты (их всего 4 и они очень маленькие), к основному боту добавляются blueprint'ы, о которых пойдёт речь позже.
import pathlib import aiohttp import aiohttp_jinja2 import jinja2 from aiohttp import web import utils.consts from config import SECRET, WEBHOOK_ACCEPT, CONFIRMATION_TOKEN from routes import actions, admin_realize, global_admin_realize, users_realize, economic_realize from utils.db_methods import init_database from middlewares import ExpMiddleware # dead import for include middleware INDEX_DIR = str(pathlib.Path(__file__).resolve().parent) + '/index_page' utils.consts.BOT.loop.run_until_complete(init_database()) utils.consts.BOT.set_blueprints( actions.bp, admin_realize.bp, global_admin_realize.bp, users_realize.bp, economic_realize.bp ) APP = aiohttp.web.Application() ROUTES = aiohttp.web.RouteTableDef() if not WEBHOOK_ACCEPT: aiohttp_jinja2.setup(APP, loader=jinja2.FileSystemLoader(str(INDEX_DIR))) APP.router.add_static('/static/', path=str('./index_page/'), name='static') @ROUTES.get("/") @aiohttp_jinja2.template('index.html') async def hello(request): """Root site response""" return {} @ROUTES.get("/when_update") @aiohttp_jinja2.template('whenupdate.html') async def whenupdate(request): """When update site response""" return {}
Все конфиги хранятся в config.py, точнее, там инициализируются константы. Сами значения хранятся в файле .env и с помощью библиотеки dotenv берутся из виртуального окружения по ключу.
import os from dotenv import load_dotenv dotenv_path = os.path.join(os.path.dirname(__file__), '.env') if os.path.exists(dotenv_path): load_dotenv(dotenv_path) # Loading token from .env ACCESS_TOKEN = os.getenv("ACCESS_TOKEN") SECRET = os.getenv("SECRET") USER_ACCESS_TOKEN = os.getenv("USER_ACCESS_TOKEN") WEBHOOK_ACCEPT = bool(int(os.getenv("WEBHOOK_ACCEPT", 0))) CONFIRMATION_TOKEN = os.getenv("CONFIRMATION_TOKEN") NEW_START = bool(int(os.getenv("NEW_START", 0))) ADMINS_IN_CONV = list(map(int, os.getenv("ADMINS_IN_CONV").split(',')))
Теперь о том, где хранятся все обработчики команд.
Я их разделил логически на 5 видов: обработчик событий (пользователь вошел в беседу), обработчик сообщений для всех (например, команда /profile), для администраторов беседы (например, /пред чтобы выдать предупреждение пользователю), для администраторов и модераторов бота (например, /бд добавить, чтобы добавить, как ни странно, новый экземпляр какой-то модельки, например, создать новую машину, не взаимодействуя напрямую с БД), и реализация системы экономики (купить или продать машину, поступить на работу и пр.).
Всё это хранится в пяти разных файлах в папке routes:
Вот пример команды покупки машины:
@bp.on.message_handler(AccessForAllRule(), Registered(), text="/купить_машину <c_id>") async def buy_car(message: Message, user: User, c_id: str = None): if c_id.isdigit(): c_id = int(c_id) car = await Car.get(id=c_id) buy_car_user_status = status_on_buy_car(user, car) if buy_car_user_status == BuyCarUserStatuses.APPROVED: chat = await Conversation.get(peer_id=message.peer_id) await User.get(user_id=message.from_id, chat=chat).update( coins=user.coins - car.cost, car=car ) await message(f"Машина {car} куплена!") elif buy_car_user_status == BuyCarUserStatuses.NOT_ENOUGH_MONEY: await message("У тебя недостаточно денег!") elif buy_car_user_status == BuyCarUserStatuses.NOT_ENOUGH_EXP: await message("У тебя недостаточно опыта!") else: await message("У тебя уже есть машина!") else: await message("Введите цифру-ID машины!")
Все обработчики в пределах одного файла объединяются blueprint'ом, а все "чертежи" подключаются к боту во входном файле.
В обработчиках команд используются различные служебные функции, например, в команде выше есть функция status_on_buy_car, которая говорит, можно ли пользователю купить машину, а если нельзя, то причину этого.
Все подобные функции хранятся в отдельно в папке utils в файле main.py. В этой же папке лежат файлы с константами, функциями для работы с БД, правила и ошибки, которые функции могут raise'ить иногда.
def status_on_buy_car(user: User, car: Car) -> BuyCarUserStatuses: if user.coins >= car.cost and user.exp >= car.exp_need and user.car is None: return BuyCarUserStatuses.APPROVED elif user.coins < car.cost: return BuyCarUserStatuses.NOT_ENOUGH_MONEY elif user.exp < car.exp_need: return BuyCarUserStatuses.NOT_ENOUGH_EXP else: return BuyCarUserStatuses.NOW_HAVE_CAR
В качестве ОРМки я использую Tortoise ORM, потому что асинхронно (а смысл в асинхронности фреймворка, если вся работа с БД синхронная?), потому что удобно лично для меня.
Что по итогу?
По итогу я имею бота, который некоторое время работал у меня в беседе, с помощью которого я показал небольшой прирост количества сообщений. В него иногда игрались, люди даже зарабатывали опыт общением и покупали себе имущество, но эффект, на самом деле, заметен не так сильно, так что это больше просто для развлечения, чем реально для поднятия активности с 0 до миллиона сообщений в секунду.
Конечно, в беседе, где бот был, наблюдалось больше сообщений, чем в беседе, где его не было, было больше активности (пусть и не сильно). Это я и записал в вывод.
В результате я получил небольшой научно-исследовательский проект, целью которого было исследовать возможность с помощью бота с игровой механикой повышения активности в беседах. Цель полностью выполнена, это частично возможно, но нужно пробовать различные подходы к решению поставленной проблемы.
Постскриптум
Я открыт к критике в комментариях, за неё отдельное спасибо, ведь именно критика, может даже очень жёсткая, может даже с заминусованной статьёй поможет развиваться мне как разработчику и создателю статей на Хабре.
