{"id":34767362,"url":"https://github.com/looseprince/pf-gugubot","last_synced_at":"2026-02-07T08:00:50.263Z","repository":{"id":177219688,"uuid":"563836846","full_name":"LoosePrince/PF-GUGUBot","owner":"LoosePrince","description":"MCDR-GUGUBot QQ机器人 群聊管理 聊天互转（原PFingan服务器MCDRQQ机器人插件）","archived":false,"fork":false,"pushed_at":"2026-02-03T05:12:14.000Z","size":14423,"stargazers_count":23,"open_issues_count":5,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-03T18:50:59.981Z","etag":null,"topics":["mcdr-plugin","minecraft","pfingan-server","qqbot"],"latest_commit_sha":null,"homepage":"https://looseprince.github.io/PF-GUGUBot/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LoosePrince.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-11-09T12:50:24.000Z","updated_at":"2026-02-03T05:11:57.000Z","dependencies_parsed_at":"2024-01-14T12:50:02.626Z","dependency_job_id":"c2b8e6a8-3ce0-4824-aea8-1e3002d6b95e","html_url":"https://github.com/LoosePrince/PF-GUGUBot","commit_stats":null,"previous_names":["looseprince/pf-gugubot"],"tags_count":103,"template":false,"template_full_name":null,"purl":"pkg:github/LoosePrince/PF-GUGUBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoosePrince%2FPF-GUGUBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoosePrince%2FPF-GUGUBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoosePrince%2FPF-GUGUBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoosePrince%2FPF-GUGUBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LoosePrince","download_url":"https://codeload.github.com/LoosePrince/PF-GUGUBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoosePrince%2FPF-GUGUBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29189675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T07:37:03.739Z","status":"ssl_error","status_checked_at":"2026-02-07T07:37:03.029Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcdr-plugin","minecraft","pfingan-server","qqbot"],"created_at":"2025-12-25T07:42:04.320Z","updated_at":"2026-02-07T08:00:50.257Z","avatar_url":"https://github.com/LoosePrince.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GUGUBot\n\n\u003cdiv align=\"center\"\u003e\n\n[![Visitor Count](https://count.getloli.com/get/@PF-GUGUBot)] \n\n[![查看次数起始时间](https://img.shields.io/badge/查看次数统计起始于-2023%2F9%2F2-1?style=flat-square)](/)\n[![仓库大小](https://img.shields.io/github/repo-size/LoosePrince/PF-GUGUBot?style=flat-square\u0026label=仓库占用)](/) \n[![最新版](https://img.shields.io/github/v/release/LoosePrince/PF-GUGUBot?style=flat-square\u0026label=最新版)](https://github.com/LoosePrince/PF-GUGUBot/releases/latest/download/GUGUbot.mcdr)\n[![议题](https://img.shields.io/github/issues/LoosePrince/PF-GUGUBot?style=flat-square\u0026label=Issues)](https://github.com/LoosePrince/PF-GUGUBot/issues) \n[![已关闭issues](https://img.shields.io/github/issues-closed/LoosePrince/PF-GUGUBot?style=flat-square\u0026label=已关闭%20Issues)](https://github.com/LoosePrince/PF-GUGUBot/issues?q=is%3Aissue+is%3Aclosed)\n[![下载量](https://img.shields.io/github/downloads/LoosePrince/PF-GUGUBot/total?style=flat-square\u0026label=下载量)](https://github.com/LoosePrince/PF-GUGUBot/releases)\n[![最新发布下载量](https://img.shields.io/github/downloads/LoosePrince/PF-GUGUBot/latest/total?style=flat-square\u0026label=最新版本下载量)](https://github.com/LoosePrince/PF-GUGUBot/releases/latest)\n\n**一个功能强大的 MCDR 插件，实现 Minecraft 服务器与 QQ 群的无缝互通**\n\n[快速开始](#快速开始) • [功能特性](#功能特性) • [完整文档](https://looseprince.github.io/PF-GUGUBot/) • [问题反馈](https://github.com/LoosePrince/PF-GUGUBot/issues)\n\n\u003c/div\u003e\n\n---\n\n## 简介\n\nGUGUBot 是一个专为 MCDReforged 设计的 QQ 机器人插件，支持离线服务器和正版/离线混合服务器。它不仅实现了游戏内外的聊天互通，还集成了白名单管理、玩家绑定、违禁词过滤等实用功能，让服务器管理更加便捷。\n\n### 核心特性\n\n- **🔄 双向聊天转发** - MC 服务器与 QQ 群消息实时互通，支持图片、表情等多种消息类型\n- **👥 智能绑定系统** - 玩家 QQ 与游戏 ID 绑定，支持 Java 版和基岩版，退群自动解绑\n- **🎯 白名单管理** - 完善的白名单系统，支持在线/离线/基岩版模式\n- **🛡️ 违禁词过滤** - 自动检测并撤回包含违禁词的消息\n- **🤖 多机器人风格** - 可切换的机器人回复风格，个性化定制\n- **🔗 多服互联** - 支持多个 Minecraft 服务器之间的消息互通\n- **📊 玩家管理** - 在线玩家查询、不活跃玩家检查、未绑定用户检查\n- **⚙️ 命令执行** - 远程执行 MC 命令和 MCDR 命令（管理员权限）\n- **📝 关键词回复** - 自定义关键词触发自动回复\n- **✅ 待办管理** - 群内协作待办事项系统\n\n\u003e [!NOTE]\n\u003e **招募贡献者**\n\u003e \n\u003e GUGUbot 和 WebUI 项目正在招募有志者加入开发！\n\u003e \n\u003e 有意者请加 QQ [1377820366](http://wpa.qq.com/msgrd?v=3\u0026uin=1377820366\u0026site=qq\u0026menu=yes) 或 QQ群 [726741344](https://qm.qq.com/q/TqmRHmTmcU)\n\n---\n\n## 快速开始\n\n### 前置依赖\n\n在安装 GUGUBot 之前，请确保已安装以下依赖：\n\n| 依赖项 | 版本要求 | 说明 |\n|--------|---------|------|\n| [MCDReforged](https://github.com/Fallen-Breath/MCDReforged) | ≥ 2.0.0 | Minecraft 服务器管理框架 |\n| [whitelist_api](https://github.com/TISUnion/whitelist_api) | ≥ 1.3.0 | 白名单 API 插件 |\n| [mg_events](https://github.com/AnzhiZhang/MCDReforgedPlugins/tree/master/src/mg_events) | ≥ 0.2.3 | 游戏事件监听插件 |\n\n### 安装方式\n\n#### 方式一：MCDR 一键安装（推荐）\n\n```bash\n!!MCDR plugin install gugubot\n```\n\n安装完成后：\n1. 配置 `/config/GUGUbot/config.yml`（配置机器人基本信息）\n2. 重载 gugubot：`!!MCDR plugin reload gugubot`\n\n#### 方式二：手动安装\n\n1. 下载前置插件并放入 `/plugins` 目录\n2. 前往 [Releases](https://github.com/LoosePrince/PF-GUGUBot/releases) 下载 `gugubot-vX.X.X.mcdr`\n3. 将 `gugubot-vX.X.X.mcdr` 放入 `/plugins` 目录\n4. 按照上述步骤配置文件\n5. 重启或重载插件\n\n### 基础配置\n\n#### 1. QQ 机器人配置\n\n选择以下任一方案配置 QQ 机器人：\n\n- **[NapCat](https://napneko.github.io/)** - 推荐，稳定高效\n- **[LiteLoaderQQNT + LLOneBot](https://github.com/LLOneBot/LLOneBot)** - 轻量级方案\n\n配置 WebSocket 服务端口（如 `8080`），消息上报格式选择 **CQ 码** 或者 **消息体**。\n\n#### 3. GUGUBot 配置\n\n编辑 `/config/GUGUbot/config.yml`，配置以下必要项：\n\n```yaml\nconnector:\n  QQ:\n    connection:\n      port: 8777  # WebSocket 服务端口\n    permissions:\n      admin_ids:  # 管理员 QQ 号\n        - 1234567890\n      group_ids:  # 要监听的 QQ 群号\n        - 123456789\n```\n\n\u003e [!TIP]\n\u003e 完整配置说明请查看 [在线文档 - 配置指南](https://looseprince.github.io/PF-GUGUBot/configuration/)\n\n---\n\n## 功能特性\n\n### 聊天系统\n\n- **双向消息转发**：游戏内聊天实时同步到 QQ 群，QQ 群消息显示在游戏内\n- **多媒体支持**：支持图片、表情等多种消息类型\n- **自定义模板**：可自定义消息格式和显示样式\n- **游戏事件转发**：玩家加入/离开、成就、死亡消息等\n\n### 玩家绑定系统\n\n```\n#绑定 \u003c游戏ID\u003e [基岩]     # 绑定自己的游戏账号\n#绑定 [@QQ号] \u003c游戏ID\u003e    # 管理员为他人绑定\n#解绑 [游戏ID]            # 解绑账号\n#绑定 列表                # 查看绑定列表\n```\n\n- 支持 Java 版和基岩版账号分别绑定\n- 退群自动解绑（可配置）\n- 绑定时自动添加白名单（可配置）\n\n### 白名单管理\n\n```\n#白名单 添加 \u003c玩家名\u003e [模式]   # 添加白名单\n#白名单 删除 \u003c玩家名\u003e          # 删除白名单\n#白名单 列表                   # 查看白名单\n#白名单 开启/关闭              # 启用/禁用白名单\n```\n\n支持三种模式：\n- `online` / `正版` - 正版验证\n- `offline` / `离线` - 离线模式\n- `bedrock` / `基岩` - 基岩版\n\n### 命令执行系统\n\n```\n#执行 \u003cMC命令\u003e            # 执行 Minecraft 命令\n#mcdr \u003cMCDR命令\u003e          # 执行 MCDR 命令\n#执行@服务器名 \u003c命令\u003e      # 跨服执行（多服互联）\n```\n\n\u003e 仅管理员可用\n\n### 其他功能\n\n- **关键词回复**：自定义关键词触发特定回复\n- **违禁词过滤**：自动检测并处理违禁内容\n- **风格系统**：切换机器人回复风格\n- **待办管理**：群内协作管理待办事项\n- **玩家列表查询**：查询当前在线玩家\n- **不活跃检查**：定期检查不活跃玩家并通知\n- **未绑定提醒**：提醒新成员绑定账号\n\n查看更多功能详情，请访问 [完整文档 - 功能列表](https://looseprince.github.io/PF-GUGUBot/features/)\n\n---\n\n## 多服互联\n\nGUGUBot 支持多个 Minecraft 服务器之间的消息互通，实现跨服聊天和命令执行。\n\n配置示例：\n\n```yaml\nconnector:\n  minecraft_bridge:\n    enable: true\n    is_main_server: true  # 主服务器\n    connection:\n      host: 127.0.0.1\n      port: 8787\n```\n\n详细配置请参考 [多服互联教程](https://looseprince.github.io/PF-GUGUBot/multi-server/)\n\n---\n\n## 文档\n\n- 📖 [完整在线文档](https://looseprince.github.io/PF-GUGUBot/)\n- 📝 [安装指南](https://looseprince.github.io/PF-GUGUBot/installation/)\n- ⚙️ [配置说明](https://looseprince.github.io/PF-GUGUBot/configuration/)\n- 🎯 [功能详解](https://looseprince.github.io/PF-GUGUBot/features/)\n- 🔧 [API 文档](https://looseprince.github.io/PF-GUGUBot/api/)\n- ❓ [疑难解答](https://looseprince.github.io/PF-GUGUBot/troubleshooting/)\n- 🔗 [多服互联](https://looseprince.github.io/PF-GUGUBot/multi-server/)\n\n---\n\n## 开发与贡献\n\n### 开发指南\n\nGUGUBot 提供了丰富的 API 接口，方便开发者进行二次开发或集成。\n\n查看 [API 文档](https://looseprince.github.io/PF-GUGUBot/api/) 了解更多。\n\n### 贡献代码\n\n欢迎提交 Pull Request！在提交之前，请确保：\n\n1. 代码符合项目的编码规范\n2. 添加必要的注释和文档\n3. 测试新功能或修复\n\n### 项目结构\n\n```\nPF-GUGUBot/\n├── GUGUbot/\n│   ├── gugubot/          # 核心代码\n│   │   ├── builder/      # 消息构建器\n│   │   ├── config/       # 配置管理\n│   │   ├── connector/    # 连接器（QQ、MC、Bridge）\n│   │   ├── logic/        # 逻辑系统\n│   │   │   ├── system/   # 核心系统（绑定、白名单等）\n│   │   │   └── plugins/  # 插件功能\n│   │   ├── parser/       # 消息解析器\n│   │   ├── utils/        # 工具类\n│   │   └── ws/           # WebSocket 服务\n│   ├── lang/             # 多语言支持\n│   └── requirements.txt  # 依赖列表\n├── docs/                 # 文档源文件\n└── tests/                # 测试文件\n```\n\n---\n\n## 问题反馈与支持\n\n### 遇到问题？\n\n1. 查看 [疑难解答](https://looseprince.github.io/PF-GUGUBot/troubleshooting/)\n2. 搜索 [已有 Issues](https://github.com/LoosePrince/PF-GUGUBot/issues)\n3. 提交新的 [Issue](https://github.com/LoosePrince/PF-GUGUBot/issues/new)\n\n### 联系方式\n\n- **QQ**：[1377820366](http://wpa.qq.com/msgrd?v=3\u0026uin=1377820366\u0026site=qq\u0026menu=yes)\n- **QQ 群**：[726741344](https://qm.qq.com/q/TqmRHmTmcU)\n- **GitHub Issues**：[提交问题](https://github.com/LoosePrince/PF-GUGUBot/issues)\n\n---\n\n## 致谢\n\n### 代码贡献\n\n- [QQChat](https://github.com/AnzhiZhang/MCDReforgedPlugins/tree/master/src/qq_chat) | [AnzhiZhang](https://github.com/AnzhiZhang) - 原始代码基础\n\n### 技术支持\n\n- [@XueK__](https://github.com/XueK66) - 核心开发与技术支持\n\n### 文档贡献\n\n- [@Dreamwxz](https://github.com/Dreamwxz) - 第三方文档 [PF-plugins](https://docs.pfingan.com/PF-gugubot/)\n\n### 社区反馈\n\n感谢所有提交 Issue、Pull Request 和提供反馈的用户！\n\n---\n\n## TODO\n\n- [ ] [多服聚合](https://github.com/LoosePrince/PF-GUGUBot/issues/106)\n- [ ] [联动 WebUI](https://github.com/LoosePrince/PF-GUGUBot/issues/107) \u0026 [WebUI 开发](https://github.com/LoosePrince/PF-MCDR-WebUI/issues/8)\n\n---\n\n## 许可证\n\n本项目基于 GPL-3.0 许可证开源。详见 [LICENSE](LICENSE.txt)。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ 如果这个项目对你有帮助，请给我们一个 Star！**\n\nMade with ❤️ by [LoosePrince](https://github.com/LoosePrince) \u0026 [XueK__](https://github.com/XueK66)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flooseprince%2Fpf-gugubot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flooseprince%2Fpf-gugubot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flooseprince%2Fpf-gugubot/lists"}