Universal Telegram Bot

插件

· 作者 KonskoeDyplo

通过 Telegram 管理你的 Minecraft 服务器!轻松添加自定义命令!

0 本站下载 0 关注 更新于 9 个月前

最新 2.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

? Minecraft 电报机器人 - 设置指南

? 这是什么?

一款允许你通过 Telegram 管理 Minecraft 服务器的插件。玩家可以向 Telegram 群组发送指令,机器人将在服务器上执行这些操作。

? 快速安装(5 分钟)

  • 步骤 1:在 Telegram 中创建机器人
  • 打开 Telegram
  • 找到 @BotFather
  • 发送 /newbot
  • 选择机器人名称(例如 MyServerBot)
  • 获取令牌(请保存好!)
令牌格式如下:1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
  1. 步骤 2:将机器人添加到群组
  2. 创建一个新的 Telegram 群组
  3. 将你的机器人加入该群组
  4. 将机器人设为管理员
  • 获取群组 ID:
  • 将 @getidsbot 添加到群组中
  • 发送 /start
  • 复制群组 ID(以 -100 开头)

步骤 3:在服务器上安装插件

  • 下载 UniversalTelegramBot.jar 文件
  • 将其放入服务器的 plugins/ 文件夹中
  • 重启服务器

步骤 4:配置设置

首次启动后,会出现文件 plugins/TelegramBot/config.yml

编辑该文件:

telegram:
  enabled: true
  bot-token: "在此粘贴你的令牌"
  group-chat-id: "在此粘贴你的群组 ID"

步骤 5:重载插件

在游戏中执行:

/telegrambot reload

⚙️ 游戏内管理命令

基本命令:

/telegrambot status          - 检查机器人状态
/telegrambot reload          - 重载配置
/telegrambot test            - 发送测试消息
/telegrambot list            - 显示所有命令
/telegrambot debug           - 切换调试模式

权限管理:

/telegrambot addperm <ID> <permission>     - 授予用户权限
/telegrambot removeperm <ID> <permission>  - 移除权限
/telegrambot listperms                     - 列出所有权限

授予权限示例:

/telegrambot addperm (id)123456789 telegrambot.restart

? Telegram 命令

适用于所有玩家(如果已配置):

/help          - 显示命令列表
/fly <nick>    - 授予 1 小时飞行权限
/money <nick>  - 给予金钱
/kit <nick>    - 给予装备包
/online        - 查看在线玩家

适用于管理员(需要相应权限):

/kick <nick>   - 踢出玩家
/ban <nick>    - 封禁玩家
/restart       - 重启服务器
/give <nick>   - 给予物品

? 配置命令

命令示例:

commands:
  fly:
    command: "lp user %player% permission settemp essentials.fly true 60m"
    cooldown: 86400                    # 冷却时间(秒),此处为 24 小时
    eho: "Fly for 1 hour | "           # /help 菜单中的描述
    message: "✅ Fly granted!"          # 成功时的消息
    error-message: "❌ Error"           # 错误时的消息
    permission: ""                     # 所需权限(留空表示所有人可用)
    run-as-console: true               # 以控制台身份执行

命令参数:

  • command - 要在服务器上执行的命令
  • cooldown - 使用间隔冷却时间(秒)
  • eho - /help 菜单中的描述
  • message - 成功时机器人的回复
  • error-message - 出错时的回复
  • permission - 所需权限(留空表示对所有人开放)
  • run-as-console - 以控制台身份执行(建议保持为 true)

命令占位符 在 command 字段中使用:

%player%    - 来自 Telegram 命令的玩家昵称
%args%      - 命令后的所有参数
%user%      - Telegram 用户名
%user_id%   - Telegram 用户 ID

示例:

command: "eco give %player% 1000"      # 将给予玩家 1000 金钱
command: "msg %player% Hello from %user%"  # 将发送消息

? 权限系统

  1. 如何获取用户 ID:
  • 要求用户向群组发送任意消息
  • 查看服务器日志 - 其中会包含其 ID
  • 或使用 @getidsbot
  1. 授予权限:
/telegrambot addperm 123456789 telegrambot.restart
/telegrambot addperm 123456789 telegrambot.ban
  1. 标准权限:
  • telegrambot.restart - 重启权限
  • telegrambot.ban - 封禁权限
  • telegrambot.kick - 踢出权限
  • telegrambot.admin - 所有权限(适用于操作员)

?️ 故障排除

  1. 机器人无响应:
  • 检查令牌:/telegrambot status
  • 检查群组 ID
  • 确保机器人为群组管理员
  • 启用调试:/telegrambot debug
  1. 命令未执行:
  • 检查服务器日志
  • 确保安装了所需的插件
  • 检查配置中的命令语法

控制台错误:

[TelegramBot] ERROR: ... - 检查 config.yml
[TelegramBot] WARNING: ... - 通常不严重

有用的诊断命令:

/telegrambot execute say Test command  # 测试执行
/telegrambot debug                     # 启用详细日志
/telegrambot reload                    # 重载设置

? 实用技巧

  1. 对于初学者:
  • 从单个命令 /fly 开始
  • 在小群组中进行测试
  • 逐步添加新命令
  1. 对于管理员:
  • 为命令创建单独的群组
  • 指定专人负责权限分配
  • 定期检查日志
  1. 对于玩家:
  • 使用格式:/command player_nickname
  • 遵守冷却时间
  • 使用 /help 查看命令列表

完成!现在玩家可以通过 Telegram 管理服务器。从简单命令开始,逐步扩展功能。 ?

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源