llms.txt: machine-readable documentation index. Markdown version of this page is also available.

Simple Robot 5.x Help

第一次处理事件

本页通过一个本地测试事件,体验 simbot 的事件处理流程。完成后,程序会在控制台打印“收到测试事件”并退出。 这个例子无需平台账号。接入真实 Bot 时,再选择对应的组件并配置账号。

准备项目

准备一个使用 Gradle 的项目,JDK 版本为 11 或更高。本例使用 simbot 5.0.0-Alpha2 ,Kotlin 示例使用 Kotlin 2.4.21 。请选择需要使用的语言。

在 build.gradle.kts 中配置插件、仓库和依赖:

plugins { kotlin("jvm") version "2.4.21" application } repositories { mavenCentral() } dependencies { implementation("love.forte.simbot:simbot-core:5.0.0-Alpha2") // 本例借助测试模块构造事件 implementation("love.forte.simbot:simbot-test:5.0.0-Alpha2") } application { mainClass = "MainKt" }

MainKt 对应下面示例的文件名和无包名的顶层 main 函数。

plugins { java application } repositories { mavenCentral() } dependencies { implementation("love.forte.simbot:simbot-core-jvm:5.0.0-Alpha2") implementation("love.forte.simbot:simbot-test-jvm:5.0.0-Alpha2") } application { mainClass = "Main" }

响应式示例使用 Reactor,在上面的 dependencies 中添加标记的依赖:

dependencies { implementation("love.forte.simbot:simbot-core-jvm:5.0.0-Alpha2") implementation("love.forte.simbot:simbot-test-jvm:5.0.0-Alpha2") implementation("io.projectreactor:reactor-core:3.8.6") implementation("org.jetbrains.kotlinx:kotlinx-coroutines-reactor:1.11.0") }

如果你已经有项目,可以将依赖和 application 配置合并到现有构建脚本中。

编写并运行

创建 src/main/kotlin/Main.kt:

import kotlinx.coroutines.flow.collect import love.forte.simbot.application.listeners import love.forte.simbot.core.application.launchSimpleApplication import love.forte.simbot.event.process import love.forte.simbot.test.event.TestEvent suspend fun main() { val app = launchSimpleApplication() try { // 注册一个处理 TestEvent 的监听器 app.listeners { process<TestEvent> { println("收到测试事件") } } // 推送测试事件并收集处理结果 app.eventDispatcher.push(TestEvent()).collect() } finally { app.cancel() } }

创建 src/main/java/Main.java:

import love.forte.simbot.application.Applications; import love.forte.simbot.core.application.Simple; import love.forte.simbot.event.EventListeners; import love.forte.simbot.event.EventProcessors; import love.forte.simbot.event.EventResult; import love.forte.simbot.test.event.TestEvent; public class Main { public static void main(String[] args) { var app = Applications.launchApplicationBlocking(Simple.INSTANCE); try { app.getEventDispatcher().register(EventListeners.block(TestEvent.class, (context, event) -> { System.out.println("收到测试事件"); return EventResult.empty(); })); EventProcessors.pushAndCollectToListBlocking(app.getEventDispatcher(), new TestEvent()); } finally { app.cancel(); } } }
import love.forte.simbot.application.Applications; import love.forte.simbot.core.application.Simple; import love.forte.simbot.event.EventListeners; import love.forte.simbot.event.EventProcessors; import love.forte.simbot.event.EventResult; import love.forte.simbot.test.event.TestEvent; import java.util.concurrent.CompletableFuture; public class Main { public static void main(String[] args) { var app = Applications.launchApplicationBlocking(Simple.INSTANCE); try { app.getEventDispatcher().register(EventListeners.async(TestEvent.class, (context, event) -> { System.out.println("收到测试事件"); return CompletableFuture.completedFuture(EventResult.empty()); })); EventProcessors.pushAndCollectToListAsync(app.getEventDispatcher(), new TestEvent(), app).join(); } finally { app.cancel(); } } }
import love.forte.simbot.application.Applications; import love.forte.simbot.core.application.Simple; import love.forte.simbot.event.EventListeners; import love.forte.simbot.event.EventProcessors; import love.forte.simbot.event.EventResult; import love.forte.simbot.test.event.TestEvent; public class Main { public static void main(String[] args) { var app = Applications.launchApplicationBlocking(Simple.INSTANCE); try { app.getEventDispatcher().register(EventListeners.nonBlock(TestEvent.class, (context, event) -> { System.out.println("收到测试事件"); return EventResult.empty(); })); EventProcessors.pushAndAsFlux(app.getEventDispatcher(), new TestEvent()).blockLast(); } finally { app.cancel(); } } }

在项目目录运行 ./gradlew run ,Windows 可使用 gradlew.bat run 。如果项目没有 Gradle Wrapper,也可以使用已安装的 Gradle 执行 gradle run。

输出中应包含:

收到测试事件

如果还看到 SLF4J 没有日志实现的提示,示例仍可运行。项目需要输出日志时,可以按所用环境配置日志实现。

Application 持有事件调度器,监听器负责处理匹配的事件。Kotlin 的 push 返回 Flow ,在收集时执行。Java 示例分别展示阻塞、异步和响应式方式。两种示例结束时都调用 cancel() 关闭应用。 这里的 TestEvent 来自测试模块,实际接入平台时,事件由组件接收并推送。

下一步

  • 前往 选择组件库 选择并接入真实的平台 Bot,选择所需组件平台并跟随对应的快速开始完成依赖、账号和监听配置。

  • 在 Spring Boot 中开发?前往 使用 Spring Boot。

  • 使用 Java?前往 Java友好 ♥ 了解异步与响应式 API,再选择组件。

  • 想了解事件处理结果与异常?前往 事件监听与处理。

07 November 2026