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