README.md

Platform.FakePlayer

文档

项目简介

一款基于 Nonebot2 用多种方式与 Minecraft 交互的 Python QQ 机器人。功能丰富，使用简单且可以自行配置，仅需简单配置即可使用。目前已实现的功能有：

• 多服互联，群服互通。
  • 在不同服务器之间转发消息。
  • 可在游戏内看到 QQ 群的消息。
  • 可使用指令在游戏内向 QQ 群发送消息。
  • 可播报服务器开启、关闭，玩家进入离开服务器以及死亡消息。
• 使用 WebUi 简单配置。
• 戳一戳机器人发送一言卡片。
• 可自行配置指令的开启或关闭。
• 对 QQ 群指令相应。目前已实现的指令有：
  • luck 查看今日幸运指数。
  • list 查询每个服务器的玩家在线情况。
  • help 查看帮助信息。
  • server 查看当前在线的服务器并显示对应编号，也可用于查看服务器占用。
  • bound 有关绑定白名单的指令。
  • command 发送指令到服务器。

更多功能还在探索中……

Warning

本项目采用 GPL3 许可证，请勿商用！如若修改请务必开源并且注明出处。

本项目是通过在服务器上挂假人来与 BotServer 对接的工具，基于 Node.js 的 mineflayer 库。

Caution

只有 Mineflayer 库支持的 Minecraft 版本才能使用本工具，支持范围请到 这里 查看。

特色功能

• 可以播报玩家死亡。
• 私聊假人发送消息到 QQ 群。

搭建环境

本项目基于 Node.js 开发，请确保您的系统中已安装 Node.js 环境。如果还没安装，请到 这里 安装。

安装 Node.js 完毕后，你还需要安装如下依赖库。安装指令如下：

npm install mineflayer base-64 utf8 ws

Warning

Windows 下请确保执行指令的目录是 FakePlayer 所在的目录，否则可能无法找到依赖库。你可以用 cd 指令切换，也可以直接在文件管理器中打开 FakePlayer 所在的目录，在路径栏输入 cmd 打开命令行。

Tip

若下了很久也没有安装成功，甚至报错，请尝试设置镜像源：

npm config set registry https://registry.npmmirror.com/

安装配置

请到 Releases 下载最新版本的假人服务器。下载完毕并解压后，请配置文件夹下的 Config.json 文件，各项的含义如下：

{
    "reconnect_interval": 8000, // 重连间隔，单位毫秒
    "token": "", // 机器人服务器的 token
    "uri": "ws://{host}:{port}/", // 机器人服务器的 WebSocket 地址
    // 以下为假人账号信息
    "account": {
        "auth": "", // 登录方式，正版需改为 microsoft，不填则为离线登录
        "password": "", // 密码，不填则为离线登录
        "username": "QwQ", // 用户名，对于正版请填写邮箱
        "permission": false, // 是否拥有管理员权限
        "execute_commands": [ // 进入服务器后执行的指令，如登录等。
            "l QwQ123"
        ]
    },
    // 以下为要互联的 Minecraft 服务器信息
    "servers": [
        {
            "name": "Survival",
            "host": "locoalhost",
            "port": 25565
        },
        {
            "name": "Creative",
            "host": "locoalhost",
            "port": 25566
        }
    ]
}

运行假人

你可以双击 Start.bat 运行假人服务器，也可以在命令行中运行 node Main.js 命令。假人启动后，会自动连接到 Minecraft 服务器，并开始监听 QQ 群消息。

享受你的快乐时光吧！