事件系统

事件（Event）是 Xinbot 插件系统的灵魂。通过监听不同的事件，你的插件可以对服务器内的各种变动作出反应。

1. 创建监听器

要监听事件，你需要创建一个实现 xin.bbtt.mcbot.event.Listener 接口的类。强烈建议使用 SLF4J Logger 来记录信息。

📄 源码参考

事件分发的核心实现位于 event/ 包（EventManager、EventHandler、EventPriority），全部内置事件类型位于 events/ 包。

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import xin.bbtt.mcbot.event.Listener;
import xin.bbtt.mcbot.event.EventHandler;
import xin.bbtt.mcbot.events.PublicChatEvent;

public class MyChatListener implements Listener {
    private static final Logger log = LoggerFactory.getLogger(MyChatListener.class);

    @EventHandler
    public void onPublicChat(PublicChatEvent event) {
        // 使用 log 而不是 System.out
        log.info("[聊天] {}: {}", event.getSender(), event.getMessage());
    }
}

---

2. 常用事件列表

事件名称	触发时机	常用方法
PublicChatEvent	收到公屏消息	getSender(), getMessage()
PrivateChatEvent	收到私聊（密语）	getSender(), getMessage()
SystemChatMessageEvent	收到系统消息	getContent(), getText(), isOverlay()
PlayerJoinEvent	玩家加入	getPlayerProfile()
PlayerLeaveEvent	玩家离开	getPlayerProfile()
ConnectEvent	已连接到服务器	-
DisconnectEvent	与服务器断开	getReason()
ServerChangeEvent	群组服内子服切换	getServer(), getCurrentServer()
LoginSuccessEvent	成功登录	-
ReceivePacketEvent	收到原始数据包	getPacket()

以上仅为常用事件。完整的内置事件类型见 events/ 包（共 20+ 种）。

---

3. 事件优先级 (Priority)

当多个插件监听同一事件时，执行顺序由优先级 (EventPriority)决定。Xinbot 共支持 6 个优先级：

1. LOWEST（最先） -> 2. LOW -> 3. NORMAL（默认） -> 4. HIGH -> 5. HIGHEST -> 6. MONITOR（最后，仅供只读监控）

例如，一个防脏话插件应该在 LOWEST 或 LOW 阶段拦截消息，而一个日志插件应该在 MONITOR 阶段只读记录。