Skip to content

Configuring Morphs

Jump to bottom
asanetargoss edited this page May 9, 2022 · 3 revisions

This page describes how to modify/configure available properties of morphs in Changeling.

IMPORTANT: when editing JSON, PLEASE, make sure to check whether modified file has a valid JSON code using a JSON linter, such as this. This will save both mine and your time.

Basics

There are few properties that are available for configuration:

  • Abilities (abilities, string array) – allows to specify the abilities given morph will be able to use. You can list here few abilities from abilities list.
  • Attack (attack, string) – allows to specify an attack this morph will have. You can specify only one attack.
  • Action (action, string) – allows to specify an action this morph will have. You can specify only one action.
  • Health (health, number, by default is 20) – allows to specify the player's maximum health while morphed into this morph.
  • Speed (speed, number, by default is 0.1) – allows to specify the player's speed while morphed into this morph. This option also affects FOV, unfortunately.
  • Hostility (hostile, boolean, by default is false) – allows to specify whether hostile mobs will attack the player. If player attacks a hostile mob, they will fight back.
  • First-person hand rendering (hands, boolean, by default false) – allows to specify whether to render hands in first person. The algorithm isn't optimal for finding hands, so this gives you ability to control whether you want to see hands.

By default, vanilla morphs have some default morph configuration in the mod. Here are the default morph configurations for the current Changeling versions:

These values may change in the future.

If speed or health is not defined for an entity morph, it will default to the value for the entity.

To configure a morph, you'll need to add an entry of morph configuration in the file morphs.json, which is located in Changeling's config folder (.minecraft/config/metamorph). morphs.json should have JSON map/object as a root element. By default, its content is an empty map element:

{}

To add a morph configuration, you'll need first to look up morph name (Blacklisting Morphs page covers that up), insert the morph name as a key into map, and specify any properties you want to modify.

For example, if you want to make:

  • Wolf morph more OP by making him twice maximum health of player, fast as ocelot, be able to negate any fall damage and be able to shoot fireballs
  • Bat morph less OP but with some balancing in health, making it able to glide, hunger-less and be able to explode like Creeper and immune to hostile mobs targeting

You'll need to add this to your morphs.json file:

{
    "Wolf": {
        "abilities": ["prevent_fall"],
        "action": "small_fireball",
        "health": 40,
        "speed": 0.15
    },
    "Bat": {
        "abilities": ["glide", "hungerless"],
        "action": "explode",
        "health": 20,
        "hostile": true
    }
}

Or minecraft:wolf instead of Wolf, and minecraft:bat instead of Bat, if you're using a build of Changeling for 1.11.2 or later.

If Minecraft is running, and you have modified and saved morphs.json file, then you need to reload the morph configuration. Simply type in the command /metamorph reload morphs.

Ability, attack and action list

This section lists abilities, attacks and actions available in Changeling by default. Other mods might add new abilities, attacks and/or actions.

Abilities

Abilities are special actions that apply something on a player on every tick (in update loop).

  • climb – allows players to climb like a spider. This ability also prevents fall damage.
  • fire_proof - make players invincible to fire damage.
  • fly – allows players to fly in survival.
  • glide – makes players fly slowly toward the ground. Also prevents fall damage while gliding. If you sneak, you'll fall as usual.
  • hungerless - makes player immune to hunger potion effect.
  • jumping – makes player hopping.
  • night_vision – makes player see in the night.
  • prevent_fall – prevents fall damage.
  • snow_walk – generates snow under players' feet. Just like a snow man.
  • sun_allergy – inflicts damage when morphed player is in day light.
  • swim – makes player very mobile in the water. Also inflicts damage on player when he's on air.
  • water_allergy – inflicts damage when morphed player steps into water.
  • water_breath – makes player stay in the water forever.

Actions

Actions are abilities that get triggered when a player presses the action key (V by default).

  • explode – makes an explosion like creeper. Also kills player.
  • fireball – shoots exploding fireball.
  • fire_breath – shoots ender dragon fireball.
  • jump – jumps 3 blocks high in the air.
  • potions – throws a random negative potion.
  • small_fireball – shoots a small fireball.
  • snowball – shoots a snowball.
  • teleport – teleports player at the block at which he looks.

Attacks

Attacks are like actions, but they're applied on the entity which the player attacks.

  • poison – applies poison potion effect on the attacked target.
  • wither – applies wither potion effect on the attacked target.
  • knockback – throws the target in the air when player attacks.
Clone this wiki locally