Held_Battle_Items.json

Held_Battle_Items.json

Defines held items whose entire effect is a stat/battle-mechanic change handled by Pokémon Showdown's battle engine (Choice items, type-boosting orbs, etc.) — items that do not change a Pokémon's form. Located at GenesisForms/items/held_items/held_battle_items.json.

📄 Full default file

{
  "adamant_orb": {
    "showdown_id": "adamantorb",
    "lore": [
      "<gray>A brightly shining gem to be held by Dialga.",
      "<gray>It boosts the power of Dialga’s Dragon- and Steel-type moves."
    ]
  },
  "adrenaline_orb": {
    "showdown_id": "adrenalineorb",
    "lore": [
      "<gray>An item to be held by a Pokémon.",
      "<gray>This orb boosts the Speed stat if the holder is intimidated."
    ]
  },
  "berserk_gene": {
    "showdown_id": "berserkgene",
    "lore": ["<gray>Boosts Attack but causes confusion."]
  },
  "booster_energy": {
    "showdown_id": "boosterenergy",
    "lore": [
      "<gray>An item to be held by Pokémon with certain Abilities.",
      "<gray>The energy that fills this capsule boosts the strength of the Pokémon."
    ]
  },
  "griseous_orb": {
    "showdown_id": "griseousorb",
    "lore": [
      "<gray>A shining gem to be held by Giratina.",
      "<gray>It boosts the power of Giratina's Dragon- and Ghost-type moves."
    ]
  },
  "lucky_punch": {
    "showdown_id": "luckypunch",
    "lore": [
      "<gray>An item to be held by Chansey.",
      "<gray>This lucky boxing glove boosts the critical-hit ratio of Chansey's moves."
    ]
  },
  "lustrous_orb": {
    "showdown_id": "lustrousorb",
    "lore": [
      "<gray>A beautifully shining gem to be held by Palkia.",
      "<gray>It boosts the power of Palkia’s Dragon- and Water-type moves."
    ]
  },
  "macho_brace": {
    "showdown_id": "machobrace",
    "lore": [
      "<gray>An item to be held by a Pokémon.",
      "<gray>Holding this stiff, heavy brace reduces a Pokémon's Speed in battle but allows its stats to grow more quickly."
    ]
  },
  "soul_dew": {
    "showdown_id": "souldew",
    "lore": [
      "<gray>A wondrous orb to be held by Latios or Latias.",
      "<gray>It boosts the power of their Psychic- and Dragon-type moves."
    ]
  }
}

Top Level

Field	Type	Description
<item_id>	object	A single held battle item, keyed by its own unique ID (e.g. adamant_orb). 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 (no spaces, lowercase — e.g. "adamantorb" for Adamant Orb). See the note below.
lore	string array	Lore lines shown on the item's tooltip, one array entry per line. Supports MiniMessage tags (e.g. <gray>).

Note

showdown_id only links the Minecraft item to its effect — it doesn't define the effect. This file controls the item's identity on the Minecraft side: its registry ID, and its tooltip lore. The actual battle effect (the stat boost, the move-locking, the type boost, etc.) is defined entirely by Pokémon Showdown's own item data for that showdown_id, which ships bundled with the mod and is not editable through this file. If showdown_id doesn't match a real Showdown item ID, the Minecraft item will exist and be holdable, but will do nothing in battle.

Because of this, you cannot invent a brand-new battle effect purely by adding an entry here — you can only give a new Minecraft item/name/lore to an effect that Showdown's data already implements (including items Showdown supports that don't ship with a default entry in this file, like other type-boosting orbs).

Note

Unlike bag items, key items, and accessories, entries in this file are not affected by general_settings.disabled_items in Config.json — there's no code path that checks that list for held battle items. To remove one, delete its entry from this file (or set it up so nothing ever hands it out).

Adding a New Held Battle Item

To add a new held battle item (for a Showdown item this mod doesn't already expose), add an entry keyed by a new, unique ID:

"expert_belt": {
  "showdown_id": "expertbelt",
  "lore": [
    "<gray>An item to be held by a Pokémon.",
    "<gray>This belt is worn by a serious battler. It boosts supereffective moves."
  ]
}

This registers a new item genesisforms:expert_belt with the given lore, whose in-battle effect is whatever Showdown's expertbelt item does. A server restart (or config reload, if supported) is required to pick up new entries.

See Also

• Commands — /genesis giveHeldItem gives a player any held battle item by its ID.
• Config.json — general_settings.disabled_items and other global item toggles.