Form Transformation System

The Myths and Legends mod allows certain Pokémon to change form or fuse with others based on specific items and conditions. These rules are defined by the server configuration in transformations.json. This page explains how players can trigger these transformations using the interaction wheel and what feedback they might receive.

All item-related form changes and fusions managed by this system are initiated through Cobblemon's Interaction Wheel.

1. Hold the relevant item (e.g., DNA Splicers, Reveal Glass, Prison Bottle, Adamant Orb, Griseous Orb, etc.) in your main hand OR prepare to manage the Pokémon's held item via the wheel. 2. Look at your target Pokémon and perform the Interact action (hold Shift + Right Click by default). 3. This opens the Interaction Wheel. You may see several relevant options depending on the Pokémon, the item you are holding (if any), and the server config:

Icons Added by Myths and Legends (Contextual):
- 'Change Form': Appears if you are holding an item that triggers an Interaction Rule (from `interactionChanges` in the config) for this Pokémon. Clicking attempts the form change/revert. (Tooltip Key: `mythsandlegends.ui.interact.change_form.tooltip`).
- 'Fuse / Unfuse': Appears if you are holding an item that triggers a Fusion Rule (from `fusions` in the config) for this Pokémon. Clicking attempts to fuse (if a partner is in the party) or unfuse the Pokémon. (Tooltip Key: `mythsandlegends.ui.interact.fuse.tooltip`).

Managing Held Items via the Wheel:
- The Interaction Wheel also provides options to manage the Pokémon's held item. While the specific icon might vary, using this function to give a Pokémon an item defined in a Held Item Rule (from `heldItemChanges` in the config, e.g., giving Griseous Orb to Giratina) will cause it to enter its associated passive form (e.g., Origin Forme).
- Similarly, using the wheel to take away that specific item will cause the Pokémon to revert from its passive form back to its standard form.

4. Clicking the desired icon (Change Form, Fuse/Unfuse, or the option to give/take held item) initiates the corresponding action on the server.

Some transformations, if configured with `playAnimation: true` in transformations.json, will display a brief visual animation when the form change or fusion occurs.

Be aware that certain Pokémon forms achieved through this system might be configured as untradable (`isTradable: false` in config). If a form is set as untradable, you will not be able to trade that specific Pokémon while it is in that form. It may become tradable again if reverted to a tradable form.

Player Feedback Messages

During transformation, fusion, or unfusion attempts initiated via the Interaction Wheel, you might receive chat messages indicating the outcome or reason for failure. Here are the messages and their meanings (placeholders like `%s`, `%1$s`, `%2$s` are usually replaced with Pokémon names):

```
mythsandlegends.fusion.must_be_standard_form
```
: “%s must be in its standard form to fuse!”
- Shown if you try to fuse a Pokémon that isn't currently in its base/standard form.
```
mythsandlegends.fusion.partner_missing
```
: “Required fusion partner %s (in standard form) not found in your party.”
- Shown if the required partner Pokémon for the fusion isn't found in your current party (or isn't in its standard form).
```
mythsandlegends.fusion.success
```
: “%1$s and %2$s fused!”
- Confirmation message when fusion is successful.
```
mythsandlegends.unfusion.success
```
: “%1$s and %2$s unfused!”
- Confirmation message when unfusion is successful and the partner is returned to your party.
```
mythsandlegends.fusion.party_full_on_unfuse
```
/
```
mythsandlegends.unfusion.party_full
```
: “Unfusion failed: Your party is full. Make space for the separated Pokémon.” or “Could not complete unfusion: Not enough space in your party.”
- Shown if you try to unfuse a Pokémon but your party is full (as unfusion adds the partner back).
```
mythsandlegends.fusion.error.remove_failed
```
: “Fusion failed: Could not remove partner Pokémon from party.”
- An error message indicating the partner couldn't be removed from the party (should be rare).
```
mythsandlegends.fusion.error.form_change_failed
```
: “Fusion failed: Could not apply the fused form.”
- An error message indicating the base Pokémon failed to change into the fused form after the partner was removed.
```
mythsandlegends.unfusion.error.no_data
```
: “Unfusion failed: No stored Pokémon data found.”
- Shown if you attempt to unfuse a Pokémon that doesn't have valid stored fusion data.
```
mythsandlegends.unfusion.error.load_failed
```
: “Unfusion failed: Could not load stored Pokémon data.”
- An error message if the stored partner data cannot be loaded correctly.
```
mythsandlegends.unfusion.error.add_failed
```
: “Unfusion failed: Could not add the partner Pokémon back to your party.”
- An error message if the partner Pokémon couldn't be added back to the party after being loaded (e.g., if party became full unexpectedly).