RainyBot - 新手友好,简单易上手的机器人开发框架
-
RainyBot - 新手友好,简单易上手的机器人开发框架
项目地址:https://github.com/Xwdit/RainyBot-Core/
(更多详情请参见项目页面)关于本项目
这是一个跨平台,跨协议 (实现中) 的机器人开发框架,基于 Godot Engine 4.0 进行开发。
本项目成立的目的,是为了建立一个低门槛,简单易用的机器人开发框架。
通过提供大量精心设计的交互API/预置功能,结合GDScript脚本语言的简便语法,
来尽可能地提升开发效率且降低开发难度,让更多开发经验不足,乃至无经验的用户也能够轻松开发属于自己的各类机器人应用。功能特色:
- 模块化设计,大部分API可独立于协议后端存在,通过不同适配器实现即可对接不同协议,实现一次编写多处运行 (当前仅支持Mirai-Http协议后端)
- 简单易懂的配置与管理,一次配置完成后自动管理各个协议后端的配置/运行/连接,无需每次手动启动或进行设置
- 完善易用的API与插件管理机制,支持插件间交互/热重载/热编辑等功能,同时内置功能较为全面的插件编辑器 (暂不支持自动补全)
- 人性化GUI控制台界面,全中文调试信息输出,未来还将支持插件与GUI的交互(如自定义GUI界面)
- 开箱即用的各类辅助功能接口,可便捷初始化并管理插件配置,插件数据,事件/命令注册等
- 活跃的功能开发与问题修复,且将以社区为驱动,广泛采纳各类建议与需求,共同打造属于所有人的RainyBot
- 更多功能陆续增加中.....
注意:本项目仍处于较早期开发阶段,虽然目前核心功能已基本完备,但依然有在未经提前通知的基础上进行重大API/功能更改的可能,且可能存在未知的Bug/不稳定因素,请谨慎用于生产环境。
开始使用
接下来的部分将介绍如何配置与使用RainyBot
运行需求
支持的操作系统:64位 Windows 7 或以上版本 (Mac OS/Linux支持将在后续版本中添加)
Java 版本 >= 11 (此需求来源于RainyBot默认集成的Mirai协议后端,核心无需任何运行环境)
可选:支持Vulkan渲染器的图形卡 (可通过硬件加速提升性能)
配置与使用
- 从GitHub发布页下载最新的发布版本: https://github.com/Xwdit/RainyBot-Core/releases
- 运行RainyBot,随后按照控制台显示的说明,打开指定的配置文件进行配置
- 配置完毕后请重新启动RainyBot。此时若配置正确,将自动开始加载内置的协议后端(当前版本内置了Mirai协议库)
- 请留意 协议后端 的控制台信息,可能会要求您进行登陆验证等操作,您可以从以下链接获取相关帮助: https://mirai.mamoe.net/topic/223/无法登录的临时处理方案
- 若一切顺利,协议后端的控制台中将出现中文或英文的登录成功/加载成功字样,且RainyBot控制台中将出现加载成功字样
- 此时起可最小化协议后端的控制台窗口,后续操作均只需在RainyBot控制台中进行即可。从此处开始,将直接使用“控制台”来表示RainyBot的控制台界面
- 在控制台中输入指令
help
(或/help
)来查看所有可用的控制台指令,如输入plugins
可查看插件管理相关指令 - 恭喜!您成功完成了RainyBot的基本配置,开始尽情使用吧~
插件示例
当前的发布版本中随附了三个示例插件,分别为:聊天机器人,随机动漫音乐/图片,简易群管插件。您可以在
plugins
文件夹下找到它们,并使用plugins edit
指令来使用内置编辑器对其进行编辑。
同时,对于使用plugins create
指令新建的插件,将自动使用内置的插件模板,以便于您快速开始开发流程。若需查看更详细的已分类API文档与插件示例,请访问 RainyBot-API 储存库
功能开发路线图
- 核心功能完备
- 整理并将项目开源
- 实现插件编辑器的自动补全
- 添加版本检测与更新功能
- 添加在线插件市场功能
对于更详细的功能计划,已知问题或功能建议,请访问储存库的 Issues 页面
联系信息
交流QQ群: 429787496
更多信息
此处提供了一些可能与本项目有关,或对您有帮助的信息