TelegramList

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

```yaml

Вайтлист включен?

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 <ник>` | Удалить из вайтлиста |

---

📝 Требования

- Telegram-бот: Paper/Spigot 1.21.11 - Telegram-бот: 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!)

- Login verification: 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

- 📋 Whitelist view view and execute commands - 📋 Whitelist view stop/restart with confirmation - 📋 Whitelist view - 📋 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

```yaml

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)

- 🚨 Report — submit whitelist application - 🚨 Report — link Minecraft to Telegram - 🚨 Report — view statistics - 🚨 Report — submit a report

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

- `! command` — open panel - `! command` — show list - `! command` — server statistics - `! command` — ban a player - `! command` — stop - `! command` — restart - `! command` — 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

- Telegram bot: Paper/Spigot 1.21.11 - Telegram bot: 21 - Telegram bot: from @BotFather

---

📄 License

MIT License