Skip to content

Misc_Items.json

Unariginal edited this page Sep 4, 2026 · 1 revision

Misc_Items.json

Defines the Zygarde Cube (a dual-mode key item that swaps Zygarde's ability and/or cycles its Cell % form) plus a featureless map of simple cosmetic items with no functional behavior of their own. Located at GenesisForms/items/misc_items.json.

📄 Full default file
{
  "zygarde_cube": {
    "enable_ability_swap": true,
    "enable_form_swap": true,
    "feature_name": "percent_cells",
    "feature_values": ["10", "50"],
    "lore": [
      "<gray>An item in which Zygarde Cores and Cells are gathered.",
      "<gray>You can also use it to change Zygarde's forms."
    ]
  },
  "featureless": {
    "wishing_star": {
      "max_count": 1,
      "lore": [
        "<gray>A stone found in the Galar region with a mysterious power.",
        "<gray>It's said that your dreams come true if you find one."
      ]
    },
    "sparkling_stone": {
      "max_count": 1,
      "lore": [
        "<gray>A stone entrusted to you by a Pokémon that has been venerated as a guardian deity in the Alola region.",
        "<gray>There is said to be some secret in how it sparkles."
      ]
    },
    "mega_shard": {
      "max_count": 64,
      "lore": [
        "<gray>A mysterious shard that can be found after smashing Mega Crystals using Pokémon moves.",
        "<gray>It seems that some people collect these shards."
      ]
    }
  }
}

Top Level

Field Type Description
zygarde_cube object The single Zygarde Cube item config — see Zygarde Cube below.
featureless map Map of item ID → simple item definition, for items with no gameplay logic attached. Arbitrary IDs can be added here (see Featureless Items), but each one is still just lore + stack size — there's no way to give a new featureless entry custom behavior through this file alone.

Zygarde Cube

Field Type Default Description
enable_ability_swap boolean true Whether the cube is allowed to toggle Zygarde's ability between Power Construct and Aura Break.
enable_form_swap boolean true Whether the cube is allowed to cycle Zygarde's Cell % form (the feature_name species feature) through feature_values.
feature_name string "percent_cells" The species feature the cube reads/writes to change Zygarde's form. Only change this if you know the underlying Cobblemon feature name for the forms you want to cycle.
feature_values string array ["10", "50"] The ordered list of feature values the cube cycles through, wrapping back to the first after the last. A value of the literal string "null" in this list means "remove the feature entirely" (revert to Cobblemon's own default).
lore string array Lore lines shown on the item tooltip.

The cube is registered with a fixed max stack size of 1 — there's no max_count/max_stack_size field for it in this file.

How the Cube Works

The Zygarde Cube has two independent modes, stored per-item-stack in NBT: "form" and "ability". Which mode is active determines what a normal right-click-on-Pokémon does; sneak + right-click (with nothing selected) cycles the stored mode instead of applying anything.

  • Sneaking toggles the item's mode between form and ability. Each toggle changes the item's visual enchant glint (glinting = form mode, non-glinting = ability mode) and sends the player a mode-changed message. A toggle is skipped (nothing happens, no message) if the mode it would switch to is disabled by config — e.g. sneaking while in ability mode does nothing if enable_form_swap is false.
  • Right-clicking a Pokémon (not sneaking) opens Cobblemon's party-select prompt, restricted server-side to only accept Zygarde (any form). Applying it then does one of two things depending on the stack's current mode:
    • form mode: reads Zygarde's current feature_name value, finds it in feature_values, and advances it to the next value in the list (wrapping to the first). If the resulting value is "null", the feature is removed instead of set. The Pokémon's aspects/form are then refreshed, and — importantly — its ability is explicitly restored to whatever it was before the form change, so cycling form does not, by itself, change ability either way.
    • ability mode: directly swaps the ability between Power Construct and Aura Break, independent of form, guarded by enable_ability_swap.
    • First-ever use on a fresh item stack (no mode set yet): the cube defaults to ability mode and immediately attempts an ability swap — a player must sneak once to switch it into form mode before they can cycle Zygarde's Cell %.

Important

This directly answers the "does disabling enable_ability_swap stop the ability from ever changing" question: yes. The ability-swap routine (swapAbility) checks enable_ability_swap internally and no-ops if it's false — and the form mode branch never calls it either; it only restores the Pokémon's existing ability after a form change. So with enable_ability_swap: false, using the cube in any mode will never touch Zygarde's ability, even while enable_form_swap still lets you freely cycle between 10%/50% forme. The two flags are fully decoupled — disabling one doesn't affect the other.

Note

Zygarde's in-battle transformation to Complete Forme (the vanilla-game "50% HP + Power Construct" trigger) is a separate mechanic handled by Cobblemon's own battle engine and this mod's battle-form event system — it is not gated by enable_ability_swap/enable_form_swap at all. Those two flags only govern the Zygarde Cube item's own out-of-battle behavior. See Events for the battle_forms event (zygarde_percent_cells) that fires when this in-battle transformation happens.

Global Toggles

  • general_settings.disabled_items in Config.json — listing "zygarde_cube" here disables the item entirely (right-click and Pokémon-apply logic both no-op).

Featureless Items

Field Type Default Description
max_count integer 1 The item's max stack size.
lore string array Lore lines shown on the item tooltip.

The default file ships three featureless items: wishing_star, sparkling_stone, and mega_shard.

Note

As of the current codebase, these three items have no functional Pokémon-affecting behavior implemented — they're plain items with a tooltip and a stack size, registered purely so they exist in-world (e.g. as drops, trade fodder, or decoration). No other config file or handler reads these item IDs; searching the mod's source and resource files turns up nothing beyond their own registration, lang entries, and item models. If you're expecting Wishing Star/Sparkling Stone to drive an Ultra Necrozma-style fusion, or Mega Shard to feed into a crafting recipe, that logic doesn't currently exist in this mod — you'd need to add it yourself (e.g. via a possession/fusion item config) or via another mod/datapack.

See Also

  • Events — the battle_forms event fired when Zygarde transforms to Complete Forme in battle (separate from the cube's own form-cycling).
  • Commands — admin commands for giving items directly.

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