野性对战API

开发者用法

受支持的公共 API

仅使用这些类进行第三方集成：

• com.github.raguto.wildbattleapi.api.WildBattleAPI
• com.github.raguto.wildbattleapi.api.WildAIProvider
• com.github.raguto.wildbattleapi.api.WildAIContext

不要依赖诸如 impl、mixin、config 或 network 等内部包。

运行时依赖

在任何您的依赖模组加载的地方安装野性对战 API。在普通的整合包中，这意味着客户端和服务端都需要安装。

模组 ID：

• wild_battle_api

同时在您的模组元数据中将其声明为依赖。

Fabric (fabric.mod.json)：

{
  "depends": {
    "wild_battle_api": "*"
  }
}

NeoForge (META-INF/neoforge.mods.toml)：

[[dependencies.your_mod_id]]
modId = "wild_battle_api"
type = "required"
versionRange = "[1.0.0,)"
ordering = "AFTER"
side = "BOTH"

将最低版本调整为您的模组支持的第一个野性对战 API 版本。

编译时依赖

如果您没有使用已发布的 Maven 构件，请直接针对特定加载器的 jar 文件进行编译。

Fabric 示例：

dependencies {
    modCompileOnly files("libs/wild_battle_api-fabric-1.0.0.jar")
}

NeoForge 示例：

dependencies {
    compileOnly files("libs/wild_battle_api-neoforge-1.0.0.jar")
}

为您的环境使用适合的加载器 jar 文件。

注册提供者

在您的模组的通用初始化期间注册一次您的提供者。

import com.github.raguto.wildbattleapi.api.WildBattleAPI;
import com.github.raguto.wildbattleapi.api.WildAIContext;

public final class MyWildAIRegistration {
    public static void init() {
        WildBattleAPI.registerProvider(150, context -> {
            if (shouldUseMyAI(context)) {
                return new MyCustomWildBattleAI();
            }
            return null;
        });
    }

    private static boolean shouldUseMyAI(WildAIContext context) {
        return context.getBattle() != null && context.getActor() != null;
    }
}

您也可以使用默认优先级注册：

WildBattleAPI.registerProvider(context -> null);

优先级指导

• 0：兜底或默认提供者
• 50：标准覆盖
• 100+：高优先级或 Boss 特定覆盖
• 200+：硬覆盖，请谨慎使用

如果您的提供者只处理特定情况，请为其他所有情况返回 null。

实现您自己的 BattleAI

您可以提供任何实现 Cobblemon 的 BattleAI 的类。

import com.cobblemon.mod.common.api.battles.model.PokemonBattle;
import com.cobblemon.mod.common.api.battles.model.ai.BattleAI;
import com.cobblemon.mod.common.battles.ActiveBattlePokemon;
import com.cobblemon.mod.common.battles.BattleSide;
import com.cobblemon.mod.common.battles.PassActionResponse;
import com.cobblemon.mod.common.battles.ShowdownActionResponse;
import com.cobblemon.mod.common.battles.ShowdownMoveset;
import com.cobblemon.mod.common.net.messages.client.battle.BattleHealthChangePacket;
import org.jetbrains.annotations.Nullable;

public final class MyCustomWildBattleAI implements BattleAI {
    @Override
    public ShowdownActionResponse choose(
        ActiveBattlePokemon activeBattlePokemon,
        PokemonBattle battle,
        BattleSide side,
        @Nullable ShowdownMoveset moveset,
        boolean forceSwitch
    ) {
        if (forceSwitch || moveset == null) {
            return PassActionResponse.INSTANCE;
        }

        // 用您自己的招式或换人逻辑替换此处。
        return PassActionResponse.INSTANCE;
    }

    @Override
    public void onHealthChange(BattleHealthChangePacket packet) {
        // 可选的状态跟踪。
    }
}

WildAIContext

WildAIContext 为提供者提供决定是否声明野性对战参与者所需的信息。

始终可用：

• getActor()
• getPokemonList()
• getBattle()
• isForceSwitch()

根据当前决策可能为空：

• getActiveBattlePokemon()
• getAiSide()
• getMoveset()

在使用可空字段之前请进行判空保护。

集成说明

• 保持提供者逻辑快速且可预测。
• 当您的模组不希望声明当前上下文时返回 null。
• 避免从提供者或 AI 逻辑中抛出异常。
• 在专用服务器和集成单人游戏中进行测试。
• 如果多个模组注册了提供者，则数值较高优先级会首先被检查。