基于 Spring Boot 4.x + Kotlin 的 OneBot 热插拔插件化机器人框架

快速开始 • 模块结构 • 插件开发 • Wiki

Stars

基于 Spring Boot 4.x + Kotlin + Shiro 的 OneBot 热插拔插件化机器人框架。核心提供插件加载、事件总线、共享数据库、Bot 桥接等基础设施，业务功能以独立 Gradle Composite Build 插件形式注入，支持运行时热插拔。

快速开始

环境要求： JDK 21、Gradle Wrapper（仓库自带）

# 构建核心 + 全部插件
./gradlew buildAll

# 前台运行
java -jar stars-core/build/libs/stars-core-*.jar

# 后台运行（在部署目录准备 .env 和 stars-core-*.jar）
sh ./start-stars-core.sh start

# 查看状态
sh ./start-stars-core.sh status

# 停止
sh ./start-stars-core.sh stop

# 重启
sh ./start-stars-core.sh restart

主进程监听 8080 端口，在 /ws/shiro 暴露 OneBot WebSocket 服务端。

详细构建、配置、插件开发说明见 Wiki。

模块结构

模块	说明
stars-plugin-api	插件 SDK，以 compileOnly 方式引用
stars-core	主程序，负责插件加载、事件总线、Bot 托管
plugin/ 子目录	各业务插件（Gradle Composite Build，自动扫描加载）

插件开发

在 plugin/<YourPlugin>/ 下创建独立 Gradle build，框架自动扫描，无需修改根项目配置。

完整步骤见 Wiki · 插件开发指南。

❤️ Sponsor

Want to appear here?

Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. Register using this link to get started.

License

本项目采用 MIT License。

MIT 是一种宽松的开源许可证，核心含义是：

• 允许任何人自由使用、复制、修改、合并、发布、分发、再许可和商业使用本项目代码。
• 允许将修改后的代码用于闭源或商业项目，不要求你的衍生项目继续开源。
• 唯一主要义务是：在软件副本或重要部分中保留原始版权声明和许可证文本。
• 本项目按“原样”提供，作者不提供任何明示或默示担保，也不对使用过程中产生的损失或责任负责。