Tele Multiverse

Описание

Представляем вашему вниманию инновационного юзербота под названием "Tele Multiverse". Слово "Multiverse" несет в себе обещание обширных возможностей бота, способного справляться с практически любыми задачами. Важной особенностью является встроенная функция DLCs, позволяющая пользователям добавлять собственные функциональности в бота.

Более того, "Tele Multiverse" обладает несколькими встроенными функциями, такими как Neuro, Chat, ImageText, расширяя его способности в обработке текстов, взаимодействии с пользователем и анализе изображений. Эти функции призваны сделать опыт использования бота более разнообразным и адаптированным под различные потребности.

Мы уверены, что "Tele Multiverse" станет надежным помощником в выполнении разнообразных задач, обеспечивая пользователей уникальным и удобным опытом взаимодействия.

Авторизация

Для авторизации своего аккаунта необходимо выполнить несколько шагов. В первую очередь, откройте файл settings.ini и найдите раздел [Account]. Затем введите свои учетные данные, такие как номер телефона, api_id и api_hash. Номер телефона можно найти в настройках вашего аккаунта в Telegram. Чтобы получить api_id и api_hash, необходимо авторизоваться на сайте https://my.telegram.org/auth. После авторизации создайте приложение и скопируйте соответствующие значения api_id и api_hash, затем добавьте их в файл settings.ini. Наконец, запустите основной файл main.py.

Встроенные функции

Chat

LS

1. save_chat

Команда !save_chat предназначена для сохранения текущего чата, в котором была отправлена данная команда. Этот функционал позволяет вам архивировать важные беседы или фиксировать интересные обсуждения.

Для взаимодействия с функциональностью чата, воспользуйтесь командой !chat. После вызова этой команды вы можете использовать различные функции, предоставляемые чатом.

2. load_chat

Команда !load_chat предназначена для загрузки архива с данными о чате. Также существует возможность использовать расширенную версию команды с указанием конкретного идентификатора чата: !load_chat {chat_id}. Эта версия вызывается по айди чата, что обеспечивает точное определение конкретного чата для загрузки.

Для взаимодействия с функциональностью чата, воспользуйтесь командой !chat. После вызова этой команды вы можете использовать различные функции, предоставляемые чатом.

Group

1.ban

Команда !ban предоставляет возможность забанить пользователя в группе. Это эффективное средство управления безопасностью и порядком в чате, позволяя модераторам и администраторам принимать меры по исключению нежелательных участников.

2.chance_name

Команда !chance_name предоставляет вам возможность динамично изменять название группы. Просто используйте команду с указанием нового названия, например: !chance_name {новое_название}.

ImageText

1.Love

Команда !Love предоставляет вам возможность отправить одну из вариаций ASCII-артов, созданных специально для выражения чувства любви и теплоты. Просто воспользуйтесь этой командой, чтобы поделиться уникальным искусством, добавив при этом нотку эмоционального влечения к беседе.

Команда !ImageText, Love1:

Команда !ImageText, Love2:

Команда !ImageText, Love3:

2.Christmas

Команда !Christmas открывает перед вами магию праздничного настроения, позволяя отправить одну из вариаций ASCII-артов, посвященных наступающему Новому году. Просто воспользуйтесь этой командой, чтобы поделиться уникальными и праздничными иллюстрациями, добавив дух новогоднего веселья в ваш чат.

Команда !ImageText, Christmas1:

Команда !ImageText, Christmas2:

Neuro

Google Bard

Авторизация

Для авторизации в Google Bard вам необходимо создать аккаунт на официальном сайте https://bard.google.com/chat. Затем переходите в файлы куки и ищите куки с именем "__Secure-1PSID". Копируйте значение этого куки (обязательно заканчивается точкой). Далее вставьте это значение в файл settings.ini в раздел [Neuro] под наименованием Bard_token.

Функции

1.Answer

Команда !neuro, bard, {text} представляет собой инструмент для отправки запроса на сервер Google Bard, после чего вы получаете ответ. Просто введите необходимый текст после команды, чтобы инициировать запрос и получить сгенерированный сервером ответ.

2.ask_about_image

Команда !neuro, bard, {text}, сопровождаемая изображением, позволяет отправить текстовый запрос на сервер Google Bard, а также прикрепить к нему изображение. Просто введите необходимый текст после команды и добавьте изображение, чтобы получить сгенерированный ответ от сервера.

Другое

1.id

Команда !id предоставляет две варианты использования. Первый вариант включает в себя ответ на сообщение пользователя, например:

!id + reply_to_message - отображает идентификатор пользователя, на чье сообщение мы ответили.

Второй вариант просто:

!id - отображает ваш собственный идентификатор.

2. exec

Команда !exec {code} выполняет ваш фрагмент кода непосредственно в чате. Например, с помощью следующего скрипта:

!exec for i in range(0, 10): client.send_message(message.chat.id, "Тест")

Этот код отправляет в текущий чат 10 сообщений с текстом "Тест". Убедитесь, что код соответствует вашим потребностям, иначе результат может быть неожиданным.

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

3. send_contact

Команда для отправки контакта пользователя имеет две вариации:

1. Рандомная генерация контакта:!send_contact random - создает фейковый контакт.
2. Ответ на конкретное сообщение:!send_contact you + reply_to_message - отправляет контакт пользователя, на чье сообщение мы ответили.

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

4. profile

Команда !profile отправляет в чат ваш профиль. Это удобный способ поделиться основной информацией о себе с участниками чата.

DLCs

Описание

DLC, или Загрузочные контенты, представляют собой универсальный метод для расширения функционала. Каждый пользователь нашего бота может легко добавлять свои собственные функции, делая бота более увлекательным и подстраиваемым под свои уникальные потребности. Этот гибкий подход позволяет создавать персональные функции и адаптировать бота к различным задачам, что делает его более мощным и универсальным инструментом для всех пользователей. Исследуйте возможности DLC, чтобы привнести свой вклад в функционал бота и сделать его ещё более интересным и полезным.

Встроенные DLC

1.Download

Команда !download (отправленная в ответ на сообщение, которое вы хотите скачать) автоматически загружает файл в корневую папку .\DLCs\Download\downloads\*.

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

2.TikTokAPI

Команда !get_profile {username} отображает профиль пользователя в ТикТок. Это полезный инструмент для получения информации о других участниках, и может включать в себя данные, такие как никнейм, количество подписчиков, опубликованные видео и другие характеристики аккаунта.

Чтобы получить ключ нужно оформить бесплатную подписку на сайте https://rapidapi.com/datauniverse/api/tiktok82/pricing

После заходим на главную страницу https://rapidapi.com/datauniverse/api/tiktok82

после ищем X-RapidAPI-Key и копируем значение после пишем в settings.ini в пункт TikTokAPI

Добавить DLC

Чтобы добавить DLC нужно добавить папку с содержимым DLC по пути .\DLCs\{Your folder DLC}, Пример:

Пример содержимого(DLC Download):

Основной файл называется setup.py и должен находиться сразу после открытия вашего DLC. В моем случае, после открытия папки Download следует расположить файл setup.py

Инструкция создания своих DLC

1.Создания структуры DLC

В директории DLCs создайте новую папку с названием вашего DLC. Затем, открыв папку с вашим DLC, создайте основной файл setup.py и добавьте следующий код в качестве Главного элемента:

def init(client, message):
	command = message.text.split(" ")[0]
	if command == "!test":
	   pass
	   

2.Добавление команд в DLC

Чтобы добавить команды, существует два подхода: можно поместить их в один файл или использовать дополнительные файлы.

Первый пример представляет собой один файл, содержащий функции команд:

def test_func(client, message):
	client.send_message(message.chat.id, "its test func")
def init(client, message):
	command = message.text.split(" ")[0]
	if command == "!test":
		test_func(client, message)

Второй пример включает создание дополнительного файла, например, commands.py:

#Commands.py
def test_func(client, message):
	client.send_message(message.chat.id, "its test func"

Затем импортируем команды в основной файл setup.py и добавляем в функцию init:

from .commands import *

def init(client, message):
	command = message.text.split(" ")[0]
	if command == "!test":
		test_func(client, message)

Оба примера ожидают команду !test и, при ее получении, отправляют текст "its test func". Выбор между одним файлом и разделением на дополнительные файлы зависит от вашей организации и предпочтений в разработке.

3.Добавление файлов\папок

Чтобы добавить дополнительные файлы, создайте файл рядом с setup.py и затем импортируйте его в setup.py следующим образом:

# Ваш setup.py
from .your_file import *

Либо вы можете создать папку и добавить туда, например, файл commands.py, а затем импортировать его в setup.py:

# Ваш setup.py
from .your_folder.commands import *

Для управления папками и файлами внутри вашего DLC вы можете воспользоваться библиотекой os:

os.path.dirname(__file__)

С помощью этой команды и получаем текущую директорию после чего можем обращаться к папка которые находятся в вашем DLC

import os
your_dir = f"{os.path.dirname(__file__)}/downloads"

Здесь я привел пример с папкой "downloads", но вы можете указать любую другую папку, которую вы создали в рамках вашего DLC. Это помогает вам организовывать файлы и структуру проекта в более систематичной форме.

4.Введение settings.ini

Напишем простой код после я расскажу что он делает:

import configparser
import os
current_directory = os.getcwd()
config = configparser.ConfigParser()
config.read(fr'{current_directory}\settings.ini')
key = config['DLCs']

тут мы получаем директорию где находится main.py после проводим путь к settings.ini и получаем данные про пункт DLCs дальше мы можем получить данные через

key["your data"]

так же есть у вас формат данных в dict то можно использовать json для форматирования

import configparser
import json
import os
current_directory = os.getcwd()
config = configparser.ConfigParser()
config.read(fr'{current_directory}\settings.ini')
key = config['DLC']
dict_format = json.loads(key["your data"])

и так мы можем обращаться к данным через .get() либо же через dict_format["key"]