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 <ник>` | Удалить из вайтлиста | --- ## 📝 Требования - **Сервер:** 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 -