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

更多信息

此处提供了一些可能与本项目有关,或对您有帮助的信息

GDScript语言教程 Godot类参考API Godot使用文档 Mirai-Api-Http文档