Skip to content

Fusion_Items.json

Unariginal edited this page Sep 4, 2026 · 1 revision

Fusion_Items.json

Defines Fusion key items — items like the DNA Splicers or Reins of Unity that combine a "core" Pokémon with a "fuel" Pokémon from the player's party into a single fused form, and can be used again to split them back apart. Located at GenesisForms/items/key_items/fusion_items.json.

📄 Full default file
{
  "dna_splicers": {
    "consumable": false,
    "fusions": [
      {
        "core_pokemon": "kyurem",
        "fuel_pokemon": [
          {
            "species": "reshiram",
            "result_feature_name": "absofusion",
            "result_feature_value": "white"
          },
          {
            "species": "zekrom",
            "result_feature_name": "absofusion",
            "result_feature_value": "black"
          }
        ]
      }
    ],
    "lore": [
      "<gray>A splicer that fuses Kyurem and a certain Pokémon.",
      "<gray>They are said to have originally been one."
    ]
  },
  "reins_of_unity": {
    "consumable": false,
    "fusions": [
      {
        "core_pokemon": "calyrex",
        "fuel_pokemon": [
          {
            "species": "glastrier",
            "result_feature_name": "king_steed",
            "result_feature_value": "ice"
          },
          {
            "species": "spectrier",
            "result_feature_name": "king_steed",
            "result_feature_value": "shadow"
          }
        ]
      }
    ],
    "lore": [
      "<gray>Reins that people presented to the king.",
      "<gray>They enhance Calyrex’s power over bountiful harvests and unite Calyrex with its beloved steed."
    ]
  },
  "n_lunarizer": {
    "consumable": false,
    "fusions": [
      {
        "core_pokemon": "necrozma",
        "fuel_pokemon": [
          {
            "species": "lunala",
            "result_feature_name": "prism_fusion",
            "result_feature_value": "dawn"
          }
        ]
      }
    ],
    "lore": ["<gray>A machine to fuse Necrozma, which needs light, and Lunala."]
  },
  "n_solarizer": {
    "consumable": false,
    "fusions": [
      {
        "core_pokemon": "necrozma",
        "fuel_pokemon": [
          {
            "species": "solgaleo",
            "result_feature_name": "prism_fusion",
            "result_feature_value": "dusk"
          }
        ]
      }
    ],
    "lore": [
      "<gray>A machine to fuse Necrozma, which needs light, and Solgaleo."
    ]
  }
}

Top Level

Field Type Description
<fusion_item_id> object A single Fusion item, keyed by its own unique ID (e.g. dna_splicers, reins_of_unity). This ID is also the item's registered Minecraft item ID (genesisforms:<fusion_item_id>), so it must be unique and give-able as-is.

Fusion Item Object

Field Type Description
consumable boolean If true, one copy of the item is consumed (decremented, respecting creative mode) every time it's used to either fuse or un-fuse a Pokémon. If false, the item is reusable indefinitely — the vanilla behavior for all four stock items above.
fusions array of objects The set of core/fuel pairings this item can perform. Most stock items list exactly one core species, but the array format lets a single item drive multiple unrelated fusion pairings if you want it to. See below.
lore string array Lore lines shown on the item's tooltip. Supports MiniMessage formatting (e.g. <gray>).

fusions[]

Field Type Description
core_pokemon string The species that receives the fusion — using the item on this species (while a valid fuel Pokémon is present in the same party) fuses them. This is also the Pokémon the item stays usable on afterward, to reverse the fusion.
fuel_pokemon array of objects The Pokémon that can be consumed as fuel for this core species. Each entry is one possible pairing — see below.

fuel_pokemon[]

Field Type Description
species string The fuel species. The item searches the player's party for the first Pokémon matching this species (in list order across all fuel_pokemon entries) to fuse with the core Pokémon; that party slot is removed once fusion succeeds.
result_feature_name string The Cobblemon species feature applied to the core Pokémon on a successful fusion — this is what actually changes its form/model/typing.
result_feature_value string The value written to result_feature_name, distinguishing which fuel species was used (e.g. "white" vs "black" for Kyurem+Reshiram vs Kyurem+Zekrom, both under the same absofusion feature).

How Fusing and Un-fusing Work

Using the item on a core_pokemon that isn't already showing one of its fuel_pokemon result Features searches the user's party for a matching fuel species, removes it from the party, stores its full data on the core Pokémon, and applies the resulting Feature (after any configured form-change animation delay). Using the item again on an already-fused core Pokémon reverses this: the stored fuel Pokémon's data is restored and it's re-added to the party, and the fusion Feature is removed.

Note

Un-fusing now restores the fuel Pokémon's full original data. As of the upcoming 1.2.7 release, FusionItem saves the fuel Pokémon at fusion time with Cobblemon's own native saveToNBT and restores it at un-fusion time with loadFromNBT — the same format Cobblemon itself uses to persist a Pokémon. That means nickname, ribbons, exact IVs/EVs, friendship, held item, and everything else about the fuel Pokémon comes back exactly as it was, instead of the old behavior of reconstructing it from a small hand-picked set of properties. Fusions created by older versions still un-fuse correctly — FusionItem detects the old data shape and falls back to the previous (more limited) restoration path automatically, so nothing needs to be migrated by hand.

See Also

  • Events — the form_changes.fusions events section (particles, glow, scale animations played on fusing/un-fusing).
  • Config.jsonfusion_settings block (enabling/disabling Fusion items globally).
  • Commands — giving Fusion items to players.

Config Files

─ items/accessories/Accessories.json

─ items/bag_items/Max_Items.json

─ items/bag_items/Tera_Shards.json

─ items/held_items/Held_Battle_Items.json

─ items/held_items/Held_Form_Items.json

─ items/held_items/Z_Crystals.json

─ items/key_items/Fusion_Items.json

─ items/key_items/Key_Form_Items.json

─ items/key_items/Possession_Items.json

Clone this wiki locally