ListTelegram

Telegram-бот для управления Minecraft-сервером на Paper 1.21.11

Плагин для полного управления сервером через Telegram. От вайтлиста до мониторинга консоли — всё в одном боте.

📋 Функции

🔐 Система вайтлиста

• Игроки подают заявки через Telegram-бот
• Администраторы одобряют/отклоняют одной кнопкой
• Возможность запросить привязку аккаунта при подаче заявки
• ⚠️ Внимание: Вайтлист бота — это отдельная система от вайтлиста Minecraft! Это НЕ одно и то же.

🔗 Telegram Login (новая функция!)

• Обязательная привязка: требует привязку Telegram для входа на сервер
• Верификация при входе: подтверждение входа через Telegram при:
  • Новом IP-адресе
  • Каждом N-ом входе (настраивается)
  • Первом входе на сервер
• Кнопки "✅ Это я" и "❌ Не я" для подтверждения
• Защита от кражи аккаунта

👤 Привязка аккаунтов

• Игроки связывают Minecraft-аккаунт с Telegram
• Уникальный код привязки
• Возможность отвязки через бота

📊 Статистика игроков

• Общее время игры
• Дата первого и последнего входа
• Количество входов на сервер
• График активности по дням

🌉 Мост чата

• Синхронизация игрового чата с Telegram-группой
• Сообщения в обе стороны
• Настраиваемый формат сообщений

🚨 Система жалоб

• Игроки отправляют жалобы через бота
• Модераторы получают уведомления
• Возможность ответить игроку

👑 Админ-панель

• 🔴 Живая консоль: просмотр и выполнение команд
• 🛑 Управление сервером: стоп/рестарт с подтверждением
• 🚫 Баны игроков
• 📋 Список вайтлиста

🛠️ Установка

1. Скачай последнюю версию плагина
2. Положи .jar в папку plugins сервера
3. Запусти сервер для генерации config.yml
4. Настрой config.yml
5. Перезапусти сервер

⚙️ Настройка config.yml

# Вайтлист включен?
whitelist:
  enabled: true

# Telegram Login - привязка аккаунта для входа
telegram-login:
  # Включить требование привязки Telegram
  enabled: false
  # Если true - игрок должен привязать Telegram для входа
  required: false
  # Отправлять запрос подтверждения при подозрительном входе
  verify-on-login: true
  # Подтверждать при первом входе
  verify-on-first-login: true
  # Подтверждать каждый N-й вход
  verify-every-n-logins: 10

# Настройки Telegram-бота
telegram:
  # Токен бота от @BotFather
  token: "YOUR_BOT_TOKEN"
  # ID чата админа от @userinfobot
  admin-chat-id: "YOUR_CHAT_ID"
  # (Опционально) ID модераторов
  moderator-chat-ids:
    # - "MODERATOR_ID_1"
  # Имя бота (без @)
  bot-username: "YourBotName"
  # (Опционально) ID группы для моста чата
  chat-bridge-group-id: ""

🤖 Telegram-бот

Открой бота в Telegram и нажми /start. Бот покажет меню с кнопками.

Меню игроков (кнопки)

• 📝 Подать заявку — подать заявку на вайтлист
• 🔗 Привязать аккаунт — привязать Minecraft к Telegram
• 👤 Мой профиль — посмотреть статистику
• 🚨 Подать жалобу — отправить жалобу

Админ-меню (кнопки, только admin-chat-id)

• 👑 Админ-меню — открыть панель
• 📋 Вайтлист — показать список
• 📊 Статистика — статистика сервера
• 🚫 Забанить игрока — забанить
• 🛑 Остановить сервер — остановить
• 🔄 Рестарт сервера — перезапустить
• 🔴 Консоль — трансляция консоли
• ! команда — выполнить в консоли (префикс ! и пробел)

💻 Команды в игре

| Команда | Описание |
|---------|----------|
| /link <код> | Привязать Telegram-аккаунт |
| /lt help | Список команд |
| /lt reload | Перезагрузить конфиг |
| /lt importstats | Импортировать статистику |
| /lt importvanilla | Импортировать из whitelist.json |
| /lt whitelist add <ник> | Добавить в вайтлист |
| /lt whitelist remove <ник> | Удалить из вайтлиста |

📝 Требования

• Сервер: Paper/Spigot 1.21.11
• Java: 21
• Telegram-бот: от @BotFather

📄 Лицензия

MIT License

ListTelegram (English)

Telegram bot for managing Minecraft server on Paper 1.21.11

Plugin for complete server management via Telegram. From whitelist to console monitoring — all in one bot.

📋 Features

🔐 Whitelist System

• Players submit applications via Telegram bot
• Admins approve/reject with one click
• Option to require account linking with application
• ⚠️ Note: Bot whitelist is SEPARATE from Minecraft whitelist! They are NOT the same.

🔗 Telegram Login (new feature!)

• Required linking: require Telegram linking to join server
• Login verification: confirm login via Telegram when:
  • New IP address
  • Every Nth login (configurable)
  • First login to server
• "✅ It's me" and "❌ Not me" buttons for confirmation
• Protection against account theft

👤 Account Linking

• Players link Minecraft account to Telegram
• Unique linking code
• Unlink via bot

📊 Player Stats

• Total playtime
• First and last join dates
• Join count
• Activity chart by day

🌉 Chat Bridge

• Sync game chat with Telegram group
• Messages both ways
• Customizable message format

🚨 Report System

• Players submit reports via bot
• Moderators get notifications
• Reply to player

👑 Admin Panel

• 🔴 Live console: view and execute commands
• 🛑 Server management: stop/restart with confirmation
• 🚫 Player bans
• 📋 Whitelist view

🛠️ Installation

1. Download latest plugin version
2. Place .jar into server plugins folder
3. Start server to generate config.yml
4. Configure config.yml
5. Restart server

⚙️ Config Setup

# Whitelist enabled?
whitelist:
  enabled: true

# Telegram Login - account linking for joining
telegram-login:
  # Enable Telegram linking requirement
  enabled: false
  # If true - player must link Telegram to join
  required: false
  # Send confirmation request on suspicious login
  verify-on-login: true
  # Verify on first login
  verify-on-first-login: true
  # Verify every Nth login
  verify-every-n-logins: 10

# Telegram bot settings
telegram:
  # Bot token from @BotFather
  token: "YOUR_BOT_TOKEN"
  # Admin chat ID from @userinfobot
  admin-chat-id: "YOUR_CHAT_ID"
  # (Optional) Moderator IDs
  moderator-chat-ids:
    # - "MODERATOR_ID_1"
  # Bot username (without @)
  bot-username: "YourBotName"
  # (Optional) Group ID for chat bridge
  chat-bridge-group-id: ""

🤖 Telegram Bot

Open the bot in Telegram and press /start. The bot will show a menu with buttons.

Player Menu (buttons)

• 📝 Apply — submit whitelist application
• 🔗 Link account — link Minecraft to Telegram
• 👤 My profile — view statistics
• 🚨 Report — submit a report

Admin Menu (buttons, admin-chat-id only)

• 👑 Admin menu — open panel
• 📋 Whitelist — show list
• 📊 Statistics — server statistics
• 🚫 Ban player — ban a player
• 🛑 Stop server — stop
• 🔄 Restart server — restart
• 🔴 Console — console stream
• ! command — execute in console (prefix ! and space)

💻 In-game Commands

| Command | Description |
|---------|-------------|
| /link <code> | Link Telegram account |
| /lt help | List commands |
| /lt reload | Reload config |
| /lt importstats | Import stats |
| /lt importvanilla | Import from whitelist.json |
| /lt whitelist add <player> | Add to whitelist |
| /lt whitelist remove <player> | Remove from whitelist |

📝 Requirements

• Server: Paper/Spigot 1.21.11
• Java: 21
• Telegram bot: from @BotFather

📄 License

MIT License