Skip to content

yintian710/mirai-native

Repository files navigation

Mirai Native

Mirai Native 支持所有stdcall方式导出方法的 DLL 使用 Mirai 提供的 API。

大部分酷Q插件兼容,不支持CPK和解包的DLL,需获取DLL和JSON原文件,JSON文件不支持注释。

写在前面

本项目欢迎一切形式的贡献,详见 Docs

关于兼容的 酷Q 插件(比如CQHTTP)和安装方法,见 Wiki

运行环境 - !非常重要!

  • JRE 32位 - 酷Q的插件都是32位哒
  • 可能需要管理员权限,因为需要在Java目录下创建数据文件夹,如果不想授权管理员权限,请将JRE移动到不需要管理员权限的目录下

开发环境

如何使用

  1. 搭建 mirai-console 运行环境
  2. mirai-native.jar 放入 plugins 文件夹
  3. CQP.dll 和 要加载的 Native 插件 dll (不是 cpk) 一起放入 plugins\MiraiNative 下(如果有插件对应的json文件,请使用和dll相同的文件名)
  4. 如果 Native 插件有依赖的 DLL,请放入 plugins\MiraiNative\libraries
  5. 启动 mirai-console

关于托盘菜单

  • 双击流泪猫猫头查看关于信息
  • 右键流泪猫猫头打开菜单
  • 插画由作者女朋友提供

Mirai Native 插件管理器 npm

  1. mirai-console 中键入 npm 获得帮助
  2. npm (Native Plugin Manager) 可列出插件启用或停用插件以及执行指定方法(比如调用menu

npm [list|enable|disable|menu|info|load|unload] (插件 Id / 路径) (方法名)

使用须知

  1. 可使用酷Q SDK编写,部分API暂不可用,见上文 Docs
  2. 提供 Mirai 独有API,见 Mirai Native Advance SDK(建设中,见 epl-test文件夹)
  3. DLL 字符串编码采用 GB18030
  4. Bot 上线后才会调用插件的 Enable 事件,托班菜单内才可以禁用插件
  5. Mirai Native 内部使用了非阻塞,协程实现具体功能,调用所有API都立即返回,但是也有劣势,比如无法得知消息是否发送成功

如何获取酷Q插件

联系作者提供DLLJSON文件

以下方法已无效!!!

  1. 启动酷Q
  2. 查找路径 data\tmp\capp\ 的二级目录下的 cpk 文件,将后缀修改为 dll 即可

开源协议

Copyright (C) 2020 iTX Technologies

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

About

强大的 Mirai 原生插件加载器

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 82.8%
  • C++ 15.9%
  • C 1.2%
  • Batchfile 0.1%