Minecraft Cat Variant

Cat Variants

This content applies only to Java Edition.

Cat variant definition files define cat variants and their spawn rules.

Definition format

Cat variants use the CAT_VARIANT registry; the datapack path is cat_variant (definitions in data/<namespace>/cat_variant, tags in data/<namespace>/tags/cat_variant).

Definition files use JSON with the following structure:

• JSON file root object
  • asset_id (string, required): (namespace ID) cat texture; resolved to assets/<namespace>/textures/<path>.png.
  • baby_asset_id (string, required): (namespace ID) baby cat texture; resolved the same way.
  • spawn_conditions (list, required): variant spawn selectors.
    • One selector (compound):
      • condition (compound): type (string, required): biome (biomes string/list: tag #, ID, or list), moon_brightness (range min-max bounds; full moon 1, new moon 0), or structure (structures string/list: tag #, ID, or list).
      • priority (int, required): selection priority; ties resolved randomly.

Definition behavior

Cat variant data is loaded only once at server startup; /reload does not reload it — a server restart is required. The CAT_VARIANT registry must have at least one element, or the game errors during sync and blocks world loading.

When spawning a cat, the game evaluates all variant selectors and spawns the variant of a highest-priority valid selector (random among ties).