Turn Blockbench models into simple Minecraft entities without writing Java code.
Model to Entity side-by-side
Model to Entity Example
Note: 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.
.bbmodel assets directly
from resource packs.idle, walk,
swim, fly, or attack are played automatically. hurt and death are
loaded but only play when driven by a command or a mod. Clips with any other
name are ignored to keep the runtime simple (no state machines, no Molang).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
/easy_model_entities set_animation @e[distance=..8] walk
More demo commands and explanations are available in the Demo Commands wiki page.
You can write the profile JSON by hand, but the [Easy Model Entities Exporter][plugin] does it for you: it exports the current Blockbench project as a ready-to-install data pack and resource pack, detects a fitting preset from your bone names, and validates the model before writing anything.
Two ways to get it:
Blockbench plugin list (recommended): File > Plugins > Available, search
for Easy Model Entities. This is the reviewed release, so new versions can
take a while to appear there.
Development version: use File > Plugins > Load Plugin from URL with this address:
https://raw.githubusercontent.com/MarkusBordihn/BOs-Easy-Model-Entities-Blockbench-Plugin/refs/heads/master/plugins/easy_model_entities/easy_model_entities.js
This is the current master state — newer, but it may contain errors and is
not reviewed.
Easy Model Entities uses two profile layers:
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/entity/<id>.json
assets/<namespace>/easy_model_entities/render_profiles/block_entity/<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.
Mods can integrate EME into their own renderers by implementing
EasyModelRenderable and using the client render delegates:
EasyModelEntityRenderDelegateEasyModelBlockEntityRenderDelegateEasyModelEntityRenderOptionsEasyModelBlockEntityRenderOptionsEasyModelPartAnimatorCustom 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.
Install the matching loader build on both client and server when profiles, entities, or block-entities are used in multiplayer.
Please check the wiki for additional information.
Please report issues and feature requests over the issues link. I'm happy to help you.