ListTelegram
用于管理 Paper 1.21.11 Minecraft 服务器的 Telegram 机器人
一款通过 Telegram 全面管理服务器的插件。从白名单到控制台监控——一切尽在同一个机器人中。
? 功能
? 白名单系统
- 玩家通过 Telegram 机器人提交申请
- 管理员一键批准/拒绝
- 在提交申请时可请求绑定账号
- ⚠️ 注意: 机器人的白名单是独立于 Minecraft 白名单的系统!它们不是同一个东西。
? Telegram 登录(新功能!)
- 强制绑定: 要求绑定 Telegram 才能登录服务器
- 登录验证: 在以下情况通过 Telegram 确认登录:
- 新 IP 地址
- 每第 N 次登录(可配置)
- 首次登录服务器
- “✅ 是我”和“❌ 不是我”按钮进行确认
- 防止账号被盗
? 账号绑定
- 玩家将 Minecraft 账号与 Telegram 关联
- 唯一的绑定码
- 可通过机器人解绑
? 玩家统计
- 总游戏时间
- 首次和最后登录日期
- 服务器登录次数
- 每日活跃度图表
? 聊天桥接
- 同步游戏聊天与 Telegram 群组
- 双向消息传递
- 可配置的消息格式
? 投诉系统
- 玩家通过机器人提交投诉
- 管理员收到通知
- 可向玩家回复
? 管理面板
- ? 实时控制台: 查看和执行命令
- ? 服务器管理: 带确认的停止/重启
- ? 玩家封禁
- ? 白名单列表
?️ 安装
- 下载最新版本的插件
- 将
.jar 文件放入服务器的 plugins 文件夹
- 启动服务器以生成 config.yml
- 配置 config.yml
- 重启服务器
⚙️ 配置 config.yml
# 是否启用白名单?
whitelist:
enabled: true
# Telegram 登录 - 登录所需的账号绑定
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"
# 来自 @userinfobot 的管理员聊天 ID
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)
用于管理 Paper 1.21.11 Minecraft 服务器的 Telegram 机器人
一款通过 Telegram 实现服务器全面管理的插件。从白名单到控制台监控——一切尽在单一机器人中。
? 功能
? 白名单系统
- 玩家通过 Telegram 机器人提交申请
- 管理员一键批准或拒绝
- 可选择要求在申请时绑定账号
- ⚠️ 注意: 机器人白名单与 Minecraft 白名单是独立的!它们并非同一系统。
? Telegram 登录(新功能!)
- 强制绑定: 要求绑定 Telegram 才能加入服务器
- 登录验证: 在以下情况通过 Telegram 确认登录:
- 新 IP 地址
- 每第 N 次登录(可配置)
- 首次登录服务器
- 提供 "✅ 是我" 和 "❌ 不是我" 按钮进行确认
- 防止账号被盗
? 账号绑定
- 玩家将 Minecraft 账号绑定至 Telegram
- 生成唯一绑定码
- 可通过机器人解绑
? 玩家统计
- 总游戏时长
- 首次和最后登录日期
- 登录次数
- 按日活动的图表
? 聊天桥接
- 同步游戏聊天与 Telegram 群组
- 双向消息传输
- 可自定义消息格式
? 举报系统
- 玩家通过机器人提交举报
- 管理员收到通知
- 可直接回复玩家
? 管理面板
- ? 实时控制台: 查看并执行命令
- ? 服务器管理: 带确认机制的停止/重启
- ? 玩家封禁
- ? 白名单查看
?️ 安装
- 下载最新插件版本
- 将
.jar 文件放入服务器 plugins 文件夹
- 启动服务器以生成 config.yml
- 配置 config.yml
- 重启服务器
⚙️ 配置设置
# 是否启用白名单
whitelist:
enabled: true
# Telegram 登录 - 用于加入的账号关联
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"
# 来自 @userinfobot 的管理员聊天 ID
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)
- ? 管理面板 — 打开控制面板
- ? 白名单 — 显示列表
- ? 统计信息 — 服务器统计数据
- ? 封禁玩家 — 封禁玩家
- ? 停止服务器 — 停止运行
- ? 重启服务器 — 重启
- ? 控制台 — 控制台流
! command — 在控制台中执行命令(前缀为 ! 和空格)
? 游戏内命令
| 命令 |
描述 |
/link <code> |
绑定 Telegram 账号 |
/lt help |
列出命令 |
/lt reload |
重新加载配置 |
/lt importstats |
导入统计数据 |
/lt importvanilla |
从 whitelist.json 导入数据 |
/lt whitelist add <player> |
添加至白名单 |
/lt whitelist remove <player> |
从白名单移除 |
? 要求
- 服务器: Paper/Spigot 1.21.11
- Java: 21
- Telegram 机器人: 需通过 @BotFather 创建
? 许可证
MIT License
ListTelegram
Telegram-бот для управления Minecraft-сервером на Paper 1.21.11
Плагин для полного управления сервером через Telegram. От вайтлиста до мониторинга консоли — всё в одном боте.
? Функции
? Система вайтлиста
- Игроки подают заявки через Telegram-бот
- Администраторы одобряют/отклоняют одной кнопкой
- Возможность запросить привязку аккаунта при подаче заявки
- ⚠️ Внимание: Вайтлист бота — это отдельная система от вайтлиста Minecraft! Это НЕ одно и то же.
? Telegram Login (новая функция!)
- Обязательная привязка: требует привязку Telegram для входа на сервер
- Верификация при входе: подтверждение входа через Telegram при:
- Новом IP-адресе
- Каждом N-ом входе (настраивается)
- Первом входе на сервер
- Кнопки "✅ Это я" и "❌ Не я" для подтверждения
- Защита от кражи аккаунта
? Привязка аккаунтов
- Игроки связывают Minecraft-аккаунт с Telegram
- Уникальный код привязки
- Возможность отвязки через бота
? Статистика игроков
- Общее время игры
- Дата первого и последнего входа
- Количество входов на сервер
- График активности по дням
? Мост чата
- Синхронизация игрового чата с Telegram-группой
- Сообщения в обе стороны
- Настраиваемый формат сообщений
? Система жалоб
- Игроки отправляют жалобы через бота
- Модераторы получают уведомления
- Возможность ответить игроку
? Админ-панель
- ? Живая консоль: просмотр и выполнение команд
- ? Управление сервером: стоп/рестарт с подтверждением
- ? Баны игроков
- ? Список вайтлиста
?️ Установка
- Скачай последнюю версию плагина
- Положи
.jar в папку plugins сервера
- Запусти сервер для генерации config.yml
- Настрой config.yml
- Перезапусти сервер
⚙️ Настройка 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
- Download latest plugin version
- Place
.jar into server plugins folder
- Start server to generate config.yml
- Configure config.yml
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧