Z_Crystals.json

Z_Crystals.json

Defines every Z-Crystal: the 18 type-based crystals (Firium-Z, Waterium-Z, etc.) that upgrade any move of their type to a Z-Move, and the 18 species-specific crystals (Decidium-Z, Tapunium-Z, etc.) that upgrade one signature move on one (or a few) specific Pokémon. Located at GenesisForms/items/held_items/z_crystals.json.

Note

Unlike the other held-item files, this one is not a flat map — it has exactly two top-level sections, typed and species, each its own ID → object map. Both feed into the same held-item system (both items end up as ZCrystal instances registered together in the same creative-tab/give-command pool), but their object shapes differ, as shown below.

📄 Full default file (representative entries)

The typed section has 18 entries (one per type), all mechanically identical apart from type/alternate_value/the IDs — two are shown in full below, with a note for the rest. The species section is shown in full since every entry there is genuinely distinct (different species, different lore, no form_changes).

{
  "typed": {
    "buginium-z": {
      "showdown_id": "buginiumz",
      "type": "bug",
      "form_changes": [
        {
          "species": ["arceus"],
          "feature_name": "multitype",
          "default_value": "normal",
          "alternate_value": "bug"
        }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Bug-type moves to Z-Moves."
      ]
    },
    "darkinium-z": {
      "showdown_id": "darkiniumz",
      "type": "dark",
      "form_changes": [
        {
          "species": ["arceus"],
          "feature_name": "multitype",
          "default_value": "normal",
          "alternate_value": "dark"
        }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Dark-type moves to Z-Moves."
      ]
    },
    "// __comment__": "dragonium-z, electrium-z, fairium-z, fightinium-z, firium-z, flyinium-z, ghostium-z, grassium-z, groundium-z, icium-z, normalium-z, poisonium-z, psychium-z, rockium-z, steelium-z, and waterium-z (16 more) follow the exact same shape: one form_changes entry targeting arceus/multitype, default_value normal, alternate_value equal to the crystal's own type."
  },
  "species": {
    "aloraichium-z": {
      "showdown_id": "aloraichiumz",
      "species": [
        { "species": "raichu", "aspect": "alolan" }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Alolan Raichu's Thunderbolt to a Z-Move."
      ]
    },
    "decidium-z": {
      "showdown_id": "decidiumz",
      "species": [
        { "species": "decidueye", "aspect": "" }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Decidueye's Spirit Shackle to a Z-Move."
      ]
    },
    "eevium-z": {
      "showdown_id": "eeviumz",
      "species": [{ "species": "eevee", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Eevee's Last Resort to a Z-Move."
      ]
    },
    "incinium-z": {
      "showdown_id": "inciniumz",
      "species": [{ "species": "incineroar", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Incineroar's Darkest Lariat to a Z-Move."
      ]
    },
    "kommonium-z": {
      "showdown_id": "kommoniumz",
      "species": [{ "species": "kommoo", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Kommo-o's Clanging Scales to a Z-Move."
      ]
    },
    "lunalium-z": {
      "showdown_id": "lunaliumz",
      "species": [
        { "species": "lunala", "aspect": "" },
        { "species": "necrozma", "aspect": "dawn" }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Lunala's Moongeist Beam to a Z-Move."
      ]
    },
    "solganium-z": {
      "showdown_id": "solganiumz",
      "species": [
        { "species": "solgaleo", "aspect": "" },
        { "species": "necrozma", "aspect": "dusk" }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Solgaleo's Sunsteel Strike to a Z-Move."
      ]
    },
    "lycanium-z": {
      "showdown_id": "lycaniumz",
      "species": [{ "species": "lycanroc", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Lycanroc's Stone Edge to a Z-Move."
      ]
    },
    "marshadium-z": {
      "showdown_id": "marshadiumz",
      "species": [{ "species": "marshadow", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Marshadow's Spectral Thief to a Z-Move."
      ]
    },
    "mewnium-z": {
      "showdown_id": "mewniumz",
      "species": [{ "species": "mew", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Mew's Psychic to a Z-Move."
      ]
    },
    "mimikium-z": {
      "showdown_id": "mimikiumz",
      "species": [{ "species": "mimikyu", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Mimikyu's Play Rough to a Z-Move."
      ]
    },
    "pikanium-z": {
      "showdown_id": "pikaniumz",
      "species": [{ "species": "pikachu", "aspect": "normal" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Pikachu's Volt Tackle to a Z-Move."
      ]
    },
    "pikashunium-z": {
      "showdown_id": "pikashuniumz",
      "species": [{ "species": "pikachu", "aspect": "partner" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Thunderbolt to a Z-Move when used by a Pikachu wearing a cap."
      ]
    },
    "primarium-z": {
      "showdown_id": "primariumz",
      "species": [{ "species": "primarina", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Primarina's Sparkling Aria to a Z-Move."
      ]
    },
    "snorlium-z": {
      "showdown_id": "snorliumz",
      "species": [{ "species": "snorlax", "aspect": "" }],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Snorlax's Giga Impact to a Z-Move."
      ]
    },
    "tapunium-z": {
      "showdown_id": "tapuniumz",
      "species": [
        { "species": "tapukoko", "aspect": "" },
        { "species": "tapulele", "aspect": "" },
        { "species": "tapubulu", "aspect": "" },
        { "species": "tapufini", "aspect": "" }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades the tapu's Nature's Madness to a Z-Move."
      ]
    },
    "ultranecrozium-z": {
      "showdown_id": "ultranecroziumz",
      "species": [
        { "species": "necrozma", "aspect": "dawn" },
        { "species": "necrozma", "aspect": "dusk" }
      ],
      "lore": [
        "<gray>This is a crystallized form of Z-Power.",
        "<gray>It upgrades Necrozma's Photon Geyser to a Z-Move."
      ]
    }
  }
}

Note

The "// __comment__" line above is a documentation placeholder added for this wiki page — it is not present in the real file. Do not copy it into your own config.

Top Level

Field	Type	Description
typed	object	Map of ID → typed Z-Crystal object. The 18 generic, type-based Z-Crystals.
species	object	Map of ID → species Z-Crystal object. The 18 signature, species-locked Z-Crystals.

Each ID under either section (e.g. buginium-z, decidium-z) is also the Minecraft item's registry name (genesisforms:<id>) and the string used with /genesis giveZCrystal.

Typed Z-Crystal Object

Field	Type	Description
showdown_id	string	The item ID as known to the mod's bundled Pokémon Showdown data (e.g. "buginiumz"). This is what actually links a held move's type to its Z-Move upgrade in battle — see the note below.
type	string	The crystal's type (e.g. "bug").
form_changes	array of form change objects	Species-specific form changes this crystal also triggers while held. In the default file, every one of the 18 typed crystals carries exactly one entry here, targeting Arceus's multitype feature.
lore	string array	Lore lines shown on the item's tooltip. Supports MiniMessage tags.

Form Change Object

Each entry in form_changes uses the same shape as a Held_Form_Items.json entry's form fields:

Field	Type	Description
species	string array	Species (lowercase Cobblemon species name) this form change applies to. In every default entry this is ["arceus"].
feature_name	string	The species feature toggled — "multitype" for every default entry.
default_value	string	The feature value restored when the crystal is removed ("normal" in every default entry).
alternate_value	string	The feature value applied while the crystal is held — matches the crystal's own type.

In effect, every typed Z-Crystal doubles as a Plate for Arceus: holding e.g. Buginium-Z sets Arceus's multitype to bug, exactly like Held_Form_Items.json's insect_plate does, on top of upgrading Bug-type moves to Z-Moves in battle.

Species Z-Crystal Object

Field	Type	Description
showdown_id	string	The item ID as known to the mod's bundled Pokémon Showdown data (e.g. "decidiumz"). This is what actually restricts the crystal to upgrading its one signature move — Showdown's item data itself only recognizes that move on the intended species.
species	array of { "species": string, "aspect": string }	The species (and, for aspect-locked Pokémon, the specific aspect — e.g. alolan, partner, dawn/dusk) the crystal's flavor text describes it as belonging to. aspect is "" for species with no relevant aspect. Some entries list more than one species (e.g. lunalium-z covers both Lunala and Dawn Wings Necrozma, since they share the same signature Z-Move).
lore	string array	Lore lines shown on the item's tooltip. Supports MiniMessage tags.

Giving Z-Crystals

Z-Crystals are given with their own subcommand rather than the general held-item one:

/genesis giveZCrystal <player> <z-crystal-id>

where <z-crystal-id> is any key from either the typed or species map (e.g. waterium-z, decidium-z).

Note

Actually using Z-Moves in battle additionally requires the player to have Z-Power enabled — see z_power_settings.enable_z_crystals in Config.json, which gates the Z-Ring/Power accessory item, not the crystals themselves. Disabling it doesn't stop these crystal items from being held or from applying their Arceus form_changes — it only stops the wearer from triggering a Z-Move.

See Also

• Held_Form_Items.json — the same species/feature_name/default_value/alternate_value shape used by form_changes here, and the mask/plate/memory items typed Z-Crystals overlap with (Arceus's Plates).
• Events — form_changes.held_items fires the pre/post effects for a typed Z-Crystal's Arceus form change, the same event section Held_Form_Items.json uses.
• Commands — /genesis giveZCrystal gives a player any Z-Crystal by its ID.
• Config.json — z_power_settings.enable_z_crystals and other global item toggles.