ВЕРСИИ (94)

# Changelog ## [0.16.2-beta] - 2026-10-12 **Changed:** - *#136* Bump min required version of Cobblemon to `1.8.2` **Fixed:** - *#135* Crashes related to changes in some items in Cobblemon `1.8.2` (e.g. Iron Ball)

# Changelog ## [0.16.2-beta] - 2026-10-12 **Changed:** - *#136* Bump min required version of Cobblemon to `1.8.2` **Fixed:** - *#135* Crashes related to changes in some items in Cobblemon `1.8.2` (e.g. Iron Ball)

# Changelog ## [0.16.1-beta] - 2026-09-14 **Added:** - *#134* `GsonUtil`: Static helpers to create preconfigured *GSON* instances **Changed:** - *#133* Added very basic scripting support to `rct` battle AI. The configuration now has a new property, `battleScript`, a list of actions to perform in the provided order: - Available actions are: `move:<moveId>` (showdown move id, e.g. `tackle`), `switch:<position>` (`0` - `5`) and `item:<itemId>` (showdown item name, e.g. `potion` or `x_attack`) - If the `<type>:` prefix is ommitted a `<moveId>` is assumed - Targets are chosen based of the default AI evaluation - The AI will fallback to its usual behaviour if a scripted action was not possible (e.g. a pokemon does not have the selected move) or all scripted actions have been performed - There is no validation if an action succeeded (e.g. it is not possible to distinguish if a move hit or not) **Fixed:** - *#132* Battle softlocks caused by pokemon fainting on both sides

# Changelog ## [0.16.1-beta] - 2026-09-14 **Added:** - *#134* `GsonUtil`: Static helpers to create preconfigured *GSON* instances **Changed:** - *#133* Added very basic scripting support to `rct` battle AI. The configuration now has a new property, `battleScript`, a list of actions to perform in the provided order: - Available actions are: `move:<moveId>` (showdown move id, e.g. `tackle`), `switch:<position>` (`0` - `5`) and `item:<itemId>` (showdown item name, e.g. `potion` or `x_attack`) - If the `<type>:` prefix is ommitted a `<moveId>` is assumed - Targets are chosen based of the default AI evaluation - The AI will fallback to its usual behaviour if a scripted action was not possible (e.g. a pokemon does not have the selected move) or all scripted actions have been performed - There is no validation if an action succeeded (e.g. it is not possible to distinguish if a move hit or not) **Fixed:** - *#132* Battle softlocks caused by pokemon fainting on both sides

# Changelog ## [0.16.0-beta] - 2026-09-06 **Changed:** - *#131* Min required Cobblemon version to `1.8`

# Changelog ## [0.16.0-beta] - 2026-09-06 **Changed:** - *#131* Min required Cobblemon version to `1.8`

# Changelog As of version `0.15.0-beta`, RCTApi may only be redistributed under the terms of the [MCOML License](https://gitlab.com/srcmc/rct/api/-/raw/1.21.1/LICENSE.txt?ref_type=heads). ## [0.15.2-beta] - 2026-04-19 **Fixed:** - *#130* Battle error related to oversight in fix *#129* (*multi gimmick usage fix*)

# Changelog As of version `0.15.0-beta`, RCTApi may only be redistributed under the terms of the [MCOML License](https://gitlab.com/srcmc/rct/api/-/raw/1.21.1/LICENSE.txt?ref_type=heads). ## [0.15.2-beta] - 2026-04-19 **Fixed:** - *#130* Battle error related to oversight in fix *#129* (*multi gimmick usage fix*)

# Changelog As of version `0.15.0-beta`, RCTApi may only be redistributed under the terms of the [MCOML License](https://gitlab.com/srcmc/rct/api/-/raw/1.21.1/LICENSE.txt?ref_type=heads). ## [0.15.1-beta] - 2026-04-17 **Fixed:** - *#129* Trainers attempting to use multiple gimmicks at the same time, that are not permitted to be used together in one battle, if they have more than one pokemon on the field (e.g. mega + mega or zmove + zmove)

# Changelog As of version `0.15.0-beta`, RCTApi may only be redistributed under the terms of the [MCOML License](https://gitlab.com/srcmc/rct/api/-/raw/1.21.1/LICENSE.txt?ref_type=heads). ## [0.15.1-beta] - 2026-04-17 **Fixed:** - *#129* Trainers attempting to use multiple gimmicks at the same time, that are not permitted to be used together in one battle, if they have more than one pokemon on the field (e.g. mega + mega or zmove + zmove)

# Changelog As of version `0.15.0-beta`, RCTApi may only be redistributed under the terms of the [MCOML License](https://gitlab.com/srcmc/rct/api/-/raw/1.21.1/LICENSE.txt?ref_type=heads). ## [0.15.0-beta] - 2026-03-21 **Added:** - *#128* `BattleInstance`: Associates a `TrainerNPC` with a `PokemonBattle` and the `LivingEntity` it was attached to at the start of that battle - *#127* `TrainerNPC#getBattleInstances()`: Retrieves a list of all active `BattleInstance`s the trainer is attending to **Changed:** - *#126* Adjustments to the battle AI switch evaluation, which makes it less likely for trainers to switch into pokemon with much higher stats - *#125* Slight adjustment to battle AI to lower the chance to use (often waste) healing items on squishy pokemon on the field - *#124* Trainers may now attend to multiple battles at the same time - Note that a trainer **entity** can still only attend to one battle at a time (a copy of that entity can attend to a different battle) - The entity the trainer was attached to **at the start of a battle** is stored to ensure recall animations of pokemon will always point towards that entity - This was possible in an older version of the API (with unexpected side effects) but was never an intended feature, now it is - *#123* Trainers now support custom sound events. Use the `battleTheme` property to assign a custom resource location (falls back to `battle.pvn.default` if unset). Refer to [the docs](https://srcmc.gitlab.io/rct/docs/latest/configuration/resource_pack/battle_themes/) for more info **Fixed:** - *#122* Battle AI attempting to use baton pass when there is no pokemon to switch to and it will also avoid that move if the user has no stat buffs - *#121* Battle AI not including active shield effects (light screen/reflect) in some damage calculations - *#120* Battle AI not recognizing the weather effects "heavy rain", "extremely harsh sunlight" and "strong winds" (e.g. attempting to use fire or water moves when they would fail) - *#119* `BATTLE_STARTED` event receiving `null` instead of the `BattleState` as parameter **Removed:** - *#118* Deprecated overloads of `TypeChart#getEffectiveness()`

# Changelog As of version `0.15.0-beta`, RCTApi may only be redistributed under the terms of the [MCOML License](https://gitlab.com/srcmc/rct/api/-/raw/1.21.1/LICENSE.txt?ref_type=heads). ## [0.15.0-beta] - 2026-03-21 **Added:** - *#128* `BattleInstance`: Associates a `TrainerNPC` with a `PokemonBattle` and the `LivingEntity` it was attached to at the start of that battle - *#127* `TrainerNPC#getBattleInstances()`: Retrieves a list of all active `BattleInstance`s the trainer is attending to **Changed:** - *#126* Adjustments to the battle AI switch evaluation, which makes it less likely for trainers to switch into pokemon with much higher stats - *#125* Slight adjustment to battle AI to lower the chance to use (often waste) healing items on squishy pokemon on the field - *#124* Trainers may now attend to multiple battles at the same time - Note that a trainer **entity** can still only attend to one battle at a time (a copy of that entity can attend to a different battle) - The entity the trainer was attached to **at the start of a battle** is stored to ensure recall animations of pokemon will always point towards that entity - This was possible in an older version of the API (with unexpected side effects) but was never an intended feature, now it is - *#123* Trainers now support custom sound events. Use the `battleTheme` property to assign a custom resource location (falls back to `battle.pvn.default` if unset). Refer to [the docs](https://srcmc.gitlab.io/rct/docs/latest/configuration/resource_pack/battle_themes/) for more info **Fixed:** - *#122* Battle AI attempting to use baton pass when there is no pokemon to switch to and it will also avoid that move if the user has no stat buffs - *#121* Battle AI not including active shield effects (light screen/reflect) in some damage calculations - *#120* Battle AI not recognizing the weather effects "heavy rain", "extremely harsh sunlight" and "strong winds" (e.g. attempting to use fire or water moves when they would fail) - *#119* `BATTLE_STARTED` event receiving `null` instead of the `BattleState` as parameter **Removed:** - *#118* Deprecated overloads of `TypeChart#getEffectiveness()`

# Changelog ## [0.14.8-beta] - 2026-02-14 **Fixed:** - *#117* Oversight from previous change leading to trainer pokemon having *random* movesets

# Changelog ## [0.14.8-beta] - 2026-02-14 **Fixed:** - *#117* Oversight from previous change leading to trainer pokemon having *random* movesets

# Changelog ## [0.14.7-beta] - 2026-02-13 **Added:** - *#116* `Debug#setActive(int)` static method to configure active debug contexts (not recommended to activate in release builds) - *#115* `PokemonPropertiesModelConverter`: Convert `PokemonModel` to `PokemonProperties` (thanks Gito) **Changed:** - *#114* Adjusted semantics of `Debug` utility (now works with *contexts* instead of *levels*, combine with `|` for multiple) **Fixed:** - *#113* Battles getting stuck when trainers use Tatsugiris `Commander` ability with Dondozo - *#112* `PokemonModel(Pokemon)` constructor copying wrong properties

# Changelog ## [0.14.7-beta] - 2026-02-13 **Added:** - *#116* `Debug#setActive(int)` static method to configure active debug contexts (not recommended to activate in release builds) - *#115* `PokemonPropertiesModelConverter`: Convert `PokemonModel` to `PokemonProperties` (thanks Gito) **Changed:** - *#114* Adjusted semantics of `Debug` utility (now works with *contexts* instead of *levels*, combine with `|` for multiple) **Fixed:** - *#113* Battles getting stuck when trainers use Tatsugiris `Commander` ability with Dondozo - *#112* `PokemonModel(Pokemon)` constructor copying wrong properties

# Changelog ## [0.14.6-beta] - 2026-01-18 **Added:** - *#111* Added `BattleFormatProvider` (functional) interface **Changed:** - *#110* Changed return type of `BattleState#getFormat()` and `BattleContext#getFormat()` to `BattleFormatProvider` - *#109* The (rctapi) `BattleFormat` enum now implements `BattleFormatProvider` (method signature remains unchanged) - *#108* Updated `BattleRules` - Added `adjustNPCLevels` property: Decide if npc pokemon levels should be adjusted according to the `adjustLevel` value of the battle format (the default battle formats do not adjust levels) - Added `adjustPlayerLevels` property: Decide if player pokemon levels should be adjusted according to the `adjustLevel` value of the battle format (the default battle formats do not adjust levels) - Added `healPlayers` property: Decide if player pokemon should be healed at the start of a battle - *#107* `BattleManager#startBattle(...)` (and overloads) now accept a `BattleFormatProvider` instead of a (rctapi) `BattleFormat` as argument (old overloads still exist but are *deprecated*) - *#106* `BattleState` and `BattleContext` now accept a `BattleFormatProvider` in their constructors instead of a (rctapi) `BattleFormat` (old overloads still exist but are *deprecated*) **Fixed:** - *#105* Certain max moves of dynamaxed pokemon possibly causing battles to softlock - *#104* Tera type `stellar` leading to battle failures if evaluated defensively on the player side

# Changelog ## [0.14.6-beta] - 2026-01-18 **Added:** - *#111* Added `BattleFormatProvider` (functional) interface **Changed:** - *#110* Changed return type of `BattleState#getFormat()` and `BattleContext#getFormat()` to `BattleFormatProvider` - *#109* The (rctapi) `BattleFormat` enum now implements `BattleFormatProvider` (method signature remains unchanged) - *#108* Updated `BattleRules` - Added `adjustNPCLevels` property: Decide if npc pokemon levels should be adjusted according to the `adjustLevel` value of the battle format (the default battle formats do not adjust levels) - Added `adjustPlayerLevels` property: Decide if player pokemon levels should be adjusted according to the `adjustLevel` value of the battle format (the default battle formats do not adjust levels) - Added `healPlayers` property: Decide if player pokemon should be healed at the start of a battle - *#107* `BattleManager#startBattle(...)` (and overloads) now accept a `BattleFormatProvider` instead of a (rctapi) `BattleFormat` as argument (old overloads still exist but are *deprecated*) - *#106* `BattleState` and `BattleContext` now accept a `BattleFormatProvider` in their constructors instead of a (rctapi) `BattleFormat` (old overloads still exist but are *deprecated*) **Fixed:** - *#105* Certain max moves of dynamaxed pokemon possibly causing battles to softlock - *#104* Tera type `stellar` leading to battle failures if evaluated defensively on the player side

# Changelog ## [0.14.5-beta] - 2025-12-27 **Added:** - *#103* Added `BattleState#isPaticipating(Trainer)`: Reports if trainer is participating in the associated battle **Changed:** - *#102* Adjusted priority for gimmicks dynamax/gmax and tera (tera will now be chosen after the max transformation has ended if both are possible) - *#101* Changed default `RCTBattleAIConfig#switchBias` to `0.5` (value is now a bit more impactful, other biases will most likely get reworked in a similar manner) - *#100* Improved evaluation for a bunch of moves with certain requirements (e.g. `Ally Switch` or `Trick`) and other minor adjustments to move selection logic - *#99* Increased priority of some mixins (to avoid potential conflicts) - *#98* Reworked rct battle ai switch evaluation (might require some fine tuning) **Fixed:** - *#97* Battle AI attempting to use `First Impression` in arbitrary turns (should only be used in first turn) - *#96* Battle AI not avoiding sacrificial moves (e.g. `Explosion`) when on their last pokemon - *#95* Battle AI treating the user of the move `Block` as trapped, rather than the target - *#94* Duplicate error messages when failing to start a battle - *#93* `gimmicks` property of pokemon (tera, dynamax, gmax) not getting applied in battle

# Changelog ## [0.14.5-beta] - 2025-12-27 **Added:** - *#103* Added `BattleState#isPaticipating(Trainer)`: Reports if trainer is participating in the associated battle **Changed:** - *#102* Adjusted priority for gimmicks dynamax/gmax and tera (tera will now be chosen after the max transformation has ended if both are possible) - *#101* Changed default `RCTBattleAIConfig#switchBias` to `0.5` (value is now a bit more impactful, other biases will most likely get reworked in a similar manner) - *#100* Improved evaluation for a bunch of moves with certain requirements (e.g. `Ally Switch` or `Trick`) and other minor adjustments to move selection logic - *#99* Increased priority of some mixins (to avoid potential conflicts) - *#98* Reworked rct battle ai switch evaluation (might require some fine tuning) **Fixed:** - *#97* Battle AI attempting to use `First Impression` in arbitrary turns (should only be used in first turn) - *#96* Battle AI not avoiding sacrificial moves (e.g. `Explosion`) when on their last pokemon - *#95* Battle AI treating the user of the move `Block` as trapped, rather than the target - *#94* Duplicate error messages when failing to start a battle - *#93* `gimmicks` property of pokemon (tera, dynamax, gmax) not getting applied in battle

# Changelog ## [0.14.4-beta] - 2025-12-11 **Fixed:** - *#92* Workaround to avoid issue with the Cobblemon showdown interpreter leading to battle instructions getting executed in the wrong order (most commonly triggered by switched-in trainer pokemon getting immediately knocked out). This changes is restricted to battles started by rctapi. **Removed:** - *#91* Adhoc fix for issues related to pokemon switching positions (e.g. with "Ally Switch") as it has been fixed recently in Cobblemon itself

# Changelog ## [0.14.4-beta] - 2025-12-11 **Fixed:** - *#92* Workaround to avoid issue with the Cobblemon showdown interpreter leading to battle instructions getting executed in the wrong order (most commonly triggered by switched-in trainer pokemon getting immediately knocked out). This changes is restricted to battles started by rctapi. **Removed:** - *#91* Adhoc fix for issues related to pokemon switching positions (e.g. with "Ally Switch") as it has been fixed recently in Cobblemon itself

# Changelog ## [0.14.3-beta] - 2025-12-05 **Fixed:** - *#90* Battles tending to get softlocked when AI switches

# Changelog ## [0.14.3-beta] - 2025-12-05 **Fixed:** - *#90* Battles tending to get softlocked when AI switches

# Changelog ## [0.14.2-beta] - 2025-12-04 **Fixed:** - *#89* Different scenarios leading to battles getting softlocked

# Changelog ## [0.14.2-beta] - 2025-12-04 **Fixed:** - *#89* Different scenarios leading to battles getting softlocked

# Changelog ## [0.14.1-beta] - 2025-11-24 **Changed:** - *#88* Replaced `Pokemon#clone()` invocations with `Pokemon#copyFrom()` (this might have been the cause for some battle related issues)

# Changelog ## [0.14.1-beta] - 2025-11-24 **Changed:** - *#88* Replaced `Pokemon#clone()` invocations with `Pokemon#copyFrom()` (this might have been the cause for some battle related issues)

# Changelog ## [0.14.0-beta] - 2025-11-22 **Changed:** - *#87* Increased minimum required version of Cobblemon to `1.7` - *#86* Replaced some log errors with warnings

# Changelog ## [0.14.0-beta] - 2025-11-22 **Changed:** - *#87* Increased minimum required version of Cobblemon to `1.7` - *#86* Replaced some log errors with warnings

# Changelog ## [0.13.9-beta] - 2025-09-26 **Fixed:** - *#85* Conflict with *Cobblemon UI Tweaks*

# Changelog ## [0.13.9-beta] - 2025-09-26 **Fixed:** - *#85* Conflict with *Cobblemon UI Tweaks*

# Changelog ## [0.13.8-beta] - 2025-09-09 **Changed:** - *#84* Improved AI awareness of battle effects (like "Wish" being passed to a switched pokemon) **Fixed:** - *#83* Battle AI not taking all changes from transformed pokemon (ditto) into account, in some cases causing issues - *#82* Fixed dyna- and gmax failing for some status moves - *#81* Introduced *fixes* (mostly workarounds) to deal with various somewhat uncommon issues in battles (often resulting in softlocks or battles ending abruptly). For example: Pokemon fainting at the end of a turn on both sides (e.g. by moves like "Perish Song") and the player chosing a pokemon to switch very quickly. Note that these changes are mostly limited to battles started by this api for now (it is currently unclear if these kind of issues also occur in other types of battles like PvP).

# Changelog ## [0.13.8-beta] - 2025-09-09 **Changed:** - *#84* Improved AI awareness of battle effects (like "Wish" being passed to a switched pokemon) **Fixed:** - *#83* Battle AI not taking all changes from transformed pokemon (ditto) into account, in some cases causing issues - *#82* Fixed dyna- and gmax failing for some status moves - *#81* Introduced *fixes* (mostly workarounds) to deal with various somewhat uncommon issues in battles (often resulting in softlocks or battles ending abruptly). For example: Pokemon fainting at the end of a turn on both sides (e.g. by moves like "Perish Song") and the player chosing a pokemon to switch very quickly. Note that these changes are mostly limited to battles started by this api for now (it is currently unclear if these kind of issues also occur in other types of battles like PvP).

# Changelog ## [0.13.7-beta] - 2025-07-05 **Fixed:** - *#80* Issues with multiturn moves

# Changelog ## [0.13.7-beta] - 2025-07-05 **Fixed:** - *#80* Issues with multiturn moves

# Changelog ## [0.13.6-beta] - 2025-06-17 **Changed:** - *#79* Errors for invalid held items are now only logged for the last checked held item of a pokemon (in case multiple options have been configured)

# Changelog ## [0.13.6-beta] - 2025-06-17 **Changed:** - *#79* Errors for invalid held items are now only logged for the last checked held item of a pokemon (in case multiple options have been configured)

# Changelog ## [0.13.5-beta] - 2025-06-14 **Changed:** - *#78* Battle AI is now aware of hiddenpower types from pokemon - *#77* Battle AI is now aware of tera types from terastallized pokemon **Fixed:** - *#76* Some battle issues related to moves that force opponent pokemon to switch

# Changelog ## [0.13.5-beta] - 2025-06-14 **Changed:** - *#78* Battle AI is now aware of hiddenpower types from pokemon - *#77* Battle AI is now aware of tera types from terastallized pokemon **Fixed:** - *#76* Some battle issues related to moves that force opponent pokemon to switch

# Changelog ## [0.13.4-beta] - 2025-06-10 **Changed:** - *#75* Lowered base chance for trainers to switch out a dynamaxed pokemon - *#74* Minor adjustments to boost move evaluation (less likely for users with lower health) **Fixed:** - *#73* Usage of moves unknown to cobblemon causing battles to softlock

# Changelog ## [0.13.4-beta] - 2025-06-10 **Changed:** - *#75* Lowered base chance for trainers to switch out a dynamaxed pokemon - *#74* Minor adjustments to boost move evaluation (less likely for users with lower health) **Fixed:** - *#73* Usage of moves unknown to cobblemon causing battles to softlock

# Changelog ## [0.13.3-beta] - 2025-06-03 **Fixed:** - *#72* Trainers attempting to activate ZPowers with wrong moves

# Changelog ## [0.13.3-beta] - 2025-06-03 **Fixed:** - *#72* Trainers attempting to activate ZPowers with wrong moves

# Changelog ## [0.13.2-beta] - 2025-06-02 **Fixed:** - *#71* Hotfix for potential `UnsupportedOperationException` when attempting to start a battle

# Changelog ## [0.13.2-beta] - 2025-06-02 **Fixed:** - *#71* Hotfix for potential `UnsupportedOperationException` when attempting to start a battle

# Changelog ## [0.13.1-beta] - 2025-06-02 **Fixed:** - *#70* Oversight causing battles to randomly crash (`NullPointerException` because "moveset" is null)

# Changelog ## [0.13.1-beta] - 2025-06-02 **Fixed:** - *#70* Oversight causing battles to randomly crash (`NullPointerException` because "moveset" is null)

# Changelog ## [0.13.0-beta] - 2025-06-02 **Changed:** - *#69* Allow cobblemons `BATTLE_STARTED_PRE` event to intercept battles started by this api - *#68* Pokemon models may now alternatively accept a list of held items (if one item was not found the next item is checked) - *#67* Trainer pokemon now support usage of gimmicks (zmoves, mega evolution, dynamax, etc.) - Added `gimmicks` property to `PokemonModel`: Allows to enable and define a terastalization type (`tera`), as well as to activate dyna- and gigantamax (`dynamax` and `gmax`), **latter two require the mega showdown mod to work** - Most gimmicks require specific items to be activated, which are not provided by this mod (you can use other mods like mega showdown for that)

# Changelog ## [0.13.0-beta] - 2025-06-02 **Changed:** - *#69* Allow cobblemons `BATTLE_STARTED_PRE` event to intercept battles started by this api - *#68* Pokemon models may now alternatively accept a list of held items (if one item was not found the next item is checked) - *#67* Trainer pokemon now support usage of gimmicks (zmoves, mega evolution, dynamax, etc.) - Added `gimmicks` property to `PokemonModel`: Allows to enable and define a terastalization type (`tera`), as well as to activate dyna- and gigantamax (`dynamax` and `gmax`), **latter two require the mega showdown mod to work** - Most gimmicks require specific items to be activated, which are not provided by this mod (you can use other mods like mega showdown for that)

# Changelog **Important:** This version may break compatibility with mods that rely on an older version of this api (`< 0.12.0-beta`). This could be the case if mods happen to parse trainers from JSON (i.e. with `GSON`) or use `#getName()` (see *#55* - *59*). There shouldn't be any issues otherwise. To update be sure to configure your `GsonBuilder` instances with `RCTApi#configureGsonBuilder(GsonBuilder)` or simply use a builder provided by `RCTApi#gsonBuilder()`. ## [0.12.1-beta] - 2025-05-24 **Changed:** - *#66* General improvements for `RCTBattleAI` - Custom evaluations for hazard and field manipulating moves (tailwind, gravity, trickroom, spikes, stealthrock, toxicspikes and stickyweb) - Custom evaluations for moves that inflict major status conditions (like spore or glare) - Custom evaluations for sacrificial moves (like explosion or memento) - Custom evaluations for some common moves with very specific effects (like taunt or protect) - Custom evaluations for weather and terrain moves (like raindance or mistyterrain) - Some minor fixes and adjustments here and there (e.g. sleeptalk checking the opponents sleep status instead of the users) - *#65* Refactored `BattleEffects` (former `PokeContext`) utility class for the battle ai **Fixed:** - *#64* Various potential battle errors with `RCTBattleAI` (e.g. battle error if trainer pokemon dies of entry hazards) - *#63* `Text#getComponent()` now returns a component with an empty string (instead of the language key itself), this should fix issues with fallback mechanics if certain texts do not have a translation defined (e.g. trainer names)

# Changelog **Important:** This version may break compatibility with mods that rely on an older version of this api (`< 0.12.0-beta`). This could be the case if mods happen to parse trainers from JSON (i.e. with `GSON`) or use `#getName()` (see *#55* - *59*). There shouldn't be any issues otherwise. To update be sure to configure your `GsonBuilder` instances with `RCTApi#configureGsonBuilder(GsonBuilder)` or simply use a builder provided by `RCTApi#gsonBuilder()`. ## [0.12.1-beta] - 2025-05-24 **Changed:** - *#66* General improvements for `RCTBattleAI` - Custom evaluations for hazard and field manipulating moves (tailwind, gravity, trickroom, spikes, stealthrock, toxicspikes and stickyweb) - Custom evaluations for moves that inflict major status conditions (like spore or glare) - Custom evaluations for sacrificial moves (like explosion or memento) - Custom evaluations for some common moves with very specific effects (like taunt or protect) - Custom evaluations for weather and terrain moves (like raindance or mistyterrain) - Some minor fixes and adjustments here and there (e.g. sleeptalk checking the opponents sleep status instead of the users) - *#65* Refactored `BattleEffects` (former `PokeContext`) utility class for the battle ai **Fixed:** - *#64* Various potential battle errors with `RCTBattleAI` (e.g. battle error if trainer pokemon dies of entry hazards) - *#63* `Text#getComponent()` now returns a component with an empty string (instead of the language key itself), this should fix issues with fallback mechanics if certain texts do not have a translation defined (e.g. trainer names)

# Changelog **Important:** This version may break compatibility with mods that rely on an older version of this api (`< 0.12.0-beta`). This could be the case if mods happen to parse trainers from JSON (i.e. with `GSON`) or use `#getName()` (see *#55* - *59*). There shouldn't be any issues otherwise. To update be sure to configure your `GsonBuilder` instances with `RCTApi#configureGsonBuilder(GsonBuilder)` or simply use a builder provided by `RCTApi#gsonBuilder()`. ## [0.12.0-beta] - 2025-05-13 **Added:** - *#62* `RCTApi#configureGsonBuilder(GsonBuilder)` - *#61* `RCTApi#gsonBuilder()` - *#60* `Text` utility type for translatable text, which can be parsed from a JSON object with `literal` and/or `translatable` fields, or directly from a string, which serves as the `literal` value - Translation support for `PokemonModel#nickname` property (**will be ignored if `literal` is not set**) - Translation support for `TrainerModel#name` property **Changed:** - *#59* Return type of `PokemonModel#getName()` from `String` to `Text` (**potential breaking change**) - *#58* Return type of `Trainer#getName()` from `String` to `Text` (**potential breaking change**) - *#57* Return type of `TrainerModel#getName()` from `String` to `Text` (**potential breaking change**) - *#56* Return type of `TrainerNPC#getName()` from `String` to `Text` (**potential breaking change**) - *#55* Return type of `TrainerPlayer#getName()` from `String` to `Text` (**potential breaking change**)

# Changelog **Important:** This version may break compatibility with mods that rely on an older version of this api (`< 0.12.0-beta`). This could be the case if mods happen to parse trainers from JSON (i.e. with `GSON`) or use `#getName()` (see *#55* - *59*). There shouldn't be any issues otherwise. To update be sure to configure your `GsonBuilder` instances with `RCTApi#configureGsonBuilder(GsonBuilder)` or simply use a builder provided by `RCTApi#gsonBuilder()`. ## [0.12.0-beta] - 2025-05-13 **Added:** - *#62* `RCTApi#configureGsonBuilder(GsonBuilder)` - *#61* `RCTApi#gsonBuilder()` - *#60* `Text` utility type for translatable text, which can be parsed from a JSON object with `literal` and/or `translatable` fields, or directly from a string, which serves as the `literal` value - Translation support for `PokemonModel#nickname` property (**will be ignored if `literal` is not set**) - Translation support for `TrainerModel#name` property **Changed:** - *#59* Return type of `PokemonModel#getName()` from `String` to `Text` (**potential breaking change**) - *#58* Return type of `Trainer#getName()` from `String` to `Text` (**potential breaking change**) - *#57* Return type of `TrainerModel#getName()` from `String` to `Text` (**potential breaking change**) - *#56* Return type of `TrainerNPC#getName()` from `String` to `Text` (**potential breaking change**) - *#55* Return type of `TrainerPlayer#getName()` from `String` to `Text` (**potential breaking change**)

# Changelog ## [0.11.1-beta] - 2025-05-05 **Changed:** - *#54* Adjustments and fixes to `RCTBattleAI` - All moves have been further categorized (e.g. *HEAL* or *BUFF*) for a better generic evaluation and to circumvent issues with trainers targeting opponents with moves that have positive effects - Improved awareness of *screens*, *weather effects* and *terrains* - Improved awareness of certain moves with specific conditions (like *fake out* or *wish*) - Improved awareness of status conditions and other effects (like *levitate*, *seeded* or *drowsy*) - *#53* Builder pattern for `RCTBattleAIConfig` and `BattleRules` (thanks Gitoido) **Deprecated:** - *#52* `TypeChart#getEffectiveness(ElementalType, ElementalType, ElementalType, Ability)`

# Changelog ## [0.11.1-beta] - 2025-05-05 **Changed:** - *#54* Adjustments and fixes to `RCTBattleAI` - All moves have been further categorized (e.g. *HEAL* or *BUFF*) for a better generic evaluation and to circumvent issues with trainers targeting opponents with moves that have positive effects - Improved awareness of *screens*, *weather effects* and *terrains* - Improved awareness of certain moves with specific conditions (like *fake out* or *wish*) - Improved awareness of status conditions and other effects (like *levitate*, *seeded* or *drowsy*) - *#53* Builder pattern for `RCTBattleAIConfig` and `BattleRules` (thanks Gitoido) **Deprecated:** - *#52* `TypeChart#getEffectiveness(ElementalType, ElementalType, ElementalType, Ability)`

# Changelog ## [0.11.0-beta] - 2025-04-12 **Added:** - *#51* `BattleManager#startBattle()` with `UUID` return type as replacement for `BattleManager#start()` - *#50* `nickname` property for `PokemonModel`s **Changed:** - *#49* Adjustments to `RCTBattleAI` *move* and *switch* evaluations (e.g. better awareness of shedinjas wonderguard) and other tweaks - *#48* If the `name` of a `TrainerNPC` is unset or empty it will now fall back to the display name of the entity the trainer is attached to **Fixed:** - *#47* `RCTBattleAI` attempting to choose various illegal actions, causing battles to softlock in certain situations and other issues (e.g. switching out against pokemon with "arena trap" or while "mean look" is active) **Deprecated:** - *#46* `BattleManager#start()` and helper methods **Removed:** - *#45* Demo commands (now implemented in [tbcs](https://gitlab.com/srcmc/tbcs)) - `BattleEndCommand` - `CommandsContext` - `RCTApiCommands` - other related classes - *#44* `BattleState#BattleState(PokemonBattle, BattleRules)` - *#43* `RCTApi#getInstance()` - *#42* `RCTApi#init(TrainerRegistry, BattleManager)` - *#41* `RCTApi#initInstance(String, TrainerRegistry)` - *#40* `RCTApi#initInstance(String, TrainerRegistry, BattleManager)`

# Changelog ## [0.11.0-beta] - 2025-04-12 **Added:** - *#51* `BattleManager#startBattle()` with `UUID` return type as replacement for `BattleManager#start()` - *#50* `nickname` property for `PokemonModel`s **Changed:** - *#49* Adjustments to `RCTBattleAI` *move* and *switch* evaluations (e.g. better awareness of shedinjas wonderguard) and other tweaks - *#48* If the `name` of a `TrainerNPC` is unset or empty it will now fall back to the display name of the entity the trainer is attached to **Fixed:** - *#47* `RCTBattleAI` attempting to choose various illegal actions, causing battles to softlock in certain situations and other issues (e.g. switching out against pokemon with "arena trap" or while "mean look" is active) **Deprecated:** - *#46* `BattleManager#start()` and helper methods **Removed:** - *#45* Demo commands (now implemented in [tbcs](https://gitlab.com/srcmc/tbcs)) - `BattleEndCommand` - `CommandsContext` - `RCTApiCommands` - other related classes - *#44* `BattleState#BattleState(PokemonBattle, BattleRules)` - *#43* `RCTApi#getInstance()` - *#42* `RCTApi#init(TrainerRegistry, BattleManager)` - *#41* `RCTApi#initInstance(String, TrainerRegistry)` - *#40* `RCTApi#initInstance(String, TrainerRegistry, BattleManager)`

# Changelog ## [0.10.15-beta] - 2025-03-29 **Changed:** - *#39* Serializable model and `JTO` classes

# Changelog ## [0.10.15-beta] - 2025-03-29 **Changed:** - *#39* Serializable model and `JTO` classes

# Changelog ## [0.10.14-beta] - 2025-03-20 **Fixed:** - *#38* Potential mod initialization issues when multiple mods register to this api (hopefully)

# Changelog ## [0.10.14-beta] - 2025-03-20 **Fixed:** - *#38* Potential mod initialization issues when multiple mods register to this api (hopefully)

# Changelog ## [0.10.13-beta] - 2025-03-15 **Fixed:** - *#37* Fixed potential issues with randomized pokemon stats when there are multiple mods that depend on this api

# Changelog ## [0.10.13-beta] - 2025-03-15 **Fixed:** - *#37* Fixed potential issues with randomized pokemon stats when there are multiple mods that depend on this api

# Changelog ## [0.10.12-beta] - 2025-02-05 **Fixed:** - *#36* Fix non-initialized IV and EV props in `PokemonModel` when using Cobblemon Pokemon class constructor (thanks Gitoido)

# Changelog ## [0.10.12-beta] - 2025-02-05 **Fixed:** - *#36* Fix non-initialized IV and EV props in `PokemonModel` when using Cobblemon Pokemon class constructor (thanks Gitoido)

# Changelog ## [0.10.11-beta] - 2025-01-28 **Fixed:** - *#35* EVs/IVs of trainer pokemon being reset/randomized at start of battles

# Changelog ## [0.10.11-beta] - 2025-01-28 **Fixed:** - *#35* EVs/IVs of trainer pokemon being reset/randomized at start of battles

# Changelog ## [0.10.10-beta] - 2025-01-26 **Added:** - *#34* `BattleState#isEndForced()`: checks if battle was forcefully ended (i.e. draw) **Changed:** - *#33* `Events#BATTLE_ENDED` now fired after a battle was unregistered from the `BattleManager` and also if a battle was forcfully ended **Fixed:** - *#32* Incompatibility with Cobblemon 1.6.1 (min required version)

# Changelog ## [0.10.10-beta] - 2025-01-26 **Added:** - *#34* `BattleState#isEndForced()`: checks if battle was forcefully ended (i.e. draw) **Changed:** - *#33* `Events#BATTLE_ENDED` now fired after a battle was unregistered from the `BattleManager` and also if a battle was forcfully ended **Fixed:** - *#32* Incompatibility with Cobblemon 1.6.1 (min required version)

# Changelog ## [0.10.9-beta] - 2025-01-24 **Fixed:** - *#31* Clients crashing when logging out from a server on fabric

# Changelog ## [0.10.9-beta] - 2025-01-24 **Fixed:** - *#31* Clients crashing when logging out from a server on fabric

# Changelog ## [0.10.8-beta] - 2025-01-22 **Added:** - *#30* `BattleManager#of(PokemonBattle)`, `BattleManager#queryToEnd(PokemonBattle)` and `BattleManager#tick()` **Fixed:** - *#29* Command api mixing up winners and losers

# Changelog ## [0.10.8-beta] - 2025-01-22 **Added:** - *#30* `BattleManager#of(PokemonBattle)`, `BattleManager#queryToEnd(PokemonBattle)` and `BattleManager#tick()` **Fixed:** - *#29* Command api mixing up winners and losers

# Changelog ## [0.10.7-beta] - 2025-01-21 **Added:** - *#28* Simple Event API - Event `BATTLE_ENDED` - Event `BATTLE_STARTED` - Event `TRAINER_REGISTRED` - Event `TRAINER_UNREGISTRED` - `EventContext` shared between the `TrainerRegistry` and `BattleManager` of an `RCTApi` service (but distinct of those from other services) - *#27* `BattleManager#getStates()` to retrieve all active battle states - *#26* `CommandsContext` to allow registration of commands for different contexts without interfering with each other **Changed:** - *#25* Improved commands (api) - Better suggestions - Win commands support - *#24* Some design adjustments to how `BattleManager` instances are handled (now distinct for each registered `RCTApi` service) - *#23* The mod is now also a requirement for clients (for now) - *#22* `BattleManager#end(UUID, boolean)` overload to forcefully end battles **Fixed:** - *#21* Possibility of starting battles against trainers not attached to an entity (potential softlock) - *#20* Slight adjustments to mod initialization (hopefully fixes some *random* startup crashes on neoforge) - *#19* Trainer pokemon being catchable and/or not recalled in some scenarios **Removed:** - *#18* `GEN_9_ROYAL` battle format for now (as it appears to not be implemented yet in Cobblemon)

# Changelog ## [0.10.7-beta] - 2025-01-21 **Added:** - *#28* Simple Event API - Event `BATTLE_ENDED` - Event `BATTLE_STARTED` - Event `TRAINER_REGISTRED` - Event `TRAINER_UNREGISTRED` - `EventContext` shared between the `TrainerRegistry` and `BattleManager` of an `RCTApi` service (but distinct of those from other services) - *#27* `BattleManager#getStates()` to retrieve all active battle states - *#26* `CommandsContext` to allow registration of commands for different contexts without interfering with each other **Changed:** - *#25* Improved commands (api) - Better suggestions - Win commands support - *#24* Some design adjustments to how `BattleManager` instances are handled (now distinct for each registered `RCTApi` service) - *#23* The mod is now also a requirement for clients (for now) - *#22* `BattleManager#end(UUID, boolean)` overload to forcefully end battles **Fixed:** - *#21* Possibility of starting battles against trainers not attached to an entity (potential softlock) - *#20* Slight adjustments to mod initialization (hopefully fixes some *random* startup crashes on neoforge) - *#19* Trainer pokemon being catchable and/or not recalled in some scenarios **Removed:** - *#18* `GEN_9_ROYAL` battle format for now (as it appears to not be implemented yet in Cobblemon)

# Changelog ## [0.10.6-beta] - 2025-01-07 **Fixed:** - *#17* Trainer pokemon being saved to the world

# Changelog ## [0.10.6-beta] - 2025-01-07 **Fixed:** - *#17* Trainer pokemon being saved to the world

# Changelog ## [0.10.5-beta] - 2025-01-07 **Added:** - *#16* Methods for initialization and retrieval of different `RCTApi` instances by id or in bulk (fallback to `RCTApi#DEFAULT_INSTANCE`) - `RCTApi#getInstance(String)` - `RCTApi#getInstances()` - `RCTApi#initInstance(String)` - `RCTApi#initInstance(String, TrainerRegistry)` - `RCTApi#initInstance(String, TrainerRegistry, BattleManager)` - *#15* Methods to retrieve `Trainer`s from the `TrainerRegistry` by the original trainer (*OT*) of a given `Pokemon` - `TrainerRegistry#getByOT(Pokemon)` - `TrainerRegistry#getByOT(Pokemon, Class<T>)` **Deprecated:** - *#14* `RCTApi#init()` use new methods instead (see *#16*)

# Changelog ## [0.10.5-beta] - 2025-01-07 **Added:** - *#16* Methods for initialization and retrieval of different `RCTApi` instances by id or in bulk (fallback to `RCTApi#DEFAULT_INSTANCE`) - `RCTApi#getInstance(String)` - `RCTApi#getInstances()` - `RCTApi#initInstance(String)` - `RCTApi#initInstance(String, TrainerRegistry)` - `RCTApi#initInstance(String, TrainerRegistry, BattleManager)` - *#15* Methods to retrieve `Trainer`s from the `TrainerRegistry` by the original trainer (*OT*) of a given `Pokemon` - `TrainerRegistry#getByOT(Pokemon)` - `TrainerRegistry#getByOT(Pokemon, Class<T>)` **Deprecated:** - *#14* `RCTApi#init()` use new methods instead (see *#16*)

# Changelog ## [0.10.4-beta] - 2024-12-30 ***Fixed*** - Issues with entity selector in battle command for formats with multiple participants

# Changelog ## [0.10.4-beta] - 2024-12-30 ***Fixed*** - Issues with entity selector in battle command for formats with multiple participants

# Changelog ## [0.10.3-beta] - 2024-12-29 ***Added*** - `RCTApiCommands.register(String)` allows to register `RCTApi` commands with a different prefix - `TrainerRegistry#getId(LivingEntity)` retrieves the trainer id for any given `LivingEntity` ***Changed*** - `battle` command now supports entity selectors

# Changelog ## [0.10.3-beta] - 2024-12-29 ***Added*** - `RCTApiCommands.register(String)` allows to register `RCTApi` commands with a different prefix - `TrainerRegistry#getId(LivingEntity)` retrieves the trainer id for any given `LivingEntity` ***Changed*** - `battle` command now supports entity selectors

# Changelog ## [0.10.2-beta] - 2024-12-23 ***Fixed*** - Battle music themes not playing in trainer battles (`battle.pvn`)

# Changelog ## [0.10.2-beta] - 2024-12-23 ***Fixed*** - Battle music themes not playing in trainer battles (`battle.pvn`)

# Changelog ## [0.10.1-beta] - 2024-12-09 ***Fixed*** - Missing Cobblemon (version) dependency check - Replaced redundant `PokemonEntityMixin` with event handler (which also fixed a crash caused by that mixin on startup)

# Changelog ## [0.10.1-beta] - 2024-12-09 ***Fixed*** - Missing Cobblemon (version) dependency check - Replaced redundant `PokemonEntityMixin` with event handler (which also fixed a crash caused by that mixin on startup)

# Changelog ## [0.10.0-beta] - 2024-12-09 ***Added*** - Added ai configs `RCTBattleAIConfig`, `SelfdotGen5AIConfig`, `StrongBattleAIConfig` and registered corresponding `JTO` parsers (`rct`, `sd5` and `cbl`) - Generic `JTO` (json to object) flexible parser system ***Removed*** - `AIType` enum (`TrainerModel.ai` is now defined as `JTO<BattleAI>`)

# Changelog ## [0.10.0-beta] - 2024-12-09 ***Added*** - Added ai configs `RCTBattleAIConfig`, `SelfdotGen5AIConfig`, `StrongBattleAIConfig` and registered corresponding `JTO` parsers (`rct`, `sd5` and `cbl`) - Generic `JTO` (json to object) flexible parser system ***Removed*** - `AIType` enum (`TrainerModel.ai` is now defined as `JTO<BattleAI>`)

# Changelog ## [0.9.1-beta] - 2024-12-09 ***Changed*** - `RCTBattleAI` adjustments/fixes: improved switch evaluation + trainers now actually consider the use of (mostly healing) items ***Fixed*** - Issues with `RCTBattleAI` and switch instructions potentially causing softlocks as well as some other corner cases that could cause a battle failure (this might not fixed all issues but it appeared rather stable now during my testings)

# Changelog ## [0.9.1-beta] - 2024-12-09 ***Changed*** - `RCTBattleAI` adjustments/fixes: improved switch evaluation + trainers now actually consider the use of (mostly healing) items ***Fixed*** - Issues with `RCTBattleAI` and switch instructions potentially causing softlocks as well as some other corner cases that could cause a battle failure (this might not fixed all issues but it appeared rather stable now during my testings)

# Changelog ## [0.9.0-beta] - 2024-12-03 ***Added*** - Initial release (trainer management, battle formats, battle ai, trainer models)

# Changelog ## [0.9.0-beta] - 2024-12-03 ***Added*** - Initial release (trainer management, battle formats, battle ai, trainer models)