Add Custom Mob to ChronoDawn

Purpose: Complete guide for adding a new mob entity to ChronoDawn with full multi-version and multi-loader support.

Quick Checklist

When adding a new mob, complete ALL of the following:

Java Classes (per module: 1.20.1, 1.21.1, 1.21.2, 1.21.4)

Note: 1.21.3 uses 1.21.2 modules (no separate directory)

• Entity class (

  entities/mobs/MobNameEntity.java

  )
• Model class (

  client/model/MobNameModel.java

  )
• Renderer class (

  client/renderer/mobs/MobNameRenderer.java

  )
• RenderState class (

  client/renderer/mobs/MobNameRenderState.java

  ) - 1.21.2 and 1.21.4 only

Registration (per version)

• ModEntities.java

  - Entity type registration

• ModItems.java

  - Spawn egg registration (see custom-mob-spawn-egg skill)

Platform-Specific Registration (CRITICAL - Common source of crashes)

• Fabric

  ChronoDawnFabric.java

  - Attribute & spawn placement registration
• Fabric

  ChronoDawnClientFabric.java

  - Import statements for Model and Renderer
• Fabric

  ChronoDawnClientFabric.java

  - Model layer registration (

  EntityModelLayerRegistry.registerModelLayer

  )
• Fabric

  ChronoDawnClientFabric.java

  - Renderer registration (

  EntityRendererRegistry.register

  )
• NeoForge

  ChronoDawnNeoForge.java

  - Attribute & spawn placement registration
• NeoForge

  ChronoDawnClientNeoForge.java

  - Model layer & renderer registration
• NeoForge

  ChronoDawnClientNeoForge.java

  - Spawn egg color handler

Resource Files (per version)

• Texture file (

  textures/entity/mobs/mob_name.png

  )
• Loot table (

  loot_table/entities/mob_name.json

  or

  loot_tables/

  for 1.20.1)
• Spawn egg model (

  models/item/mob_name_spawn_egg.json

  )
• Spawn egg item definition (

  items/mob_name_spawn_egg.json

  ) - 1.21.4 only
• Language files (

  lang/en_us.json

  ,

  lang/ja_jp.json

  )
• Biome spawn configuration (if replacing vanilla mob)

Vanilla Mob Reference Parameters

When creating a mob based on a vanilla mob, use these reference values:

Tip: For hostile versions of friendly mobs, consider increasing Health and adding Attack damage.

1. Entity Class

Create in

common-{version}/src/main/java/com/chronodawn/entities/mobs/

1.21.2 Template

package com.chronodawn.entities.mobs;

import net.minecraft.world.entity.EntityType;
import net.minecraft.world.entity.ai.attributes.AttributeSupplier;
import net.minecraft.world.entity.ai.attributes.Attributes;
import net.minecraft.world.entity.monster.Monster;
import net.minecraft.world.level.Level;

public class MobNameEntity extends Monster {

    public MobNameEntity(EntityType<? extends MobNameEntity> entityType, Level level) {
        super(entityType, level);
    }

    public static AttributeSupplier.Builder createAttributes() {
        return Monster.createMonsterAttributes()
                .add(Attributes.MAX_HEALTH, 20.0D)
                .add(Attributes.ATTACK_DAMAGE, 3.0D)
                .add(Attributes.MOVEMENT_SPEED, 0.3D)
                .add(Attributes.FOLLOW_RANGE, 35.0D);
    }

    @Override
    protected void registerGoals() {
        // Add AI goals here
    }

    // 1.21.2: Use EntitySpawnReason, SynchedEntityData.Builder
    // Example for synched data:
    // @Override
    // protected void defineSynchedData(SynchedEntityData.Builder builder) {
    //     super.defineSynchedData(builder);
    //     builder.define(DATA_FLAGS, (byte)0);
    // }
}

1.21.1 Template

Key differences from 1.21.2:

• Use

  MobSpawnType

  instead of

  EntitySpawnReason

• SynchedEntityData.Builder

  pattern same as 1.21.2

1.20.1 Template

Key differences:

• Use

  MobSpawnType

  instead of

  EntitySpawnReason

• defineSynchedData()

  has no parameters, use

  this.entityData.define()

  directly

@Override
protected void defineSynchedData() {
    super.defineSynchedData();
    this.entityData.define(DATA_FLAGS, (byte)0);
}

2. Model Class

Create in

common-{version}/src/main/java/com/chronodawn/client/model/

1.21.2 Template (RenderState pattern)

package com.chronodawn.client.model;

import com.chronodawn.client.renderer.mobs.MobNameRenderState;
import net.minecraft.client.model.EntityModel;
import net.minecraft.client.model.geom.ModelPart;
import net.minecraft.client.model.geom.PartPose;
import net.minecraft.client.model.geom.builders.*;

public class MobNameModel extends EntityModel<MobNameRenderState> {

    private final ModelPart body;

    public MobNameModel(ModelPart root) {
        super(root);
        this.body = root.getChild("body");
    }

    public static LayerDefinition createBodyLayer() {
        MeshDefinition meshdefinition = new MeshDefinition();
        PartDefinition partdefinition = meshdefinition.getRoot();

        partdefinition.addOrReplaceChild("body",
            CubeListBuilder.create()
                .texOffs(0, 0)
                .addBox(-4.0F, -8.0F, -4.0F, 8.0F, 8.0F, 8.0F),
            PartPose.offset(0.0F, 24.0F, 0.0F));

        return LayerDefinition.create(meshdefinition, 64, 32);
    }

    @Override
    public void setupAnim(MobNameRenderState state) {
        super.setupAnim(state);
        // Animation logic using state.walkAnimationPos, state.walkAnimationSpeed
    }
}

1.21.1 / 1.20.1 Template (Entity pattern)

package com.chronodawn.client.model;

import com.chronodawn.entities.mobs.MobNameEntity;
import net.minecraft.client.model.EntityModel;
import net.minecraft.client.model.geom.ModelPart;
// ... other imports

public class MobNameModel extends EntityModel<MobNameEntity> {

    public MobNameModel(ModelPart root) {
        // 1.21.1/1.20.1: No super(root) call
        this.body = root.getChild("body");
    }

    // Same createBodyLayer() as 1.21.2

    @Override
    public void setupAnim(MobNameEntity entity, float limbSwing, float limbSwingAmount,
                          float ageInTicks, float netHeadYaw, float headPitch) {
        // Animation logic
    }

    // 1.21.1: renderToBuffer with int color
    @Override
    public void renderToBuffer(PoseStack poseStack, VertexConsumer buffer,
                               int packedLight, int packedOverlay, int color) {
        body.render(poseStack, buffer, packedLight, packedOverlay, color);
    }

    // 1.20.1: renderToBuffer with float RGBA
    @Override
    public void renderToBuffer(PoseStack poseStack, VertexConsumer buffer,
                               int packedLight, int packedOverlay,
                               float red, float green, float blue, float alpha) {
        body.render(poseStack, buffer, packedLight, packedOverlay, red, green, blue, alpha);
    }
}

3. Renderer Class

Create in

common-{version}/src/main/java/com/chronodawn/client/renderer/mobs/

1.21.2 Template

package com.chronodawn.client.renderer.mobs;

import com.chronodawn.ChronoDawn;
import com.chronodawn.client.model.MobNameModel;
import com.chronodawn.entities.mobs.MobNameEntity;
import net.minecraft.client.renderer.entity.EntityRendererProvider;
import net.minecraft.client.renderer.entity.MobRenderer;
import net.minecraft.resources.ResourceLocation;

public class MobNameRenderer extends MobRenderer<MobNameEntity, MobNameRenderState, MobNameModel> {

    private static final ResourceLocation TEXTURE =
        ResourceLocation.fromNamespaceAndPath(ChronoDawn.MOD_ID, "textures/entity/mobs/mob_name.png");

    public MobNameRenderer(EntityRendererProvider.Context context) {
        super(context, new MobNameModel(context.bakeLayer(MobNameModel.LAYER_LOCATION)), 0.5f);
    }

    @Override
    public ResourceLocation getTextureLocation(MobNameRenderState state) {
        return TEXTURE;
    }

    @Override
    public MobNameRenderState createRenderState() {
        return new MobNameRenderState();
    }
}

1.21.1 / 1.20.1 Template

// MobRenderer has 2 type parameters: <Entity, Model>
public class MobNameRenderer extends MobRenderer<MobNameEntity, MobNameModel> {

    @Override
    public ResourceLocation getTextureLocation(MobNameEntity entity) {
        return TEXTURE;
    }

    // No createRenderState() method needed
}

4. RenderState Class (1.21.2 and 1.21.4)

Create in

common-1.21.2/

common-1.21.4/

src/main/java/com/chronodawn/client/renderer/mobs/

package com.chronodawn.client.renderer.mobs;

import net.minecraft.client.renderer.entity.state.LivingEntityRenderState;

public class MobNameRenderState extends LivingEntityRenderState {
    // Add custom state fields if needed for animations
}

5. Entity Registration (ModEntities.java)

public static final RegistrySupplier<EntityType<MobNameEntity>> MOB_NAME = ENTITIES.register(
    "mob_name",
    () -> EntityType.Builder.of(MobNameEntity::new, MobCategory.MONSTER)
        .sized(0.6f, 1.8f)  // width, height
        .clientTrackingRange(8)
        .updateInterval(3)
        .build(ResourceKey.create(Registries.ENTITY_TYPE,
            CompatResourceLocation.create(ChronoDawn.MOD_ID, "mob_name")))
);

1.20.1 difference: Use

.build("mob_name")

.build(ResourceKey...)

6. Platform-Specific Registration

Fabric - ChronoDawnFabric.java

// Attributes
FabricDefaultAttributeRegistry.register(ModEntities.MOB_NAME.get(), MobNameEntity.createAttributes());

// Spawn placement (1.21.1/1.21.2)
SpawnPlacements.register(
    ModEntities.MOB_NAME.get(),
    SpawnPlacementTypes.ON_GROUND,
    Heightmap.Types.MOTION_BLOCKING_NO_LEAVES,
    Monster::checkMonsterSpawnRules
);

// Spawn placement (1.20.1)
SpawnPlacements.register(
    ModEntities.MOB_NAME.get(),
    SpawnPlacements.Type.ON_GROUND,  // Note: different enum
    Heightmap.Types.MOTION_BLOCKING_NO_LEAVES,
    Monster::checkMonsterSpawnRules
);

Fabric - ChronoDawnClientFabric.java

IMPORTANT: Don't forget to add imports at the top of the file!

// Required imports (add to import section)
import com.chronodawn.client.model.MobNameModel;
import com.chronodawn.client.renderer.mobs.MobNameRenderer;

// In registerEntityModelLayers() method - Model layer registration
EntityModelLayerRegistry.registerModelLayer(MobNameModel.LAYER_LOCATION, MobNameModel::createBodyLayer);

// In registerEntityRenderers() method - Renderer registration
EntityRendererRegistry.register(ModEntities.MOB_NAME.get(), MobNameRenderer::new);

Common Mistake: Forgetting either the imports OR the registrations will cause a NullPointerException crash when spawning the entity.

NeoForge - ChronoDawnNeoForge.java

// In onEntityAttributeCreation event
event.put(ModEntities.MOB_NAME.get(), MobNameEntity.createAttributes().build());

// In onSpawnPlacementRegister event
event.register(
    ModEntities.MOB_NAME.get(),
    SpawnPlacementTypes.ON_GROUND,
    Heightmap.Types.MOTION_BLOCKING_NO_LEAVES,
    Monster::checkMonsterSpawnRules,
    SpawnPlacementRegisterEvent.Operation.AND
);

NeoForge - ChronoDawnClientNeoForge.java

// In onRegisterEntityRenderers event
event.registerEntityRenderer(ModEntities.MOB_NAME.get(), MobNameRenderer::new);

// In onRegisterLayerDefinitions event
event.registerLayerDefinition(MobNameModel.LAYER_LOCATION, MobNameModel::createBodyLayer);

7. Resource Files

Loot Table

1.21.1 / 1.21.2 / 1.21.3 (

data/chronodawn/loot_table/entities/mob_name.json

{
  "type": "minecraft:entity",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "minecraft:bone",
          "functions": [
            {
              "function": "minecraft:set_count",
              "count": { "min": 0, "max": 2, "type": "minecraft:uniform" }
            },
            {
              "function": "minecraft:enchanted_count_increase",
              "enchantment": "minecraft:looting",
              "count": { "type": "minecraft:uniform", "min": 0, "max": 1 }
            }
          ]
        }
      ]
    }
  ]
}

1.20.1 (

data/chronodawn/loot_tables/entities/mob_name.json

• Directory is

  loot_tables

  (plural)
• Use

  "function": "minecraft:looting_enchant"

  instead of

  enchanted_count_increase

Language Files

"entity.chronodawn.mob_name": "Mob Name",
"item.chronodawn.mob_name_spawn_egg": "Mob Name Spawn Egg"

Biome Spawn Configuration

To replace a vanilla mob in ChronoDawn biomes, edit

worldgen/biome/chronodawn_*.json

{
  "spawners": {
    "monster": [
      { "type": "chronodawn:mob_name", "weight": 100, "minCount": 4, "maxCount": 4 }
    ]
  }
}

8. Spawn Egg

IMPORTANT: See the

custom-mob-spawn-egg

Quick reminder:

• Register in

  ModItems.java

• Add to

  initializeSpawnEggs()

  and

  populateCreativeTab()

• Create

  models/item/mob_name_spawn_egg.json

  with

  "parent": "item/template_spawn_egg"

• Add to NeoForge color handler in

  ChronoDawnClientNeoForge.java

• 1.21.4 only: Create

  items/mob_name_spawn_egg.json

  with tints array (colors in decimal)

Version API Differences Summary

MobSpawnType

MobSpawnType

EntitySpawnReason

EntitySpawnReason

defineSynchedData()

defineSynchedData(Builder)

defineSynchedData(Builder)

defineSynchedData(Builder)

EntityModel<Entity>

EntityModel<Entity>

EntityModel<RenderState>

EntityModel<RenderState>

Entity, Model

Entity, Model

Entity, RenderState, Model

Entity, RenderState, Model

float r,g,b,a

int color

build("name")

build(ResourceKey)

build(ResourceKey)

build(ResourceKey)

SpawnPlacements.Type

SpawnPlacementTypes

SpawnPlacementTypes

SpawnPlacementTypes

loot_tables/

loot_table/

loot_table/

loot_table/

looting_enchant

enchanted_count_increase

enchanted_count_increase

enchanted_count_increase

hurt(DamageSource, float)

hurt(DamageSource, float)

hurtServer(ServerLevel, DamageSource, float)

hurtServer(ServerLevel, DamageSource, float)

getMinBuildHeight()

getMinBuildHeight()

getMinY()

getMinY()

items/*.json

Note: 1.21.3 is a hotfix release that shares modules with 1.21.2. No separate code changes are needed.

Common Issues

CRITICAL: The most common mistakes are missing Fabric client registrations. Always verify both model layer AND renderer are registered in

ChronoDawnClientFabric.java

EntityModelLayerRegistry.registerModelLayer()

EntityRendererRegistry.register()

custom-mob-spawn-egg

looting_enchant

enchanted_count_increase

"enchantment": "minecraft:looting"