{"id":14969495,"url":"https://github.com/dreamvoid/miraimc","last_synced_at":"2025-05-16T19:04:10.293Z","repository":{"id":37020073,"uuid":"374353031","full_name":"DreamVoid/MiraiMC","owner":"DreamVoid","description":"适用于Minecraft服务器的Mirai机器人","archived":false,"fork":false,"pushed_at":"2025-03-31T02:10:12.000Z","size":5386,"stargazers_count":186,"open_issues_count":0,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-03T19:15:19.424Z","etag":null,"topics":["bukkit","bungeecord","folia","minecraft","mirai","nukkit","nukkitx"],"latest_commit_sha":null,"homepage":"https://docs.miraimc.dreamvoid.me","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DreamVoid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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},"funding":{"github":null,"patreon":"DreamVoid","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://afdian.net/@DreamVoid"]}},"created_at":"2021-06-06T12:19:56.000Z","updated_at":"2025-03-31T02:10:09.000Z","dependencies_parsed_at":"2023-10-02T02:37:32.290Z","dependency_job_id":"c8f7987b-f406-4171-aa50-b38aaffe38bb","html_url":"https://github.com/DreamVoid/MiraiMC","commit_stats":{"total_commits":782,"total_committers":7,"mean_commits":"111.71428571428571","dds":"0.26214833759590794","last_synced_commit":"d10e90f71a238eeb9967b3b8364fb5d301fed77a"},"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DreamVoid%2FMiraiMC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DreamVoid%2FMiraiMC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DreamVoid%2FMiraiMC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DreamVoid%2FMiraiMC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DreamVoid","download_url":"https://codeload.github.com/DreamVoid/MiraiMC/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248609334,"owners_count":21132893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bukkit","bungeecord","folia","minecraft","mirai","nukkit","nukkitx"],"created_at":"2024-09-24T13:41:56.593Z","updated_at":"2025-04-12T17:44:16.364Z","avatar_url":"https://github.com/DreamVoid.png","language":"Java","funding_links":["https://patreon.com/DreamVoid","https://afdian.net/@DreamVoid"],"categories":[],"sub_categories":[],"readme":"\u003c!--suppress HtmlDeprecatedAttribute --\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003ch1\u003e MiraiMC \u003c/h1\u003e\n\n[![GitHub release](https://img.shields.io/github/v/release/DreamVoid/MiraiMC?style=flat-square\n)](https://github.com/DreamVoid/MiraiMC/releases/latest)\n[![CodeFactor](https://www.codefactor.io/Content/badges/A.svg)](https://www.codefactor.io/repository/github/dreamvoid/miraimc)\n[![GitHub Actions CI](https://img.shields.io/github/actions/workflow/status/DreamVoid/MiraiMC/maven.yml?style=flat-square)](https://github.com/DreamVoid/MiraiMC/actions/workflows/maven.yml?query=is%3Asuccess)\n![GitHub all releases](https://img.shields.io/github/downloads/DreamVoid/MiraiMC/total?style=flat-square)\n\n\u003c/div\u003e\n\n---\n\nMiraiMC 是适用于 Minecraft 服务器的 Mirai 机器人\n\n## 介绍\nMiraiMC 是一个基于 [Mirai](https://github.com/mamoe/mirai) 的 Minecraft 服务端插件，能够让你在 Minecraft 服务器上使用 Mirai QQ 机器人程序，同时提供一些 API 帮助开发者简单的调用机器人接口为自己的插件实现多样的功能。\n\n## 一切开发旨在学习，请勿用于非法用途\n\n- 本项目保证永久开源，欢迎提交 PR，但是请不要提交用于非法用途的功能。\n- 如果某功能被大量运用于非法用途或严重侵害插件使用者权益，那么该功能将会被移除。\n- 本插件完全免费开源，没有任何收费，请勿二次贩卖。\n- 鉴于项目的特殊性，作者可能在任何时间**停止更新**或**删除项目**\n\n## 下载\n* 稳定版本\n  * [Modrinth](https://modrinth.com/plugin/miraimc/versions)\n  * [GitHub 发布页](https://github.com/DreamVoid/MiraiMC/releases)\n* 开发版本\n  * [GitHub Actions CI](https://github.com/DreamVoid/MiraiMC/actions/workflows/maven.yml?query=is%3Asuccess)\n\n## 开始使用（服务器）\nMiraiMC 是一个服务端插件，因此你只需按照安装插件的方式安装 MiraiMC 即可。\n\n1. 从“下载”部分下载适用的 MiraiMC 插件，并将插件文件放入插件/模组文件夹（取决于服务端类型）。\n2. 如果服务端正在运行，请完全停止服务端。之后，启动服务端。\n3. 如果你同时使用了基于 MiraiMC 开发的插件，请在这些插件的配置文件中调整有关 MiraiMC 的配置。\n4. 最后，登录你的机器人账号即可开始享受优雅的 QQ 机器人服务！\n\n可以在这里找到更为详细的使用教程：https://docs.miraimc.dreamvoid.me/\n\n## 开始使用（插件开发者）\n* 使用 MiraiMC 开发模板开发一个全新的插件:\n  - [Maven](https://github.com/MiraiMC/MiraiMC-Template)\n  - [Gradle KotlinDSL](https://github.com/MiraiMC/MiraiMC-Template-Gradle-KotlinDSL)\n* 查阅有关 MiraiMC 开发的知识：https://docs.miraimc.dreamvoid.me/\n* 查阅 Javadoc：https://jd.miraimc.dreamvoid.me\n\n### 依赖\n\n以下列出的配置默认添加全平台的 MiraiMC 依赖。如果你只需要特定平台的 MiraiMC 依赖，请将 `Integration` 更改为对应平台的名称，如 `Bukkit` 和 `Velocity`。\n\n#### Maven \n```\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.dreamvoid\u003c/groupId\u003e\n    \u003cartifactId\u003eMiraiMC-Integration\u003c/artifactId\u003e\n    \u003cversion\u003e1.9\u003c/version\u003e\n    \u003cscope\u003eprovided\u003c/scope\u003e\n\u003c/dependency\u003e\n```\n\n#### Gradle\n```\nimplementation 'io.github.dreamvoid:MiraiMC-Integration:1.9'\n```\n\n## 指令和权限\n### 指令\n| 命令                                      | 描述                        | 权限                                      |\n|-----------------------------------------|---------------------------|-----------------------------------------|\n| /mirai                                  | MiraiMC 机器人主命令            | miraimc.command.mirai                   |\n| /mirai login \u003c账号\u003e \u003c密码\u003e \\[协议]            | 登录一个机器人（可多次执行此命令以登录多个机器人） | miraimc.command.mirai.login             |\n| /mirai logout \u003c账号\u003e                      | 退出并关闭一个机器人                | miraimc.command.mirai.logout            |\n| /mirai list                             | 列出当前在线的机器人                | miraimc.command.mirai.list              |\n| /mirai sendfriendmessage \u003c账号\u003e \u003c好友\u003e \u003c消息\u003e | 向指定好友发送消息                 | miraimc.command.mirai.sendfriendmessage |\n| /mirai sendfriendnudge \u003c账号\u003e \u003c好友\u003e        | 向指定好友发送戳一戳                | miraimc.command.mirai.sendfriendnudge   |\n| /mirai sendgroupmessage \u003c账号\u003e \u003c群号\u003e \u003c消息\u003e  | 向指定群发送消息                  | miraimc.command.mirai.sendgroupmessage  |\n| /mirai checkonline \u003c账号\u003e                 | 检查指定机器人是否在线               | miraimc.command.mirai.checkonline       |\n| /mirai autologin add \u003c账号\u003e \u003c密码\u003e \\[协议]    | 添加一个自动登录机器人账号             | miraimc.command.mirai.autologin         |\n| /mirai autologin remove \u003c账号\u003e            | 移除一个自动登录机器人账号             | miraimc.command.mirai.autologin         |\n| /mirai autologin list                   | 查看自动登录机器人账号列表             | miraimc.command.mirai.autologin         |\n| /miraimc                                | MiraiMC 插件主命令             | miraimc.command.miraimc                 |\n| /miraimc bind add \u003c玩家名\u003e \u003cQQ号\u003e           | 为玩家和QQ号添加绑定               | miraimc.command.miraimc.bind            |\n| /miraimc bind getplayer \u003c玩家名\u003e           | 获取指定玩家名绑定的QQ号             | miraimc.command.miraimc.bind            |\n| /miraimc bind getqq \u003cQQ号\u003e               | 获取指定QQ号绑定的玩家名             | miraimc.command.miraimc.bind            |\n| /miraimc bind removeplayer \u003c玩家名\u003e        | 删除一个玩家的绑定                 | miraimc.command.miraimc.bind            |\n| /miraimc bind removeqq \u003cQQ号\u003e            | 删除一个QQ号的绑定                | miraimc.command.miraimc.bind            |\n| /miraimc reload                         | 重新加载配置文件                  | miraimc.command.miraimc.reload          |\n\n### 权限\n| 权限节点                                    | 描述                            | 默认 |\n|-----------------------------------------|-------------------------------|:--:|\n| miraimc.command.mirai                   | 允许使用 /mirai                   | OP |\n| miraimc.command.mirai.*                 | 允许使用 /mirai 的所有子命令            | OP |\n| miraimc.command.mirai.login             | 允许使用 /mirai login             | OP |\n| miraimc.command.mirai.logout            | 允许使用 /mirai logout            | OP |\n| miraimc.command.mirai.list              | 允许使用 /mirai list              | OP |\n| miraimc.command.mirai.sendfriendmessage | 允许使用 /mirai sendfriendmessage | OP |\n| miraimc.command.mirai.sendfriendnudge   | 允许使用 /mirai sendfriendnudge   | OP |\n| miraimc.command.mirai.sendgroupmessage  | 允许使用 /mirai sendgroupmessage  | OP |\n| miraimc.command.mirai.checkonline       | 允许使用 /mirai checkonline       | OP |\n| miraimc.command.mirai.autologin         | 允许使用 /mirai autologin         | OP |\n| miraimc.command.miraimc                 | 允许使用 /miraimc                 | OP |\n| miraimc.command.miraimc.*               | 允许使用 /miraimc 的所有子命令          | OP |\n| miraimc.command.miraimc.bind            | 允许使用 /miraimc bind 及下属子命令     | OP |\n| miraimc.command.miraimc.reload          | 允许使用 /miraimc reload          | OP |\n\n## 许可证\n\n[GNU Affero General Public License v3.0](https://github.com/DreamVoid/MiraiMC/blob/main/LICENSE)\n\n## 致谢\n\n感谢以下人员/团队/项目为 MiraiMC 做出的贡献！\n\n* [mamoe/mirai](https://github.com/mamoe/mirai)：强大的QQ机器人支持库，MiraiMC 的核心和基础。\n* [lucko/helper](https://github.com/lucko/helper)：为 MiraiMC 提供动态加载 mirai 核心的解决方案。\n* [brettwooldridge/HikariCP](https://github.com/brettwooldridge/HikariCP)：高效的 SQL 连接池，为 MiraiMC 提供数据库连接方案。\n* [LT_Name](https://github.com/lt-name)：为 MiraiMC 优化了大量 Nukkit 代码，也为 MiraiMC 和我本人提供了很多帮助。\n* 你。\n\n## 风险提示\n\nMiraiMC 的源码仅托管于 Git‎Hub (https‎://‎github‎.‎com/DreamVoid/MiraiMC)，任何其他平台的源代码如 GitCode 等平台并非本人发布或控制，**谨防恶意后门**。\n\n作者不对上文列出的下载地址以外的插件来源负责。\n\n## 下一步的目标\n- [X] 初步实现 CoreAPI 的基础功能\n- [X] 初步完善指令和权限系统\n- [X] 初步完善 API 接口供其他插件开发者调用\n- [X] 加入自动登录机器人的功能\n- [X] 添加剩余未添加的 Mirai 事件\n- [X] 重写登录流程以适应 Bukkit（和未来支持的 Bungee，甚至 Sponge）\n- [X] 支持 BungeeCord\n- [X] 完全兼容 mirai console 的结构供已在使用 mirai 的服主使用\n- [X] 支持 Sponge\n- [X] 支持 NukkitX\n- [X] 支持 PlaceholderAPI\n- [X] ~~引入 Mirai-Http-API 模式来连接到 mirai-console~~\n- [X] 支持 Folia\n- [ ] 插件所有文本支持多语言\n- [ ] 做一个图形界面\n- [ ] 像 mirai console 一样加载 mirai console 插件（遥遥无期，欢迎 PR）\n\n[DreamVoid](https://github.com/DreamVoid) 与 [MiraiMC](https://github.com/MiraiMC)，用 ❤ 制作。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamvoid%2Fmiraimc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdreamvoid%2Fmiraimc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdreamvoid%2Fmiraimc/lists"}