Shiro

Shiro

QQ robot rapid development framework based on OneBot protocol

Documentation · Download · Quick Start · Contribute

Migration Guide

Starting from version v2 only JDK 17+ and SpringBoot 3.0.0+ are supported.

See the project documentation v2 migration guide for details.

QuickStart

Dependency introduction

When introducing dependencies, please replace version latest with the actual latest version from Maven Central

Maven

< dependency >
    < groupId >com.mikuac</ groupId >
    < artifactId >shiro</ artifactId >
    < version >latest</ version >
</ dependency >

Gradle Kotlin DSL

implementation( " com.mikuac:shiro:latest " )

Gradle Groovy DSL

implementation ' com.mikuac:shiro:latest ' 

Sample plugin

Annotation call

Write the application.yaml configuration file or refer to the advanced configuration file

 server :
  port : 5000 

 @ Shiro
@ Component
public class ExamplePlugin {
    // 更多用法详见 @MessageHandlerFilter 注解源码

    // 当机器人收到的私聊消息消息符合 cmd 值 "hi" 时，这个方法会被调用。
    @ PrivateMessageHandler
    @ MessageHandlerFilter ( cmd = "hi" )
    public void fun1 ( Bot bot , PrivateMessageEvent event , Matcher matcher ) {
        // 构建消息
        String sendMsg = MsgUtils . builder (). face ( 66 ). text ( "Hello, this is shiro demo." ). build ();
        // 发送私聊消息
        bot . sendPrivateMsg ( event . getUserId (), sendMsg , false );
    }

    // 如果 at 参数设定为 AtEnum.NEED 则只有 at 了机器人的消息会被响应
    @ GroupMessageHandler
    @ MessageHandlerFilter ( at = AtEnum . NEED )
    public void fun2 ( GroupMessageEvent event ) {
        // 以注解方式调用可以根据自己的需要来为方法设定参数
        // 例如群组消息可以传递 GroupMessageEvent, Bot, Matcher 多余的参数会被设定为 null
        System . out . println ( event . getMessage ());
    }

    // 同时监听群组及私聊消息 并根据消息类型（私聊，群聊）回复
    @ AnyMessageHandler
    @ MessageHandlerFilter ( cmd = "say hello" )
    public void fun3 ( Bot bot , AnyMessageEvent event ) {
        bot . sendMsg ( event , "hello" , false );
    }
}

Override parent class method

• Plug-ins written in annotation mode do not need to be defined in the plugin list plugin-list
• Add the following content to the server configuration file resources/application.yaml
• The plug-in list is executed sequentially. If the previous plug-in returns MESSAGE_BLOCK subsequent plug-ins will not be executed.

Write the application.yaml configuration file or refer to the advanced configuration file

 server :
  port : 5000
shiro :
  plugin-list :
    - com.example.bot.plugins.ExamplePlugin 

 @ Component
public class ExamplePlugin extends BotPlugin {

    @ Override
    public int onPrivateMessage ( Bot bot , PrivateMessageEvent event ) {
        if ( "hi" . equals ( event . getMessage ())) {
            // 构建消息
            String sendMsg = MsgUtils . builder ()
                    . face ( 66 )
                    . text ( "hello, this is shiro example plugin." )
                    . build ();
            // 发送私聊消息
            bot . sendPrivateMsg ( event . getUserId (), sendMsg , false );
        }
        // 返回 MESSAGE_IGNORE 执行 plugin-list 下一个插件，返回 MESSAGE_BLOCK 则不执行下一个插件
        return MESSAGE_IGNORE ;
    }

    @ Override
    public int onGroupMessage ( Bot bot , GroupMessageEvent event ) {
        if ( "hi" . equals ( event . getMessage ())) {
            // 构建消息
            String sendMsg = MsgUtils . builder ()
                    . at ( event . getUserId ())
                    . face ( 66 )
                    . text ( "hello, this is shiro example plugin." )
                    . build ();
            // 发送群消息
            bot . sendGroupMsg ( event . getGroupId (), sendMsg , false );
        }
        // 返回 MESSAGE_IGNORE 执行 plugin-list 下一个插件，返回 MESSAGE_BLOCK 则不执行下一个插件
        return MESSAGE_IGNORE ;
    }

}

Client

Shiro is developed using the OneBot-v11 standard protocol and is compatible with all OneBot protocol clients that support reverse WebSocket.

project	describe	Remark
LLOneBot	Make your NTQQ support OneBot11 protocol for QQ robot development
Lagrange.Core	NTQQ protocol implementation
go-cqhttp	OneBot Golang native implementation based on Mirai and MiraiGo	Stop maintenance
OpenShamrock	Implement OneBot standard robot framework based on Xposed

Contributors

See Contributing for details. Thanks to all the people who already contributed!

Credits

• OneBot
• pbbot-spring-boot-starter

License

This product is licensed under the GNU General Public License version 3. The license is as published by the Free Software Foundation published at https://www.gnu.org/licenses/gpl-3.0.html.

Alternatively, this product is licensed under the GNU Lesser General Public License version 3 for non-commercial use. The license is as published by the Free Software Foundation published at https://www.gnu.org/licenses/lgpl-3.0.html .

Feel free to contact us if you have any questions about licensing or want to use the library in a commercial closed source product.

Thanks

JetBrains offers free licenses to support open source projects.

Stargazers over time