Held_Form_Items.json

Held_Form_Items.json

Defines held items that change a Pokémon's form while they're held, and revert it when the item is taken off or swapped for something else (Rusted Sword/Shield, the Primal orbs, Genesect's Drives, Ogerpon's Masks, Silvally's Memories, and Arceus's Plates). Located at GenesisForms/items/held_items/held_form_items.json.

📄 Full default file (representative entries)

The real file has 30 entries. The Genesect Drives, Silvally Memories, and Arceus Plates are each long, mechanically-identical runs that only change alternate_value (and the item/showdown IDs) per type — one or two of each are shown below in full, with a note where entries were omitted. Every other entry is included as-is.

{
  "rusted_sword": {
    "showdown_id": "rustedsword",
    "species": ["zacian"],
    "feature_name": "behemoth_warrior",
    "default_value": "hero",
    "alternate_value": "crowned",
    "lore": [
      "<gray>It is said that a hero used this sword to halt a terrible disaster in ancient times.",
      "<gray>But it's grown rusty and worn."
    ]
  },
  "rusted_shield": {
    "showdown_id": "rustedshield",
    "species": ["zamazenta"],
    "feature_name": "behemoth_warrior",
    "default_value": "hero",
    "alternate_value": "crowned",
    "lore": [
      "<gray>It is said that a hero used this shield to halt a terrible disaster in ancient times.",
      "<gray>But it's grown rusty and worn."
    ]
  },
  "red_orb": {
    "showdown_id": "redorb",
    "species": ["groudon"],
    "feature_name": "reversion_state",
    "default_value": "standard",
    "alternate_value": "primal",
    "lore": [
      "<gray>A shiny red orb that is said to have a deep connection to a legend of the Hoenn region."
    ]
  },
  "blue_orb": {
    "showdown_id": "blueorb",
    "species": ["kyogre"],
    "feature_name": "reversion_state",
    "default_value": "standard",
    "alternate_value": "primal",
    "lore": [
      "<gray>A shiny blue orb that is said to have a deep connection to a legend of the Hoenn region."
    ]
  },
  "shock_drive": {
    "showdown_id": "shockdrive",
    "species": ["genesect"],
    "feature_name": "techno_drive",
    "default_value": "normal",
    "alternate_value": "electric",
    "lore": [
      "<gray>A cassette to be held by Genesect.",
      "<gray>It changes Genesect's Techno Blast move so it becomes Electric type."
    ]
  },
  "burn_drive": {
    "showdown_id": "burndrive",
    "species": ["genesect"],
    "feature_name": "techno_drive",
    "default_value": "normal",
    "alternate_value": "fire",
    "lore": [
      "<gray>A cassette to be held by Genesect.",
      "<gray>It changes Genesect's Techno Blast move so it becomes Fire type."
    ]
  },
  "// __comment__": "chill_drive and douse_drive follow the same pattern (ice / water) — omitted here.",
  "teal_mask": {
    "showdown_id": "tealmask",
    "species": ["ogerpon"],
    "feature_name": "ogre_mask",
    "default_value": "teal",
    "alternate_value": "teal",
    "lore": [
      "<gray>A teal mask patterned after the face of an ogre.",
      "<gray>Ogerpon dropped it while fleeing up the stairs after visiting the Festival of Masks."
    ]
  },
  "hearthflame_mask": {
    "showdown_id": "hearthflamemask",
    "species": ["ogerpon"],
    "feature_name": "ogre_mask",
    "default_value": "teal",
    "alternate_value": "hearthflame",
    "lore": [
      "<gray>An item to be held by Ogerpon.",
      "<gray>This carved wooden mask is adorned with crystals and allows Ogerpon to wield the Fire type during battle."
    ]
  },
  "wellspring_mask": {
    "showdown_id": "wellspringmask",
    "species": ["ogerpon"],
    "feature_name": "ogre_mask",
    "default_value": "teal",
    "alternate_value": "wellspring",
    "lore": [
      "<gray>An item to be held by Ogerpon.",
      "<gray>This carved wooden mask is adorned with crystals and allows Ogerpon to wield the Water type during battle."
    ]
  },
  "cornerstone_mask": {
    "showdown_id": "cornerstonemask",
    "species": ["ogerpon"],
    "feature_name": "ogre_mask",
    "default_value": "teal",
    "alternate_value": "cornerstone",
    "lore": [
      "<gray>An item to be held by Ogerpon.",
      "<gray>This carved wooden mask is adorned with crystals and allows Ogerpon to wield the Rock type during battle."
    ]
  },
  "bug_memory": {
    "showdown_id": "bugmemory",
    "species": ["silvally"],
    "feature_name": "rks_memory",
    "default_value": "normal",
    "alternate_value": "bug",
    "lore": [
      "<gray>A memory disc that contains Bug-type data.",
      "<gray>It changes the type of the holder if held by a certain species of Pokémon."
    ]
  },
  "dark_memory": {
    "showdown_id": "darkmemory",
    "species": ["silvally"],
    "feature_name": "rks_memory",
    "default_value": "normal",
    "alternate_value": "dark",
    "lore": [
      "<gray>A memory disc that contains Dark-type data.",
      "<gray>It changes the type of the holder if held by a certain species of Pokémon."
    ]
  },
  "// __comment__": "dragon/electric/fairy/fighting/fire/flying/ghost/grass/ground/ice/poison/psychic/rock/steel/water_memory (16 more) follow the exact same pattern — one per type, all species: [\"silvally\"], feature_name: \"rks_memory\", default_value: \"normal\".",
  "insect_plate": {
    "showdown_id": "insectplate",
    "species": ["arceus"],
    "feature_name": "multitype",
    "default_value": "normal",
    "alternate_value": "bug",
    "lore": [
      "<gray>An item to be held by a Pokémon.",
      "<gray>This stone tablet is imbued with the essence of bugs and boosts the power of the holder’s Bug-type moves."
    ]
  },
  "dread_plate": {
    "showdown_id": "dreadplate",
    "species": ["arceus"],
    "feature_name": "multitype",
    "default_value": "normal",
    "alternate_value": "dark",
    "lore": [
      "<gray>An item to be held by a Pokémon.",
      "<gray>This stone tablet is imbued with the essence of darkness and boosts the power of the holder’s Dark-type moves."
    ]
  },
  "// __comment__": "draco/zap/pixie/fist/flame/sky/spooky/meadow/earth/icicle/toxic/mind/stone/iron/splash_plate (15 more, one per remaining type) follow the exact same pattern — species: [\"arceus\"], feature_name: \"multitype\", default_value: \"normal\".",
  "legend_plate": {
    "showdown_id": "legendplate",
    "species": ["arceus"],
    "feature_name": "multitype",
    "default_value": "normal",
    "alternate_value": "normal",
    "lore": [
      "<gray>A stone tablet imbued with the essence of all creation.",
      "<gray>When used on a certain Pokémon, it allows that Pokémon to gain the power of every type there is."
    ]
  },
  "blank_plate": {
    "showdown_id": "blankplate",
    "species": ["arceus"],
    "feature_name": "multitype",
    "default_value": "normal",
    "alternate_value": "normal",
    "lore": [
      "<gray>A stone tablet imbued with the essence of normalcy.",
      "<gray>When used on a certain Pokémon, it allows that Pokémon to gain the power of the Normal type."
    ]
  }
}

Note

The "// __comment__" lines above are documentation placeholders added for this wiki page only — they are not present in the real file (plain JSON has no comment syntax, and a repeated key would overwrite the previous one). Do not copy them into your own config.

Top Level

Field	Type	Description
<item_id>	object	A single held form item, keyed by its own unique ID (e.g. rusted_sword). This ID is also the Minecraft item's registry name (genesisforms:<item_id>) and the string used with /genesis giveHeldItem.

Item Object

Field	Type	Description
showdown_id	string	The item ID as known to the mod's bundled Pokémon Showdown data — same purpose as in Held_Battle_Items.json: it links the item to whatever in-battle item effect Showdown defines for it (if any). It is unrelated to the form change itself, which is handled entirely by GenesisForms using the fields below.
species	string array	The species (lowercase, Cobblemon species name) this item's form change applies to. Holding the item on any other species does nothing (aside from whatever effect its showdown_id carries in battle). Every default entry lists exactly one species, but the field accepts more than one if you want a single item to drive the same feature/value pair across multiple species.
feature_name	string	The Cobblemon species feature this item toggles (e.g. behemoth_warrior, reversion_state, techno_drive, ogre_mask, rks_memory, multitype). Must match a feature the target species actually has.
default_value	string	The feature value the Pokémon is set back to when the item is removed (or swapped for a non-matching item).
alternate_value	string	The feature value applied while the item is held.
lore	string array	Lore lines shown on the item's tooltip. Supports MiniMessage tags.

Note

teal_mask sets default_value and alternate_value to the same string ("teal"). Holding it is a no-op for the feature (Ogerpon's default form already is teal) — it exists purely so the item can be given/held/removed like the other three masks without erroring, and so its showdown_id still contributes whatever Showdown effect the Teal Mask has.

Behavior

Whenever a Pokémon's held item slot changes — equipping, removing, or swapping directly for a different item — GenesisForms:

1. Reverts any form change driven by the previous held item (if it was a held form item or Z-Crystal), setting feature_name back to default_value.
2. Applies the form change for the new held item, if it's a held form item (or Z-Crystal) whose species list matches the Pokémon — setting feature_name to alternate_value.

So swapping straight from one form item to another (e.g. Hearthflame Mask → Wellspring Mask) reverts then re-applies in the same tick; there's no need to remove an item to "empty hands" before giving a different one.

See Also

• Events — form_changes.held_items fires the pre/post effects (particles, sounds, messages) for both applying and reverting a held-item form change.
• Commands — /genesis giveHeldItem gives a player any held form item by its ID.
• Config.json — general_settings.disabled_items and other global item toggles (note: not currently checked for held form items — see the caveat on Held_Battle_Items.json).