Skip to content

Axolootl Variant

Sky James edited this page Nov 28, 2023 · 8 revisions

Overview

The Axolootl Variant contains information about a specific type of axolootl.

Usage

Create a JSON file located at data/[namespace]/axolootl/axolootl_variants/[path].json where [namespace]:[path] is the ID of the Axolootl Variant. Names must be lowercase and contain no spaces.

Data

  • translation_key (string) Required
    • The translation key for the display name of the variant.
  • tier (number) Optional
    • The tier number to display, from 0 to 100. The tier has no logical impact on gameplay; it is purely visual. It can be used to indicate to the player how many breeding iterations are required to obtain the variant. Defaults to 1.
  • rarity ("common"|"uncommon"|"rare"|"epic") Optional
    • The Rarity of the variant. It is purely visual and has no impact on gameplay. Modded rarities are supported using the lowercase name of the rarity. Defaults to "common".
  • fire_immune (true|false) Optional
    • Whether the axolootl is immune to fire damage. Defaults to false
  • energy_cost (number) Optional
    • The amount of Forge Energy to deplete every time the axolootl generates resources. Defaults to 0
  • model (Axolootl Model Settings) Optional
    • The model settings for the variant. Defaults to no colors and lucy axolotl texture.
  • food (Bonuses Provider) Optional
    • The food bonuses provider for the axolootl. Defaults to the following bonuses:
      • "minecraft:tropical_fish": 0.05
      • "minecraft:pufferfish": -0.1
      • "#minecraft:fishes": 0.02
  • breed_food (Item Holder Set) Optional
    • A single item, list of items, or item tag for items that can be fed to the axolootl to cause it to breed. Defaults to no items.
  • resource_generator (Resource Generator) Optional
    • A reference or direct definition for the resources that the axolootl can generate. Defaults to axolootl:empty. For compatibility purposes, it is recommended to make a separate file for the resource generator.

JSON Format

{
  "translation_key": "item.minecraft.bone", # the display name of the axolootl variant
  "tier": 1, # the visual tier of the variant
  "rarity": "common", # the item rarity of the variant
  "fire_immune": false, # whether the entity is immune to fire damage
  "energy_cost": 0, # the Forge Energy depleted when generating resources
  "model": { # see the page on Axolootl Model Settings
    "primary_color": "bcbcbc",
    "secondary_color": "8e8d8e",
    "texture": "axolootl:bone"
  },
  "food": { # items that can be fed to the axolootl for bonuses
    "item": "minecraft:tropical_fish", 
    "bonus": 0.1
  }, 
  "breed_food": [ # items that can be fed to the axolootl to allow it to breed
    "minecraft:bone_block",
    "minecraft:tropical_fish"
  ],
  "resource_generator": "axolootl:bone" # references a Resource Generator at data/axolootl/axolootl/resource_generators/bone.json
}

Bonuses Provider

Contains information about items and the speed bonuses provided by each item when fed to an axolootl.

Data

  • item (Item Holder Set)
    • A single item, list of items, or item tag for items that provide the bonus. Optional. Defaults to no items.
  • bonus (Bonuses)
    • The bonuses provided by the item(s)

JSON Format

{
  "item": [ # accepts a single item, list of items, or item tag
    "minecraft:cod",
    "minecraft:cooked_cod"
  ], 
  "bonus": 0.1 # the generation speed bonus provided by the above item(s)
}

Bonuses

Contains information about speed modifiers.

Data

  • generation (number)
    • The percentage boost to resource generation speed. Optional. Defaults to 0
  • breed (number)
    • The percentage boost to automatic breeding speed. Optional. Defaults to 0
  • feed (number)
    • The percentage boost to automatic feeding speed. Optional. Defaults to 0
  • duration (number)
    • The duration of the bonus in ticks. Optional. Defaults to 2000

JSON Format

There are two ways to define bonuses. The first option is a single number that will be added to the overall resource generation speed and will last for 2000 ticks.

"bonus": 0.02 # +2% to resource generation speed for 2000 ticks

The second option is to separately define resource generation, autofeeding, and autobreeding speed bonuses.

"bonus": {
  "generation": 0.02 # +2% to resource generation speed
  "breed": 0.01 # +1% to breeding speed
  "feed": 0.05 # +5% to feeding speed
  "duration": 4000 # bonus will last for 4000 ticks
}

Item Model

By default, the "Axolootl in a Bucket" item uses a layered and tinted model file for each Axolootl Variant. To specify a custom model for any variant, place a model JSON file at assets/[namespace]/models/item/axolootl_bucket/[variant].json. The "axolootl:baby" Item Property Override is available to differentiate between buckets with baby axolootls (1.0) and adult axolootls (0.0).

Clone this wiki locally