Changelog
3.1.9
Changed
- Gym leaders' saved teams keep the owner's friendship, hyper-trained IVs, tera type, Gigantamax factor, Dynamax level, alpha status, Poké Ball and PP Ups. Teams saved before keep working and pick these up the next time they are saved. Templates can set the same fields.
- Radical Cobblemon Trainers templates bring their battle format, bag items and item limit:
RCT's
battleFormat,bagandbattleRules.maxItemUseswere ignored, so doubles trainers (Boss Giovanni, Champion Jax and 48 more) fought in singles, trainers never used items, and challengers had no item limit against them. A template can now also set an exact limit withmax_item_uses; the limit applies to both sides, as in RCT. - Trainer templates are checked against Cobblemon when they load: one with an unknown species,
form, move, tera type or Poké Ball is rejected and listed in
/trainer migration report, instead of failing every battle. On NeoForge, templates now load after server start and after/reload, as on Fabric.
Fixed
-
Battles that end in a draw no longer award experience and EVs twice. Settling the draw ended the battle once, and the draw itself ended it again.
-
A trainer battle stopped by a battle error,
/stopbattleor a disconnect now settles like a flee: the trainer despawns and the spawner can be challenged again. Before, the trainer stayed standing until a reset. -
A gym win counts toward the gym and awards League Points even if the gym controller's chunk had unloaded, for example after the player teleported away mid-battle.
-
Trainers no longer spend their turn on a Potion or Full Restore after a scratch. Cobblemon allows a heal whenever HP is below full, so a trainer with bag items healed after every hit instead of attacking. HP items now wait for half health or below (a Full Restore also when the Pokémon is hurt and has a status); Ethers and Elixirs wait until a move is down to a quarter of its PP.
-
Trainers use configured Revival Herbs on a fainted team member. Before, a Revival Herb was never used.
-
A doubles gym whose saved team has only one Pokémon now refuses the challenge with the reason. Before, the battle started with an empty trainer slot and ended in a battle error.
-
A player who died, changed dimension or logged out could end another player's battle with the same trainer, if the first player's own battle with it had ended in a battle error. Cleanup after such a battle now also finds the trainer when the player has changed dimension or the spawner's chunk had unloaded.
-
Disconnecting from a trainer battle that had lasted over ten minutes could leave the trainer standing and its spawner occupied.
-
Gym leaders saved from a minted Pokémon keep the minted nature.
-
Template moves and abilities written with a namespace or separators (
cobblemon:thunderbolt,rough_skin), as the wiki documents, now work. Before, such a move stopped every battle with that trainer, and such an ability was replaced by a random one. An unknown ability is now logged.
3.1.8
Fixed
- Doubles trainer battles no longer end in "A battle error has occurred" after one of the trainer's Pokémon faints. The trainer tried to use a configured item on the turn it had to send in a replacement, and Cobblemon rejected the whole choice.
- Trainers now use configured Potions, status cures, Ethers, Elixirs and Revives. Only X items, Dire Hit, Guard Spec and Moomoo Milk worked before; the rest were skipped. A Revive targets a fainted team member, and an Ether restores the move missing the most PP.
- Battles that end in a draw (Endless Battle Clause, or Showdown's 1000-turn limit) now end. Before, the battle screen stayed open with no way out until you logged out. A draw is neutral: no League Points and no loss, and the trainer can be challenged again.
- Evasion Clause now also bans Sand Veil, Snow Cloak, Bright Powder and Lax Incense, as Showdown defines it. Before, it only checked Double Team and Minimize. The trainer's team is checked as built for the battle, so a template whose ability is left unset can roll a banned ability; that challenge is refused with the reason.
- Species Clause counts every form of a Pokémon as the same species (two Rotom forms are a duplicate) on the challenger's side too.
- Trainers keep their regional and alternate forms.
- A gym leader saved with an Alolan Vulpix, Rotom-Wash or another non-standard form fielded a random Pokémon in every battle. It now fields the saved form.
- Templates with form aspects (
alolan,galarian,hisuian,therian,rapid_strike,east_seaand the like, including RCT trainers) fielded the base form. They now field the authored form, as under RCT, so some trainers are tougher than in 3.x so far. - An unknown species no longer becomes a random Pokémon: the battle does not start, and the reason is logged.
- The team preview names forms, e.g. "Vulpix Alola".
Changed
- New saves of a gym leader's team store the base species with the form in its aspects. Older saves keep working unchanged.
- The handbook, wiki and clause tooltips describe the full Evasion and Species Clauses and draws.
3.1.7
Fixed
- Trainer battles no longer get stuck when Show team preview is on. The setting also turned on Showdown's Team Preview rule, which Cobblemon does not support. Showdown then moved each side's last Pokémon to the front, so battles opened with the wrong lead, and switches targeted the wrong Pokémon or failed with an error that left the battle screen without options. The setting now only controls whether challengers can see the trainer's team on the gym rules screen.
Changed
- With Show team preview on, right-clicking a gym trainer opens the rules screen with the trainer's team instead of starting the battle; Challenge starts it. This applies to every managed spawner type, and owners can now see what challengers see. With the setting off, a click still starts the battle at once. No network change: 3.1.6 clients and servers stay compatible.
- The handbook and wiki describe team preview, and the wiki notes that a trainer template's
team_previewfield currently has no visible effect.
3.1.6
Fixed
- Trainer templates from Radical Cobblemon Trainers 0.19.2 install again. One invalid resource no longer rejects the whole reload: each invalid template is skipped and logged, and the rest install. RCT's list-form held items, repeated moves and over-limit EVs in legacy rosters are handled the way RCT handles them.
Testing
- The Fabric production linkage check now also validates every mixin, including client-only ones a dedicated server never applies. It checks each mixin's targets, its refmap entries, unmapped Minecraft selectors, and its handler bodies. Both production gates also run against Cobblemon 1.8.1, the newest release.
3.1.5
Fixed
- Fabric no longer crashes the server (
AbstractMethodErrorinNativeTrainerBattleService.isCurrentGymTrainer) when a player starts a trainer battle.TrainerEntityRef.isRemoved()/discard()shared names with vanillafinalmethods, so production Fabric (intermediary names) left them without an implementation. They are nowisEntityRemoved()/discardEntity(). - Same defect in the Gym Linker and controller-link paths: the gym block entities inherited
getBlockPos()/getLevel()/setChanged()forControllerLinkableandGymLinkerInteractablefrom vanilla, so linking gym blocks on production Fabric would crash the same way. Each block entity now redeclares them so the remapper renames the interfaces to match. - Affected Fabric since at least 3.0; NeoForge was unaffected. Added a unit test that rejects any mod interface method satisfied only by an inherited vanilla method, since dev and GameTest runs use Mojang names on both loaders and cannot catch this.
Testing
- Dev and GameTest runs use Mojang names on both loaders, which is why both 3.1.x Fabric crashes
shipped. Builds now statically link-check the shipped Fabric jar, including the nested Brecher
Core, against production (intermediary) Minecraft and dependencies.
gameTestandreleasealso run the GameTest suite with that jar on a production Fabric server, against Cobblemon 1.8.0 and 1.8.2. Against the released 3.1.3 and 3.1.4 jars these gates reproduce both crashes.
3.1.4
Fixed
- Fabric no longer crashes at startup ("Critical injection failure" in
LegacyItemConditionWrapperAdapterMixin). The mixin's target descriptor names a Minecraft class but was markedremap = false, so production Fabric (intermediary names) never matched it. Affected every Fabric install of 3.1.1 through 3.1.3; NeoForge was unaffected. - Added a unit test that rejects unremapped mixins naming Minecraft types, since dev and GameTest runs use Mojang names on both loaders and cannot catch this.
3.1.3
Compatibility
- Qualified Fabric and NeoForge against Cobblemon's 1.8.2 snapshot while retaining the 1.8.0
compile baseline. Both manifests now explicitly accept Cobblemon
[1.8.0,1.9.0). - Updated the Core dependency and both bundled Core jars to Brecher Core 0.4.3.
3.1.2
Compatibility
- Qualified both loaders on Cobblemon 1.8.1. The build still compiles against the 1.8.0 API and runs development, GameTest, and live-test processes on 1.8.1. The 1.8.2 snapshot changes no API this mod consumes.
- Both loader manifests now declare Cobblemon 1.8.0 as the minimum (previously 1.7.0, which predates the verified mixin targets).
- NeoForge now declares Kotlin for Forge 5.10 or newer, which Cobblemon 1.8.1 requires.
Changed
- Brecher Core 0.4.2 is now nested inside both loader jars (NeoForge negotiated JarJar in the
0.4.xrange, Fabricinclude), completing the packaging that 3.1.1's README and manifests already described. Core remains declared as a required dependency so an incompatible external copy is still reported.
3.1.1
Compatibility
- Updated to Cobblemon 1.8.0 and Brecher Core 0.4.2 on Minecraft 1.21.1.
3.1.0
Breaking changes
- BrecherCore 0.4.1 is now a required, separately installed mod on both clients and servers. It is declared in both loader manifests and is not bundled inside the Brecher Trainers jars.
- Raised the network protocol from 9 to 10 for synchronized badge definitions,
badge ledgers, and Gym Controller badge configuration. Linked PlayerSync
backends must be upgraded in lockstep: an older backend will silently discard
the new
EarnedBadgesplayer attachment field when it round-trips player data.
Added
- Migrated the production Trainer screens and menus to BrecherCore's declarative UI framework with shared responsive layouts on Fabric and NeoForge.
- Extensible physical gym badges with datapack definitions, resource-pack models, per-gym assignment and operator-bumpable generations, offline completion snapshots, an earned-badge gallery, and operator reissue commands.
3.0.0
Breaking changes
- Raised the network protocol from 6 to 9. Mixed-version clients and servers are rejected during configuration.
- Replaced whole-registry Badge Box synchronization with request-correlated, server-filtered and sorted pages of 50 entries (hard maximum 100).
- Removed the RCT and RCT API runtime dependencies, integrations, mixins, and
manifest requirements. Trainers now use the first-party
BrecherTrainerEntityand native Cobblemon battle actor. - Active gym sessions always settle before player data is saved at logout. The
former resume-after-relog behavior and
settle_sessions_on_logoutsetting are retired.
Added
STANDALONE,PROXY_AUTHORITY, andPROXY_SATELLITEdeployment modes with authority-only mutation and teleport enforcement.- League configuration schema 2, immutable installed snapshots, atomic reload, validation diagnostics, migration backups, and future-schema rejection.
- Tier catalog schema/hash persistence and proxy-login rejection when transferred player data was created against a different catalog.
- Native versioned trainer templates, standalone legacy JSON/NBT conversion,
migration backups, and
/trainer migration report. - Canonical gym metrics shared by ranking, rewards, commands, and screens.
- Bounded packet codecs: 4,096 cooldowns, 256 shop trades, and 2,048 purchase history records.
- Public Badge Box snapshots no longer disclose exact controller or anchor locations; teleport destinations remain server-authoritative.
- Fabric play payloads preserve connection ordering, and its protocol gate uses a race-free monotonic reply timeout.
- Challenge and reward-dispenser requests have replay bounds; controller unlink no longer force-loads linked child chunks.
- Deployment role, configuration schema, catalog identity/hash, and authority
status in
/league info.
Migration
- Unversioned league configuration migrates to schema 2 with a sidecar backup.
- Existing gym identity, classification, ownership, location, operational state, metrics, and creator rewards migrate idempotently into canonical registry records. Controller block entities retain only live spatial configuration, links, and presentation state.
- Legacy RCT-shaped trainer resources and spawner NBT are translated without linking third-party classes. The legacy spawner payload is retained through the first successful native save.
See the 3.0 upgrade guide before starting a tracked world.