CustomModels - MarkusBordihn/BOs-Easy-NPC GitHub Wiki
Easy NPC can render NPCs with alternative entity models on the client.
Custom model rendering changes the visual model on the client. It does not change the server-side entity logic or hitbox calculations.
Every NPC has a render type that decides which renderer draws it:
| Render Type | Meaning |
|---|---|
DEFAULT |
The NPC's own Easy NPC model - the normal case |
CUSTOM |
The Easy NPC model with custom model layers applied |
CUSTOM_ENTITY |
The model of another entity type (used by the Doppler NPC) |
COBBLEMON_ENTITY |
A Cobblemon species model (used by the Cobblemon NPC) |
EASY_MODEL_ENTITY |
An Easy Model Entities profile (used by the Easy Model NPC) |
You normally do not set these by hand - picking an entity, species, or model profile in the
configuration screen selects the matching render type. DEFAULT is the way back:
/easy_npc render set type <NPC> DEFAULTSupported render-entity types are controlled through:
config/easy_npc/render_entity_type_support.cfg
This file is used to allow or block specific entity types for the custom render pipeline.
The main configuration screen includes a Change Model screen for supported NPCs.

Switch the render type:
/easy_npc render set type <NPC> <render_type>Assign a rendered entity model:
/easy_npc render set model <NPC> <entity_type>Example:
/easy_npc render set model ed3cec26-a657-4064-8436-8564fb722d6f minecraft:spiderAssign a Cobblemon species:
/easy_npc render set species <NPC> <species_id>Reset back to the default render type:
/easy_npc render set type <NPC> DEFAULTImportant: render set model only works on Doppler NPCs, render set species only on Cobblemon
NPCs.
The available raw renderer implementations are defined in:
core/Common/src/main/java/de/markusbordihn/easynpc/client/renderer/entity/raw
If a rendered entity type is not supported there or is disabled in the support config, Easy NPC cannot use it as a custom rendered model.
If a third-party model or renderer behaves incorrectly, first verify whether the target entity type is supported by the Easy NPC render pipeline and whether another mod is modifying the renderer in a conflicting way.