Язык: 🇷🇺 Русский | 🇺🇸 English | 🇨🇳 中文

McBuddy Bot — 🤖 Telegram-бот для общения с MCBuddy — спрашивай о Майнкрафте и мгновенно получай понятные, точные ответы! 📱

Примечание: Для работы бота требуется запущенный MCBuddy Server.

• Команда /ask — задавай вопросы о Minecraft и получай AI-ответы с учётом контекста
• Прямые сообщения — общайся с ботом без команд, просто пиши сообщения
• Визуальная обратная связь — индикатор "печатает" во время обработки запроса
• Русскоязычный интерфейс — все сообщения и ответы на русском языке

• MCBuddy Server API — взаимодействие с бэкендом для получения AI-ответов
• OpenRouter поддержка — возможность использования собственного токена
• Telegram Bot API — полная интеграция с Telegram

1. Найдите бота в Telegram: @mcbuddy_bot (или создайте своего через @BotFather)
2. Начните диалог командой /start

• /start — приветственное сообщение и знакомство с ботом
• /help — справка по командам и примеры использования
• /ask <вопрос> — задать вопрос о Minecraft

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

1. Отправьте вопрос боту (через команду /ask или напрямую)
2. Бот отправляет запрос в MCBuddy Server
3. Получите AI-ответ с учётом контекста Minecraft Wiki
4. Продолжайте диалог — бот помнит контекст разговора

• Telegram Bot API — работает в личных чатах
• MCBuddy Server — требуется запущенный сервер
• Рантайм: Bun 1.0+
• Деплоймент: Docker + Docker Compose

1. Клонируйте репозиторий:

git clone https://github.com/mcbuddy-ai/mcbuddy-bot
cd mcbuddy-bot

2. Настройте переменные окружения:

# Создайте .env файл
cp .env.sample .env

# Обязательные переменные:
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
MCBUDDY_SERVER_URL=https://mcbuddy.ru

# Опциональные:
X_OPENROUTER_TOKEN=sk-or-your-token-here

Примечание: Получите токен Telegram бота через @BotFather.

3. Запустите сервисы:

docker compose up -d

4. Проверьте статус:

docker compose logs -f mcbuddy-bot

Если хотите использовать готовый образ:

1. Задекларируйте сервис mcbuddy-bot в docker-compose.yml:

services:
  mcbuddy-bot:
    image: ghcr.io/mcbuddy-ai/mcbuddy-bot:1.3.0
    env_file: .env
    environment:
      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
      MCBUDDY_SERVER_URL: ${MCBUDDY_SERVER_URL}
      X_OPENROUTER_TOKEN: ${X_OPENROUTER_TOKEN}

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

2. Запустите сервисы:

docker compose up -d

Требования:

• Bun 1.0+

1. Установите зависимости:

curl -fsSL https://bun.sh/install | bash
bun install

2. Настройте переменные окружения:

cp .env.sample .env
# Отредактируйте .env с токеном Telegram бота и URL сервера

3. Запустите бота:

# Разработка
bun run dev

# Продакшен
bun run build
bun run start

Бот поддерживает переопределение токена OpenRouter:

# В .env файле укажите ваш токен OpenRouter:
X_OPENROUTER_TOKEN=sk-or-your-custom-token-here

Этот токен будет передан в MCBuddy Server через заголовок X-OpenRouter-Token, что позволит использовать ваш собственный аккаунт OpenRouter для AI-запросов.

• TypeScript — основной язык разработки
• Bun.js — быстрый JS runtime и пакетный менеджер
• Node Telegram Bot API — библиотека для взаимодействия с Telegram Bot API
• MCBuddy Server API — интеграция с бэкендом для получения AI-ответов
• Docker + Docker Compose — контейнеризация и развертывание
• tslog — структурированное логирование

AI-инструменты использовались точечно для генерации части документации. Основная архитектура, обработка команд и интеграция с Telegram API разработаны вручную. Коммиты полностью написаны AI агентом, по возможности участие ИИ сведено к минимуму.

McBuddy Server — 🛠️⚡ Бэкенд для AI-ассистента MCBuddy с интеграцией OpenRouter и обработкой запросов

McBuddy Spigot — 💬 Spigot-плагин для интеграции MCBuddy — добавляет команду /ask для вопросов к AI-ассистенту прямо в чате Minecraft сервера! 🎮

Xi Manager — 🀄️ Telegram-бот с ИИ, стилизованный под личного помощника Xi. Личный помощник великого лидера, готовый отвечать на вопросы простого народа.

Dickobrazz — 🌶️ Дикобраз бот, он же дикобот, способен в точности до сантиметра выдать размер вашего агрегата. Современный и технологичный кокомер с системой сезонов и геймификацией.

Louisepizdon — 🥀 Луипиздон, Telegram-бот с ИИ, который честнее чем твоя бабушка. Оценит тебя по достоинству, разборка ценообразования твоих шмоток с фотографии!

Mo'Bosses — 🏆 Mo'Bosses — это лучший RPG плагин, который превращает обычных мобов в эпических боссов с продвинутой системой прогрессии игрока. В отличие от других плагинов, здесь каждый бой имеет значение, а каждый уровень открывает новые возможности! ⚔

Mo'Joins — 🎉 Кастомные входы/выходы: сообщения, звуки, частицы, фейерверки и защита после входа. Все для PaperMC.

Mo'Afks — 🛡️ Пауза в онлайне — теперь возможна. Плагин для PaperMC, который даёт игроку безопасный режим AFK: иммунитет к урону, отсутствие коллизий, игнор мобами, авто-детект неактивности и аккуратные визуальные эффекты.

🇷🇺 Сделано в России с любовью. ❤️

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

🫡 Made by Pavel Erokhin (Павел Ерохин), aka mairwunnx.