?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
TelegramList

TelegramList

TelegramList — Whitelist applications, Telegram-Minecraft bridge, player reports, and more!

127
2
127
2

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

View source

Tags

Creators

Details

Licensed ARR
Published 3 months ago

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