Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion plugins.json
Original file line number Diff line number Diff line change
Expand Up @@ -1569,5 +1569,23 @@
"repository": "https://github.com/hrmcngs/sb-worn-display-blockbench",
"bug_tracker": "https://github.com/hrmcngs/sb-worn-display-blockbench/issues",
"creation_date": "2026-05-31"
}
},
"easy_model_entities": {
"title": "Easy Model Entities",
"author": "Markus Bordihn",
"icon": "icon.png",
"description": "Export Blockbench models for the Easy Model Entities mod (Minecraft: Java Edition) as ready-to-install Data Pack and Resource Pack files.",
"tags": ["Minecraft: Java Edition", "Format", "Entity"],
"version": "1.0.0",
"min_version": "4.9.0",
"variant": "desktop",
"await_loading": true,
"has_changelog": true,
"contributes": {
"formats": ["eme_entity"]
},
"website": "https://www.curseforge.com/minecraft/mc-mods/easy-model-entities",
"repository": "https://github.com/MarkusBordihn/BOs-Easy-Model-Entities",
"bug_tracker": "https://github.com/MarkusBordihn/BOs-Easy-Model-Entities/issues"
}
}
18 changes: 18 additions & 0 deletions plugins/easy_model_entities/LICENSE.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
MIT License

Copyright (c) 2026 Markus Bordihn

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
83 changes: 83 additions & 0 deletions plugins/easy_model_entities/about.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
# Easy Model Entities

> **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](https://github.com/MarkusBordihn/BOs-Easy-Model-Entities/issues).

Turn your Blockbench model into a Minecraft entity you can spawn in game — without writing a mod.
The plugin exports a Data Pack and a Resource Pack for the **Easy Model Entities** mod on
**Minecraft: Java Edition**.

This plugin only generates the pack files. The **Easy Model Entities mod must be installed** in
Minecraft for them to work, and on the server as well in multiplayer. Without the mod the generated
files do nothing.

- [CurseForge](https://www.curseforge.com/minecraft/mc-mods/easy-model-entities)
- [Modrinth](https://modrinth.com/mod/easy-model-entities)

## What you get, and what you do not

Your model becomes a spawnable entity or a block entity, with a spawn item in the creative
inventory. Size, movement and behavior come from a **fixed set of presets** built into the mod
(wandering, swimming, flying, standing still and so on) — you pick one, you do not script your own.

Animations are played from your Blockbench clips. These names are played automatically:

| Clip | When it plays |
|----------|----------------------|
| `idle` | standing still |
| `walk` | moving on the ground |
| `swim` | moving in water |
| `fly` | flying |
| `attack` | attacking |
| `sit` | sitting |

`hurt` and `death` clips are loaded too, but the mod does not trigger them on its own. Clips with
any other name are kept as custom clips and are played by name via the
`/easy_model_entities animation` command or by another mod. A model without a matching clip simply
renders without animation.

## How to use

1. Open or create your model in Blockbench using the **Easy Model Entity** format (File > New > Easy
Model Entity). The built-in **Modded Entity** format also works. Block and item formats are not
supported.
2. Run **File > Export > Export Easy Model Entity**.
3. Choose the **Export Type**:

- **Complete: Data Pack + Resource Pack (ZIP)** — one archive with both packs and a README that
explains how to install them. Use this the first time and for sharing.
- **Update: Resource Pack only (ZIP)** — after changing the model, texture or animations.
- **Update: Data Pack only (ZIP)** — after changing entity data such as size or movement.
- **Standalone: write into mod project** — writes all files into a selected `src/main/resources`
directory.
- **Model only: mod integration (no data pack)** — writes only the render profile, model and
texture. Use this when your mod ships its own entity classes and needs the visual side only.

4. Choose the **Type** (not shown for *Model only*, which is always an entity):

- **Entity** — a living entity controlled by the mod's built-in AI presets.
- **Block Entity** — a static block that can play animations.

5. Pick a **Preset** that matches your model. The plugin auto-detects a fitting one from your bone
names, so most models need nothing else. Tick **Customize settings** (requires the *Show advanced
customization* Blockbench setting) only to fine-tune dimensions, movement, attributes, rendering
or animation.
6. Set the **Namespace (mod id)** and **Profile ID**, and choose the Minecraft target version.
7. If the project uses textures from another namespace, **Include external textures** decides
whether they are copied into the resource pack (default) or only referenced. Referenced textures
need the mod or pack that provides them; vanilla `minecraft:` textures are never copied.

The two update exports save you from re-installing both packs for a small change. They keep the
pairing of your last full export, so the updated pack still matches the one already installed. If
you changed the model **and** the entity data, export the complete bundle instead.

Exported settings are saved inside the `.bbmodel` project and restored on the next export.

## Blockbench settings

Two optional settings under **File > Preferences > Settings > Export**:

- **Show advanced customization** — unlocks the *Customize settings* checkbox in the export dialog.
- **Show experimental presets** — reveals presets that the mod loads but whose specialized movement
or behavior is still in development. Off by default.
22 changes: 22 additions & 0 deletions plugins/easy_model_entities/changelog.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
{
"1.0.0": {
"title": "Early release for testing and feedback",
"author": "Markus Bordihn",
"date": "2026-06-13",
"categories": [
{
"title": "Features",
"list": [
"Export the current project as Easy Model Entities Data Pack and Resource Pack files.",
"Preset auto-detection from bone names (humanoid, quadruped, aquatic, winged, arthropod, cuboid, floating, static).",
"Entity and Block Entity support.",
"Update exports for a single pack: re-export only the resource pack after model, texture or animation changes, or only the data pack after entity data changes.",
"Export into a mod project, or model-only for mod integrations.",
"Minecraft target versions 1.20.1, 1.21.1, 1.21.11, 26.1.2 and 26.2.",
"Optional advanced customization of dimensions, movement, behavior, attributes, rendering and animation.",
"Validation with blocking errors and performance budget warnings, including unusable texture locations and missing textures."
]
}
]
}
}
Loading