Cobblemon Auto-Battle

This repository is the NeoForge 1.21.1 port of viniciusmorenorogato-crypto/CobblemonAutoBattle v1.4.0. The original author and MIT copyright notice are retained.

Pokémon Scarlet/Violet "Let's Go" style auto-battles for Cobblemon.

Send out your Pokémon, press a key, and watch them hunt nearby wild Pokémon on their own — earning XP, EVs and item drops for you, just like the Let's Go mechanic from Pokémon SV. Or aim at a specific wild Pokémon and send your partner after that exact one.

Features

• One-key auto-battle — press R (rebindable) to toggle. If no Pokémon is out, your lead is sent out automatically.
• Directed hunts — aim at a wild Pokémon and press V (rebindable): the nearest hunter goes after that one. Works even with auto-battle off — your lead pops out, completes the mission, and returns to its Poké Ball by itself.
• Multi-hunter — every Pokémon you have sent out hunts at the same time, each picking its own target (no two hunters gang up on the same wild).
• SV-style single-strike battles — one choreographed strike resolves each battle: attack animation wind-up → synchronized impact → the defeated wild plays its real faint animation and cries, then despawns.
• Real movesets matter — both sides pick their best actual move (real power, type and physical/special category, real STAB, full type chart). Speed decides who opens the exchange, and immunity abilities (Levitate, Flash Fire, Water/Volt Absorb, Sap Sipper...) cancel moves of their type.
• You can lose — if the simulation says the wild would knock your Pokémon out first, it loses the exchange: the wild counter-attacks, your Pokémon retreats hurt, and the wild survives. Type coverage in your movesets suddenly matters (configurable).
• Rare Pokémon protection — shinies, legendaries, mythicals, ultra beasts, paradox forms (plus any custom labels/species you configure) are never attacked. Instead you get a chat alert, a bell chime, and the rare glows for a few seconds so you can find it.
• Victory feedback — a short 3-note chime only you can hear (SV-style), the defeated species' cry, and quiet, pitch-varied hit sounds.
• Relaxed pacing — hunters rest in place for a few seconds after each victory instead of instantly sprinting to the next target.
• Smart navigation — target search is anchored to the player (configurable), with a leash that brings wandering hunters back (teleporting them if they fall far behind), stable path recalculation, and an anti-stuck system that gives up on unreachable targets.
• Real model animations — attackers play their model's physical/special animation; everything reuses Cobblemon's own posable animation system.
• Fair targeting — only wild Pokémon up to your Pokémon's level + a configurable margin are attacked; low-HP hunters retreat (they never faint from auto-battling).
• Rewards — XP and EVs (proper species EV yields) for the winner; item drops go straight to your inventory.
• Fully configurable & localized — 30+ options in config/autobattle.json, hot-reloadable in game. English and Português (Brasil); translations welcome!

Requirements

Install on the client (required for the keybinds). On servers, install on both sides.

Usage

Hunters retreat and sit out when their HP gets low, until recalled and sent out again. Rare/protected Pokémon are announced instead of attacked — both in area mode and when you aim at them directly.

Commands (permission level 2)

Configuration

config/autobattle.json is created on first launch and self-heals missing fields after updates.

Targeting & navigation

Rare protection

Battle

Effects, sounds & rewards

How it works (technical)

• Server-side brain on NeoForge ServerTickEvent.Post; the client only registers keybinds and sends toggle/hunt packets. Directed hunts raycast server-side (no trusting client entity IDs).
• Battles resolve in a single strike: a lightweight simulation picks each side's best real move (power/type/category from the actual moveset, real STAB, full type chart, ability immunities), factors Speed into who opens the exchange, and computes how many "rounds" the fight would take — charging the hunter proportional HP, or handing it the loss when the wild would win first. No real PokemonBattle is instantiated, so dozens of hunters stay cheap.
• Animations reuse Cobblemon's posable animation packets — the same mechanism official battles use for recoil — plus the species' real faint animation and cry on defeat.
• Rewards go through Cobblemon's own APIs (addExperienceWithPlayer, EV yields, species drop tables) with sidemod-tagged sources, so other mods' event hooks keep working.
• Rare detection uses Cobblemon's official species labels, so datapacks and other mods that label their species are protected automatically.