Easy Model Entities

# Easy Model Entities  [](https://www.curseforge.com/minecraft/mc-mods/easy-model-entities) [](https://www.curseforge.com/minecraft/mc-mods/easy-model-entities) [](https://modrinth.com/mod/easy-model-entities) [](https://modrinth.com/mod/easy-model-entities) [][issues] [][wiki] ![Easy Model Entities Logo][logo] > **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][issues]. **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. ## Introduction & Overview Video ## ✨ 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. - **Standard keyframe clips**: Blockbench animations named `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). - **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: ```mcfunction /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: ```mcfunction /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](wiki/Demo.md). ## 🧩 Blockbench Plugin 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: ```text 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. ## 📦 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: ```text data//easy_model_entities/profiles/entity/.json data//easy_model_entities/profiles/block_entity/.json assets//easy_model_entities/render_profiles/entity/.json assets//easy_model_entities/render_profiles/block_entity/.json assets//easy_model_entities/models/.bbmodel assets//textures/entity/.png assets//textures/block/.png ``` See the [Pack Usage wiki page](wiki/User-Guide.md) 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](wiki/Developer-Guide.md) for examples. ## Installation and Compatibility 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][wiki] for additional information. ## 🐛 Report Issues, Bugs, Crashes or Feature Requests Please report issues and feature requests over the [issues link][issues]. I'm happy to help you. [wiki]: https://github.com/MarkusBordihn/BOs-Easy-Model-Entities/wiki [issues]: https://github.com/MarkusBordihn/BOs-Easy-Model-Entities/issues [issues]: https://github.com/MarkusBordihn/BOs-Easy-Model-Entities/issues [wiki]: https://github.com/MarkusBordihn/BOs-Easy-Model-Entities/wiki [logo]: https://cdn.modrinth.com/data/ngLoLP1P/08faee3a3c83b5fa2ff546d70ecb67dbd582ec40.png