Easy Model Entities

Easy NPC Versions

Easy Model Entities Logo

Beta: This is an early release to gather feedback. Some settings, file formats and the export output may still change before the final version. Please report problems and ideas on the issue tracker.

Easy Model Entities turns Blockbench models into Minecraft entities and block-entities without requiring custom Java code for every model.

It exists to make custom models easier to ship, test, and maintain. Instead of writing a renderer, registering one-off entity classes, and hardcoding animation behavior, you describe the model with data and resource pack profiles. EME provides the host entities, host blocks, renderer integration, profile validation, and a small automatic animation layer.

Install it if you want custom Blockbench models that can appear as ambient creatures, static display entities, decorative block-entities, shrines, mimics, or mod-integrated renderable objects with much less boilerplate.

✨ Why Use It?

No per-model Java required: Define most models with data packs and resource packs.
Entity and block-entity support: Use moving entities for mobs or fixed block-entities for decorations and machines.
Blockbench-friendly workflow: Load bundled .bbmodel assets directly from resource packs.
Profile-driven behavior: Configure host type, body type, dimensions, movement, behavior, rendering, texture, and animation from JSON.
Automatic animation: Basic idle, walk, wing, tail, and random-idle behavior is available out of the box.
Developer API: Mods can use render delegates, custom part animators, and runtime profile data without depending on internal renderer classes.
Diagnostics and demo profiles: Commands help list, validate, debug, spawn, and place test models in a dev world.

🗣 What Can You Build?

Ambient critters, NPCs, training dummies, and simple custom entities.
Static display models that still use Minecraft entity rendering.
Decorative block-entities such as shrines, statues, altars, or mimics.
Mod-controlled entities and block-entities that use EME for model loading, rendering, texture handling, and optional part animation.

ℹ️ Quick Start

After installing the mod, try the bundled demo profiles in a dev or test world:

/easy_model_entities summon easy_model_entities_examples:entity/little_explorer
/easy_model_entities summon easy_model_entities_examples:entity/stone_turtle
/easy_model_entities place_block easy_model_entities_examples:block_entity/shrine

Useful diagnostic commands:

/easy_model_entities list_profiles
/easy_model_entities validate_profiles
/easy_model_entities debug_profile easy_model_entities_examples:entity/little_explorer

More demo commands and explanations are available in the Demo Commands wiki page.

📦 Pack Workflow

Easy Model Entities uses two profile layers:

Server profiles in a data pack decide what the model is and how it behaves.
Render profiles in a resource pack decide which model, texture, scale, bounds, and animation settings are used on the client.

Typical files:

data/<namespace>/easy_model_entities/profiles/entity/<id>.json
data/<namespace>/easy_model_entities/profiles/block_entity/<id>.json

assets/<namespace>/easy_model_entities/render_profiles/<id>.json
assets/<namespace>/easy_model_entities/models/<model>.bbmodel
assets/<namespace>/textures/entity/<texture>.png
assets/<namespace>/textures/block/<texture>.png

See the Pack Usage wiki page for the full structure.

Developer Integration

Mods can integrate EME into their own renderers by implementing EasyModelRenderable and using the client render delegates:

EasyModelEntityRenderDelegate
EasyModelBlockEntityRenderDelegate
EasyModelEntityRenderOptions
EasyModelBlockEntityRenderOptions
EasyModelPartAnimator

Custom part animation can either add to the automatic EME transform or replace it entirely with EasyModelPartAnimationMode.REPLACE.

See the Developer Integration wiki page for examples.

Installation and Compatibility

This branch targets Minecraft 1.20.1 and provides loader-specific modules for Fabric and Forge.

Install the matching loader build on both client and server when profiles, entities, or block-entities are used in multiplayer.

ℹ️ Documentation

Please check the wiki for additional information.

🐛 Report Issues, Bugs, Crashes or Feature Requests

Please report issues and feature requests over the issues link. I'm happy to help you.