简介

这是一个使用 python-telegram-bot 的 Telegram 机器人插件。

同时，它还支持通过 API 调用的方式，简单地扩展机器人，添加属于你的命令！

拥有的功能：

• 支持通过 /ban /pardon 拒绝响应某用户
• 支持通过机器人执行更多原版命令而不使用 /command（如 /ban /pardon）
• 支持通过机器人启停服务器
• 支持艾特机器人进行答复，而不是发一句什么命令就答复
• 支持 MC 内执行机器人命令
• 通过 /ping 命令、/info 命令检查机器人状态
• [开发特性] 通过 /reload 远程重载插件
• 可自定义的单向/双向 MC <==> Telegram 群转发
• 基于正则表达式的易扩展命令树
• 自动处理加群、加好友、邀请入群申请
• 绑定玩家时验证正版玩家档案是否存在
• 中文和数字、英文之间做了间隔，且语气更加诙谐

没有的功能：

• 没有“管理群”、“主群”、“消息同步群”的功能，改为多群同步（不过一般就一个群而已）
• 没有“MultiServer”特性，因为会导致难以预料的 bug 且应用面小

使用

通过 MCDR 安装

在 MCDR 控制台使用 !!MCDR plugin install telegram_chat，然后 !!MCDR confirm。

通过 Release 安装

在 Releases 页面 下载对应版本的 .mcdr 文件，放入 plugins 文件夹重载。

通过源代码

在 plugins 下执行 git clone https://github.com/SALTWOOD/TelegramChat 或者 git clone [email protected]:SALTWOOD/TelegramChat，然后重载插件。

API

这是这个插件最有意思的功能之一，可以通过添加其他 MCDR 插件的方式为这个插件添加自定义命令。 这里展出一个单文件插件的代码作为示例：

from typing import Any, Callable, List

from mcdreforged.api.types import PluginServerInterface
from telegram import Update
from telegram.ext import ContextTypes

import re

PLUGIN_METADATA = {
    'id': 'tc_extension',
    'version': '1.0.0',
    'name': 'TC extension plugin',
    'description': 'TelegramChat\'s extension plugin',
    'author': 'NONE',
    'link': 'https://github.com',
    'dependencies': {
        'telegram_chat': '>=2.0.0'
    }
}

plugin: Any
send_to: Callable

def on_load(server: PluginServerInterface, old):
    global plugin, send_to
    plugin = server.get_plugin_instance("telegram_chat")

    send_to = plugin.tools.send_to

    plugin.command_tree.add_command(re.compile(r'/你的命令 (.*)'), [str], handler)

async def handler(server: PluginServerInterface, event: Update, context: ContextTypes.DEFAULT_TYPE, command: List[str],
                  event_type: MessageType):
    message = command[0]
    await send_to(
        event,
        context,
        f"你提供的参数是：\"{message}\""
    )

特别鸣谢

• QQChat - TelegramChat 前身的前身
• python-telegram-bot - 提供接入到 Telegram 的接口
• SALTWO∅D 服务器的各位 - 帮我测试机器人，还赶在发布 Release 之前帮我发现了越权漏洞（