Drrr-Bot

一个用于 drrr.com 的Python版Bot。

该项目是基于 Transfusion/durararobot 进行修改的。

所做的修改：

• 删除了后台交互终端。
• 添加了房间消息的本地日志（保存在logs文件夹中）。
• 添加了自动保持连接的功能（定时向Bot自己发送私信）。
• 更改配置文件为config.txt。
• 简化模块的编写方式。
• 添加了一些异常处理和自动处理功能。

快速开始

# 安装依赖
pip install -r requirements.txt

# 启动Bot
python -u main.py

配置

你可以通过编辑config.txt文件来配置机器人。

# 用户名
name = test

# Tripcode
tc = mytc123

# 头像名称
avatar = setton

# 房间ID
roomID = 6JjYq34S35

# 用户代理
agent = Bot

# 加载的模块
mods = Test, GuessNumber

# 发送消息的等待时间（秒）
throttle = 1.5

• 如果你想将某项配置保持默认，可以删除那一行。
• Tripcode（tc）可选。如果想无tc登录，只需删除该行或设置为None。
• roomID可以在房间的URL中找到，例如：https://drrr.com/room/6JjYq34S35 中6JjYq34S35就是房间ID。
• 推荐将throttle设置为至少1秒，如果发送消息太快，你的IP可能会被封禁。
• Cookies将以Bot的用户名为文件名保存在cookies文件夹中。如果想重置Cookies，只需删除该文件夹下对应的文件。
• 模块的文件名和主类名必须一致，在配置文件的mods项加入模块的名字即可启用模块，以英文逗号分隔
• 更多模块可以参考drrr-modules仓库。
• 头像参考这里。

模块示例

# modules/Test.py

from modules.module import Module

class Test(Module):
    def __init__(self, bot):
        super().__init__(bot)

    @property
    def cmds(self):
        # 指令字典，格式为：{函数名: 消息指令正则表达式}
        cmd_dict = {
                    'sayHello': r'hi',
                    'calculate': r'^\/calc\s+\d+\s+[\+\-\*\/]\s+\d+\s*$',
                    'chown': r'^\/chown',
                    'welcome': r'^进入房间$',  # 进入房间的消息默认是 "进入房间" 这个字符串，它不是一般发言消息
                    }
        return cmd_dict
    
    def sayHello(self, msg):
        self.bot.send(f'@{msg.user.name} 你好')
    
    def calculate(self, msg):
        cont = msg.message.split(' ', 1)[1]
        result = eval(cont)
        self.bot.send(cont + ' = ' + str(result))
    
    def chown(self, msg):
        self.bot.chown(msg.user.id)
    
    def welcome(self, msg):
        self.bot.send(f'欢迎@{msg.user.name}进入房间')

• 这段代码实现了四个功能：打招呼（sayHello）、计算器（calculate）、移交房主（chown）和进房欢迎（welcome）。
• cmd_dict字典是指令字典，键为函数名，值为消息指令的正则表达式。
• 当有消息发送到聊天室时，Bot会遍历cmd_dict字典，如果消息的内容匹配某个正则表达式，就会调用对应的函数进行响应。
• 进入房间的响应消息不是一般消息，它的消息指令固定是"进入房间"这个字符串，所以如果你想响应进入房间的消息，可以参考welcome的写法。
• 如果你想添加更多的功能，只需在cmd_dict字典中添加对应的函数名和指令正则表达式，并在类中实现响应函数即可。
• 具体的正则表达式语法请参考Python 正则表达式文档，其他API见下方（更多的信息在源代码中）。
• 另外，modules 文件夹下还包含了一个简单的猜数字游戏(GuessNumber.py)，可供参考。

API

msg.message: 消息的文本内容
msg.user: 发送消息的用户
    msg.user.name: 用户名
    msg.user.id: 用户ID (用于发送私信)
    msg.user.tc: 用户Tripcode
msg.type: 消息类型 (message, me, dm, join, leave, ...)

self.bot: Bot对象
    self.bot.send(text): 发送消息
    self.bot.dm(userId, text): 发送私信
    self.bot.send_url(text, url): 发送带链接的消息
    self.bot.dm_url(userId, text, url): 发送带链接的私信
    self.bot.music(name, url): 发送音乐
    self.bot.chown(userId): 移交房主
    self.bot.kick(userId): 将用户踢出房间
    self.bot.ban(userId): 禁止用户进入房间
    self.bot.title(title): 设置房间标题
    self.bot.desc(desc): 设置房间描述
    self.bot.findUser(name): 使用用户名查找用户ID
    self.bot.findUser(tc=tc): 使用用户Tripcode查找用户ID

常见问题

1. 无法登录

   • 网络问题：尝试直接用浏览器登录，如无法登录可尝试用魔法
   • Cookie过期：删除cookies文件夹
   • Tripcode太简单：多加几位，且必须同时有数字、字母、符号中的两种

2. 无法进入房间

   • 用户名重复：在config.txt更改用户名
   • 设置的房间ID错误：检查房间ID，重新在config.txt设置房间ID
   • Cookie保存的登陆信息所在的房间与config.txt设置的不匹配：删除cookies文件夹

3. 无法发出/接受消息

   • 网络问题：可以尝试重启Bot
   • 刚启动时还在加载：等待一会即可
   • 已经退出了房间：这种一般会有报错

4. 如何关闭Bot

   • 直接关闭终端
   • 房间内任意用户发送/stop

5. 出现其他报错请截图提issue

用户代理

Desktop（桌面）
Mobile（手机）
Bot（机器人）
Tv（电视）
Tablet（平板）

头像