PIXEL - Документация

Pixel Utils Bot это Open Source проект который помогает автоматизировать и упростить модерацию в чате, защитить ваш чат от спамеров и многое другое! В этой документации вы сможете подробно ознакомится со всем что есть в боте.

Введение

Pixel Utils Bot — это Open Source проект, созданный для автоматизации и упрощения модерации в Telegram группах. Бот помогает защитить ваш чат от спамеров, управлять участниками, собирать статистику и многое другое.

Проект полностью открыт и доступен на GitHub. Каждый может внести свой вклад в развитие бота, предложить новые функции или исправить ошибки.

В этой документации вы найдете подробную информацию о том, как работает бот, какие команды доступны и как настроить его под свои нужды!

Первое знакомство и начало работы

В этом разделе вы найдете видео-инструкции для быстрого старта работы с ботом PIXEL.

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

Первым шагом для работы с ботом является команда /start. Эта команда запускает бота и показывает главное меню с доступными функциями.

Обязательно проверьте юзернейм бота! Оригинальный продукт: @Pixel_ut_bot

  • Мы отправляем команду /start боту в личных сообщениях
  • Получаем приветственное сообщение и главное меню
  • Теперь можно начинать работу с ботом!

Добавление бота в группу

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

Давайте добавим бота в группу! Разберем способ через кнопку прямо в боте.

  • Нажимаем на кнопку "➕ Добавить в чат" в приветственном сообщении
  • Появляется окно добавления бота в группу
  • Выбираем нужную группу, нажимаем на кнопку "Добавить в чат" и бот добавляется в группу
  • Теперь можно начинать работу с ботом в группе!

Важно: После добавления бота в группу не нужно прописывать миллион команд! Бот уже добавил ваш чат в базу данных и готов к работе. Только не забудьте выдать Пикселю права администратора.

Базовые команды

Статистика

  • стата — сводная статистика чата (если включено).
  • /mentionping — включить пинг в топе.
  • /unmentionping — отключить пинг в топе.

Алиасы:, топ.

Профиль

  • профиль — ваш профиль с графиком активности за месяц.
  • профиль @username — профиль другого пользователя.

Алиасы: мой профиль.

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

Помощь

  • /help — краткая справка по командам бота.

Правила чата

Команда /rules позволяет управлять правилами вашего чата. С её помощью администраторы и модераторы могут создавать, редактировать и удалять правила, которые бот будет автоматически отправлять по запросу пользователей.

Основные команды

  • /rules — показать сохраненные правила чата (доступно всем пользователям).

Как задать правила

Чтобы создать или обновить правила чата, отправьте сообщение в следующем формате:

Правила [Текст правил]

Пример:

Правила Запрещено спамить, оскорблять участников и публиковать рекламу без разрешения модераторов.

Бот автоматически сохранит правила и подтвердит обновление сообщением.

Умная обработка ссылок

Если в правилах содержится ссылка на Telegraph или Teletype, бот автоматически распознает её и создаст красивое кликабельное превью статьи с кнопкой для просмотра. Это делает правила более удобными и визуально привлекательными для пользователей.

Как удалить правила

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

Правила очистить

После этого правила будут удалены, и команда /rules больше не будет работать в этом чате до тех пор, пока не будут установлены новые правила.

Настройка прав доступа

По умолчанию управление правилами доступно администраторам и модераторам. Вы можете настроить доступ к управлению правилами для других рангов:

  1. Откройте настройки чата командой настройки или конфиг.
  2. Перейдите в раздел Права/ранги.
  3. Выберите ранг, для которого хотите настроить доступ (например, Ст. модератор, Мл. модератор).
  4. Откройте раздел Доступ к настройкам.
  5. Включите или выключите опцию Управление правилами.

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

Команды модерации

Муты

  • мут <время> @user — выдать мут пользователю.
  • размут @user — снять мут с пользователя.

Форматы времени: секунды, минуты, часы, дни (например 15 минут, 2 часа, 5 дней).

Указание причины: для указания причины напишите её на новой строке в том же сообщении.

Автоматический размут: По истечении времени мут автоматически снимается, и бот отправляет сообщение о размуте участника.

Пример сообщения о размуте от бота 
мут 30 минут @username
спам

Баны

  • бан @user — забанить пользователя.
  • разбан @user — снять бан с пользователя.

Указание причины: для указания причины напишите её на новой строке в том же сообщении.

Автоматический разбан: Аналогично мутам, при разбане бот также отправляет уведомление о снятии ограничений.

бан @username
реклама

Предупреждения

  • варн @user — выдать предупреждение пользователю.
  • анварн @user — снять предупреждение.

Указание причины: для указания причины напишите её на новой строке в том же сообщении.

варн @username
спам

Кик

  • кик @user — исключить пользователя из чата.

Указание причины: для указания причины напишите её на новой строке в том же сообщении.

Примечание: После кика пользователь может вернуться в чат по приглашению.

кик @username
нарушение правил

Настройки

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

Как работать с настройками

  • настройки или конфиг — открыть панель настроек (требуются права администратора или владельца).

Что можно настроить

  • Параметры варнов: настройка системы предупреждений, можно настроить лимит варнов, а так же наказание за достижение лимита
  • Ранги и права: управление ролями пользователей (Владелец, Админ, Ст. модератор, Мл. модератор, Пользователь).
  • Автодопуск: автоматическое принятие заявок на вступление в чат.
  • Статистика: включение/выключение сбора статистики в чате.
  • Другие параметры которые не были перечислены выше.

Сетка чатов

Сетка чатов — это система, позволяющая связать до 5 чатов для совместного управления и статистики. Чаты в сетке могут делиться статистикой, синхронизировать настройки и управление.

Как создать сетку чатов

  1. Используйте команду /net в личных сообщениях с ботом.
  2. Выберите "Создать сетку" — бот создаст сетку и предоставит код для добавления чатов.
  3. В первом чате отправьте код — этот чат станет основным чатом сетки.
  4. Во втором и последующих чатах (до 5 чатов) также отправьте код для добавления в сетку.
  5. После добавления двух чатов сетка будет готова к использованию.

Примечание: Один пользователь может иметь только одну сетку чатов. Для управления существующей сеткой используйте команду /net.

Топ чатов

Топ чатов — это рейтинг самых активных чатов на основе количества сообщений за определенный период.

  • Топ чатов показывает самые активные чаты за последние 3 дня (топ 15).
  • Для каждого чата отображается количество сообщений и общая статистика активности.
  • Доступ к топу чатов можно получить через кнопку "🏆 Топ чатов" в личных сообщениях с ботом.
  • Можно просмотреть детальную информацию о каждом чате из топа.

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

Случайный чат

Случайный чат — это функция, которая позволяет найти интересные чаты и новые знакомства.

  • Бот случайным образом выбирает один из доступных публичных чатов.
  • Для каждого чата показывается информация: название, описание, количество участников, статистика активности за последние 7 дней.
  • Доступ к случайному чату можно получить через кнопку "🎲 Случайный чат" в личных сообщениях с ботом.
  • Если предложенный чат не подходит, можно запросить другой случайный чат.

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

Версии

Система версионирования

PIXEL использует семантическое версионирование в формате Version X.Y, где:

  • X — мажорная версия (крупные изменения, новые функции)
  • Y — минорная версия (новые функции, улучшения, исправления)

Каждая версия имеет свой репозиторий на GitHub, что позволяет легко отслеживать изменения и вносить вклад в конкретную версию.

Текущая версия бота: Version 1.11

Полезные статьи

Что такое репутация и как она работает

Репутация — это система оценки пользователей на основе их поведения в чатах.

⚠️ Важно: Репутация ни на что не влияет! Это просто информационный показатель, который отражает активность и поведение пользователя в чатах.

Как работает репутация

  • Репутация измеряется в баллах от 0 до 100.
  • Положительные действия (активность в чате, хорошее поведение) могут повышать репутацию.
  • Отрицательные действия (муты, баны, предупреждения) снижают репутацию.
  • Продолжительность мута влияет на размер штрафа к репутации.

Уровни репутации

  • 90-100: Отличная репутация
  • 70-89: Хорошая репутация
  • 50-69: Средняя репутация
  • 30-49: Низкая репутация
  • 0-29: Очень низкая репутация

Просмотр репутации

  • /reputation — показать свою репутацию.
  • /reputation @username — показать репутацию другого пользователя.
  • Репутация также отображается в профиле пользователя (команда профиль).

Последнее обновление: 29.12.2025