### Please consider supporting me on ko-fi if you like the mod and can afford it, I appreciate even 1 dollar. <\/p>\n
—
\n_**I grant permission to anyone seeking to add my mod to a modpack**_<\/p>\n
—
\n# Wild Battle API<\/p>\n
Wild Battle API is a shared wild battle AI framework for Cobblemon.<\/p>\n
For players and pack authors, it provides configurable smarter wild battle behavior with built-in presets and admin tools. For developers, it exposes a supported public API for registering custom wild `BattleAI` implementations without replacing Cobblemon internals directly.<\/p>\n
Wild Battle API installs a delegating AI on wild battle actors at battle start. On each AI decision:<\/p>\n
– Higher-priority providers are checked first.
\n– The first provider that returns a non-null `BattleAI` is used.
\n– Returning `null` defers to lower-priority providers.
\n– If no provider claims the context, the actor’s original Cobblemon AI is used as fallback.<\/p>\n
This lets multiple mods cooperate safely while keeping a reliable fallback path when no custom provider applies.<\/p>\n
## Included Features<\/p>\n
– Shared API for wild battle AI extensions
\n– Priority-based provider resolution
\n– Safe fallback to the actor’s original Cobblemon AI
\n– Built-in configurable smart wild AI behavior
\n– Difficulty presets from `easy` to `extreme`
\n– Admin UI and debug commands
\n– Fabric and NeoForge support for Minecraft `1.21.1`<\/p>\n
## Admin Commands<\/p>\n
Wild Battle API includes operator\/admin commands for testing and configuration.<\/p>\n
Commands: Aliases: These commands require permission level `2`.<\/p>\n ## Developer Usage<\/p>\n ### Supported Public API<\/p>\n Use only these classes for third-party integrations:<\/p>\n – `com.github.raguto.wildbattleapi.api.WildBattleAPI` Do not depend on internal packages such as `impl`, `mixin`, `config`, or `network`.<\/p>\n ### Runtime Dependency<\/p>\n Install Wild Battle API anywhere your dependent mod loads. In normal modpacks, that means both client and server.<\/p>\n Mod ID: Also declare it as a dependency in your mod metadata.<\/p>\n Fabric (`fabric.mod.json`):<\/p>\n “`json NeoForge (`META-INF\/neoforge.mods.toml`):<\/p>\n “`toml Adjust the minimum version to the first Wild Battle API version your mod supports.<\/p>\n ### Compile-Time Dependency<\/p>\n If you are not consuming a published Maven artifact, compile against the loader-specific jar directly.<\/p>\n Fabric example:<\/p>\n “`gradle NeoForge example:<\/p>\n “`gradle Use the loader-appropriate jar for your environment.<\/p>\n ### Registering a Provider<\/p>\n Register your provider once during your mod’s common initialization.<\/p>\n “`java public final class MyWildAIRegistration { private static boolean shouldUseMyAI(WildAIContext context) { You can also register at the default priority:<\/p>\n “`java ### Priority Guidance<\/p>\n – `0`: catch-all or default provider If your provider only handles specific cases, return `null` for everything else.<\/p>\n ### Implementing Your Own BattleAI<\/p>\n You may provide any class that implements Cobblemon’s `BattleAI`.<\/p>\n “`java public final class MyCustomWildBattleAI implements BattleAI { \/\/ Replace this with your own move or switch logic. @Override ### WildAIContext<\/p>\n `WildAIContext` gives providers the information needed to decide whether to claim a wild battle actor.<\/p>\n Always available: Nullable depending on the current decision: Guard nullable fields before using them.<\/p>\n ### Integration Notes<\/p>\n – Keep provider logic fast and predictable. ## Licensing<\/p>\n Wild Battle API code and binaries are All Rights Reserved.<\/p>\n Third-party usage and distribution permissions are defined by the author policy on the mod page.<\/p>\n","protected":false},"excerpt":{"rendered":" Shared wild battle AI API for Cobblemon.<\/p>\n","protected":false},"featured_media":170250,"template":"","meta":{"_minecraft_slug":"wild-battle-api","_minecraft_project_id":"v7VZE8kh","_minecraft_author":"Raguto","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":38683,"_minecraft_follows":5,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wild-battle-api.zip","_minecraft_size_bytes":2484991,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T12:48:45.430031Z","_minecraft_date_created":"2026-03-19T04:10:19.498425Z","_minecraft_date_modified":"2026-03-16T03:08:24.355845Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wild-battle-api","_minecraft_icon_attachment_id":170250,"_minecraft_imported_at":"2026-06-09T20:44:32+00:00","_minecraft_import_hash":"e9fe1311e34acc8479daf68010a72d63","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,158],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-170249","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-neoforge","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n
\n– `\/wildbattleapi ui`
\n– `\/wildbattleapi difficulty
\n– `\/wildbattleapi debug on`
\n– `\/wildbattleapi debug off`
\n– `\/wildbattleapi debug status`<\/p>\n
\n– `\/wba ui`
\n– `\/wba difficulty
\n– `\/wba debug on|off|status`<\/p>\n\nDeveloper Usage<\/summary>\n
\n– `com.github.raguto.wildbattleapi.api.WildAIProvider`
\n– `com.github.raguto.wildbattleapi.api.WildAIContext`<\/p>\n
\n– `wild_battle_api`<\/p>\n
\n{
\n “depends”: {
\n “wild_battle_api”: “*”
\n }
\n}
\n“`<\/p>\n
\n[[dependencies.your_mod_id]]
\nmodId = “wild_battle_api”
\ntype = “required”
\nversionRange = “[1.0.0,)”
\nordering = “AFTER”
\nside = “BOTH”
\n“`<\/p>\n
\ndependencies {
\n modCompileOnly files(“libs\/wild_battle_api-fabric-1.0.0.jar”)
\n}
\n“`<\/p>\n
\ndependencies {
\n compileOnly files(“libs\/wild_battle_api-neoforge-1.0.0.jar”)
\n}
\n“`<\/p>\n
\nimport com.github.raguto.wildbattleapi.api.WildBattleAPI;
\nimport com.github.raguto.wildbattleapi.api.WildAIContext;<\/p>\n
\n public static void init() {
\n WildBattleAPI.registerProvider(150, context -> {
\n if (shouldUseMyAI(context)) {
\n return new MyCustomWildBattleAI();
\n }
\n return null;
\n });
\n }<\/p>\n
\n return context.getBattle() != null && context.getActor() != null;
\n }
\n}
\n“`<\/p>\n
\nWildBattleAPI.registerProvider(context -> null);
\n“`<\/p>\n
\n– `50`: standard override
\n– `100+`: high-priority or boss-specific override
\n– `200+`: hard override, use carefully<\/p>\n
\nimport com.cobblemon.mod.common.api.battles.model.PokemonBattle;
\nimport com.cobblemon.mod.common.api.battles.model.ai.BattleAI;
\nimport com.cobblemon.mod.common.battles.ActiveBattlePokemon;
\nimport com.cobblemon.mod.common.battles.BattleSide;
\nimport com.cobblemon.mod.common.battles.PassActionResponse;
\nimport com.cobblemon.mod.common.battles.ShowdownActionResponse;
\nimport com.cobblemon.mod.common.battles.ShowdownMoveset;
\nimport com.cobblemon.mod.common.net.messages.client.battle.BattleHealthChangePacket;
\nimport org.jetbrains.annotations.Nullable;<\/p>\n
\n @Override
\n public ShowdownActionResponse choose(
\n ActiveBattlePokemon activeBattlePokemon,
\n PokemonBattle battle,
\n BattleSide side,
\n @Nullable ShowdownMoveset moveset,
\n boolean forceSwitch
\n ) {
\n if (forceSwitch || moveset == null) {
\n return PassActionResponse.INSTANCE;
\n }<\/p>\n
\n return PassActionResponse.INSTANCE;
\n }<\/p>\n
\n public void onHealthChange(BattleHealthChangePacket packet) {
\n \/\/ Optional state tracking.
\n }
\n}
\n“`<\/p>\n
\n– `getActor()`
\n– `getPokemonList()`
\n– `getBattle()`
\n– `isForceSwitch()`<\/p>\n
\n– `getActiveBattlePokemon()`
\n– `getAiSide()`
\n– `getMoveset()`<\/p>\n
\n– Return `null` when your mod does not want to claim the current context.
\n– Avoid throwing exceptions from provider or AI logic.
\n– Test in both dedicated server and integrated singleplayer.
\n– If multiple mods register providers, higher numeric priority is checked first.<\/p>\n<\/details>\n