TelegramList

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： game-mechanics social utility

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)

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

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

? Требования

• Сервер: 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

? Requirements

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

? License

MIT License