鹊桥
首页
介绍
部署
配置文件
命令
  • V2 事件
  • V1 事件
  • V2 API
  • V1 API
常见问题
  • 标准开发
  • 快速开发
对接
GitHub
首页
介绍
部署
配置文件
命令
  • V2 事件
  • V1 事件
  • V2 API
  • V1 API
常见问题
  • 标准开发
  • 快速开发
对接
GitHub
  • 快速开发
  • 主类编写
  • 事件监听
  • utils

    • 工具包
  • handle

    • 平台上下文实现
    • 命令执行上下文
  • 命令

事件监听

版本提示

适用于 QueQiao Core 0.7.0-beta.4 及以上版本。

监听服务端事件,转换为 core 事件模型后交给运行时分发。

处理流程

  1. 判断事件是否被取消、配置项是否启用了该事件。
  2. 通过 PlatformContext#getPlayerModel 获取玩家模型。
  3. 构造对应的 core 事件(PlayerChatEvent、PlayerJoinEvent 等)。
  4. 调用 runtime.sendEvent(event)。

配置读取

QueQiaoRuntime runtime = context.getRuntime();
if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_CHAT)) return;

订阅开关统一位于 ConfigKeys.SubscribeEvent:PLAYER_CHAT、PLAYER_DEATH、PLAYER_JOIN、PLAYER_QUIT、PLAYER_COMMAND、PLAYER_ADVANCEMENT。

延迟获取上下文

事件监听器通常在服务端启动前注册,此时运行时还不存在,因此使用 Supplier<PlatformContext>:

public class EventProcessor {
    private final Supplier<PlatformContext> contextSupplier;

    public EventProcessor(Supplier<PlatformContext> contextSupplier) {
        this.contextSupplier = contextSupplier;
    }

    private PlatformContext currentContext() {
        PlatformContext context = contextSupplier.get();
        if (context == null || context.getRuntime() == null) return null;
        return context;
    }
}

参考

点击展开
package com.github.theword.queqiao;

import com.github.theword.queqiao.utils.ForgeTool;
import io.github.theword.queqiao.core.config.ConfigKeys;
import io.github.theword.queqiao.core.event.PlayerAchievementEvent;
import io.github.theword.queqiao.core.event.PlayerChatEvent;
import io.github.theword.queqiao.core.event.PlayerCommandEvent;
import io.github.theword.queqiao.core.event.PlayerDeathEvent;
import io.github.theword.queqiao.core.event.PlayerJoinEvent;
import io.github.theword.queqiao.core.event.PlayerQuitEvent;
import io.github.theword.queqiao.core.event.model.PlayerModel;
import io.github.theword.queqiao.core.event.model.TranslateModel;
import io.github.theword.queqiao.core.event.model.achievement.AchievementModel;
import io.github.theword.queqiao.core.runtime.QueQiaoRuntime;
import net.minecraft.advancements.Advancement;
import net.minecraft.entity.player.EntityPlayerMP;
import net.minecraft.util.text.ITextComponent;
import net.minecraftforge.event.CommandEvent;
import net.minecraftforge.event.ServerChatEvent;
import net.minecraftforge.event.entity.living.LivingDeathEvent;
import net.minecraftforge.event.entity.player.AdvancementEvent;
import net.minecraftforge.fml.common.eventhandler.SubscribeEvent;
import net.minecraftforge.fml.common.gameevent.PlayerEvent;

import java.util.function.Supplier;

public class EventProcessor {

    private final Supplier<PlatformContext> contextSupplier;

    public EventProcessor(Supplier<PlatformContext> contextSupplier) {
        this.contextSupplier = contextSupplier;
    }

    @SubscribeEvent
    public void onServerChat(ServerChatEvent event) {
        PlatformContext context = currentContext();
        if (context == null || event.isCanceled()) return;

        QueQiaoRuntime runtime = context.getRuntime();
        if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_CHAT)) return;

        PlayerModel player = context.getPlayerModel(event.getPlayer());
        String rawMessage = ITextComponent.Serializer.componentToJson(event.getComponent());

        runtime.sendEvent(new PlayerChatEvent(player, "", rawMessage, event.getMessage()));
    }

    @SubscribeEvent
    public void onPlayerJoin(PlayerEvent.PlayerLoggedInEvent event) {
        PlatformContext context = currentContext();
        if (context == null || event.isCanceled()) return;

        QueQiaoRuntime runtime = context.getRuntime();
        if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_JOIN)) return;

        PlayerModel player = context.getPlayerModel((EntityPlayerMP) event.player);
        runtime.sendEvent(new PlayerJoinEvent(player));
    }

    @SubscribeEvent
    public void onPlayerQuit(PlayerEvent.PlayerLoggedOutEvent event) {
        PlatformContext context = currentContext();
        if (context == null || event.isCanceled()) return;

        QueQiaoRuntime runtime = context.getRuntime();
        if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_QUIT)) return;

        PlayerModel player = context.getPlayerModel((EntityPlayerMP) event.player);
        runtime.sendEvent(new PlayerQuitEvent(player));
    }

    @SubscribeEvent
    public void onPlayerCommand(CommandEvent event) {
        PlatformContext context = currentContext();
        if (context == null || event.isCanceled()) return;

        QueQiaoRuntime runtime = context.getRuntime();
        if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_COMMAND)) return;
        if (!(event.getSender() instanceof EntityPlayerMP)) return;

        StringBuilder commandString = new StringBuilder(event.getCommand().getName());
        for (String parameter : event.getParameters()) {
            commandString.append(" ").append(parameter);
        }

        String command = runtime.utils.isIgnoredCommand(commandString.toString());
        if (command.isEmpty()) return;

        PlayerModel player = context.getPlayerModel((EntityPlayerMP) event.getSender());
        runtime.sendEvent(new PlayerCommandEvent(player, "", command, command));
    }

    @SubscribeEvent
    public void onPlayerDeath(LivingDeathEvent event) {
        PlatformContext context = currentContext();
        if (context == null || event.isCanceled()) return;

        QueQiaoRuntime runtime = context.getRuntime();
        if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_DEATH)) return;
        if (!(event.getEntity() instanceof EntityPlayerMP)) return;

        PlayerModel player = context.getPlayerModel((EntityPlayerMP) event.getEntity());
        ITextComponent deathMessage = event.getEntityLiving().getCombatTracker().getDeathMessage();
        TranslateModel translateModel = context.parseTranslateModel(deathMessage);

        runtime.sendEvent(new PlayerDeathEvent(player, translateModel));
    }

    @SubscribeEvent
    public void onPlayerAdvancement(AdvancementEvent event) {
        PlatformContext context = currentContext();
        if (context == null) return;

        QueQiaoRuntime runtime = context.getRuntime();
        if (!runtime.getConfig().get(ConfigKeys.SubscribeEvent.PLAYER_ADVANCEMENT)) return;

        Advancement advancement = event.getAdvancement();
        if (advancement.getDisplay() == null || !advancement.getDisplay().shouldAnnounceToChat()) return;

        PlayerModel player = context.getPlayerModel((EntityPlayerMP) event.getEntityPlayer());
        AchievementModel achievementModel = ForgeTool.getForgeAchievement(context, player.getNickname(), advancement);

        runtime.sendEvent(new PlayerAchievementEvent(player, achievementModel));
    }

    private PlatformContext currentContext() {
        PlatformContext context = contextSupplier.get();
        if (context == null || context.getRuntime() == null) {
            return null;
        }
        return context;
    }
}

命令过滤

runtime.utils.isIgnoredCommand(...) 会按配置忽略登录/注册类命令,返回空字符串表示该命令不发送。

Edit this page
最近更新: 2026/11/16 10:35
Contributors: 17TheWord
Prev
主类编写