tg-bridge

插件

· 作者 fulcanelly

tg-bridge 是一个开箱即用的独立插件,可在 Telegram 群组与 Minecraft 聊天之间创建聊天桥接。

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

最新 1.4.6 · 26.3 · Bukkit / Paper

一键开服(送7天)

mctg-bridge — Minecraft < - > Telegram 聊天桥接

mctg-bridge 是一款用于 Spigot 和 Paper 服务器的 Minecraft Telegram 桥接插件。它在双向同步 Minecraft 聊天与 Telegram 群组的同时,还包含了服务器管理命令、账号绑定以及可选的插件集成。

预览

image

image

功能

与仅做简单中继的插件相比,mctg-bridge 提供了:

  • 双向 Telegram 群组 <-> Minecraft 聊天通信。
  • 内置的 Telegram 命令,用于查看服务器状态、玩家列表、运行时间、内存、统计数据及排行榜统计。
  • 可选的从 Minecraft 到 Telegram 的账号绑定功能。
  • 可选的 LoginSecurity 和 InviteSystem 挂钩;仅在安装了对应插件时激活。
  • 每个玩家的聊天可见性控制及消息合并。
  • Telegram 图片渲染,支持可选的抖动处理(dithering)。
  • 可选的 ngrok 支持,可从 Telegram 启动隧道。
  • 配置存储在插件文件夹中;无需单独的桥接服务。

要求

  • 运行在 Minecraft 1.17–1.21 版本的 Spigot、Paper 或兼容分支。
  • Java 17+ 用于构建插件。
  • 一个 Telegram 机器人和一个 Telegram 群组。

快速开始

  1. 下载最新的 JAR 文件。
  2. 将其放入 plugins/ 目录。
  3. 启动一次服务器以生成配置文件。
  4. 通过 @BotFather 创建 Telegram 机器人并禁用隐私模式。
  5. 将 api_token 添加到 plugins/tg-bridge/config.yml。
  6. 在你的 Telegram 群组中运行 /attach <code>。
  7. 重启服务器。

完整详细设置

1. Telegram 设置

  1. 在 Telegram 中打开 @BotFather。
  2. 运行 /newbot 并按照提示操作。
  3. 复制机器人的 API Token。请妥善保管,不要泄露。
  4. 运行 /setprivacy,选择该机器人,并将隐私设置为 Disabled,以便它能接收群组消息。
  5. 将机器人添加到目标 Telegram 群组。赋予其读取和发送消息所需的权限。

2. Minecraft 服务器设置

  1. 从 Releases 下载最新的稳定版 JAR 文件。
  2. 将其复制到服务器的 plugins/ 目录。
  3. 启动服务器一次。插件会创建 plugins/tg-bridge/config.yml。
  4. 将 Token 填入 api_token:
api_token: "123456:replace-with-your-token"
  1. 重启服务器。控制台会打印出一个临时代码,例如:
[tg-bridge] chat_id is null, use /attach <secretTempCode> to pin one
[tg-bridge] secretTempCode is set to -72683
  1. 在目标 Telegram 群组中,使用服务器打印的代码发送 /attach -72683。
  2. 再次重启服务器。桥接已就绪。

切勿公开 api_token 或临时的绑定代码。

使用示例

Telegram 群组命令

/list       在线的 Minecraft 玩家
/ping       检查机器人是否响应
/uptime     显示服务器运行时间
/memory     显示已分配内存
/stats      显示玩家统计数据
/top        显示排行榜统计
/kickme     踢出你绑定的 Minecraft 账号

预览

image

image

在安装对应插件后可用:

/invite     邀请某人加入服务器 (InviteSystem)
/removepass 移除你的密码 (LoginSecurity)
/changepass 修改你的密码 (LoginSecurity)

Minecraft 命令

/tg chat show
/tg chat hide
/tg account register

/tg chat hide 隐藏执行者看到的桥接 Telegram 消息。/tg account register 启动 Telegram 账号绑定流程。

设置

编辑 plugins/tg-bridge/config.yml,然后重启服务器。

设置项 用途
api_token Telegram 机器人 Token。必填。
chat_id 绑定的 Telegram 群组 ID。由 /attach 自动设置。
enable_chat 启用或禁用 Telegram 到 Minecraft 的聊天。
enable_dithering 为 Telegram 照片启用图像抖动处理。
language 默认注册消息的语言。
max_mc_accounts_per_tg 一个 Telegram 账号最多可绑定的 Minecraft 账号数量。
log_status 控制状态日志记录。
ngrok_auth /tunnel 使用的 ngrok Auth Token。

要使用可选的隧道功能,请将 ngrok auth token 放置在 ngrok_auth 中,然后在 Telegram 中发送 /tunnel。前往 ngrok 获取 Token。

从源码构建

mvn clean install

构建好的插件 JAR 文件将在 target/ 目录下生成。

链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源