> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edpets/progression/fusion.md).

# Fusion

Two pets of the **same type** merge into that type's `fusion.fuse-into` result.

## Global settings — `fusion.yml`

```yaml
settings:
  mode: normal      # normal = free & guaranteed; chance = costs + success roll
  sounds: true
  economy:          # charged in chance mode (see Currencies for external bridges)
    currency: boost-tickets
```

## Per-pet settings — `pets/<id>.yml`

```yaml
fusion:
  enabled: true
  fuse-into: 'rare-dragon'   # must be an existing pet id
  chance: 75                 # base success % (chance mode)
  cost: 5000                 # charged through fusion.yml's economy (chance mode)
  keep-level: true           # carried over from the higher-leveled input
  keep-experience: false
  keep-mastery: false
  keep-boosts: false
  keep-enhancement: false
  keep-runes: false
  broadcast:
    - '&b&lEdPets &8» &3{player} &bfused two {pet}&bs into {result}&b!'
```

## Behavior

* Select two same-type pets in the fusion GUI and confirm — or use **Quick Fusion** to fuse every eligible pair in storage at once.
* In **chance mode** the success roll is `chance + Fusion Master upgrade bonus`. Failed fusions consume both pets (RivalPets-style).
* Owner-locked pets can only be fused by their owner; `fusion.enabled: false` or a missing `fuse-into` blocks fusion for the type.
* Fires the `PetFuseEvent` for developers.