CustomModels - MarkusBordihn/BOs-Easy-NPC GitHub Wiki

Custom Models 🕺

Easy NPC can render NPCs with alternative entity models on the client.

General Behavior

Custom model rendering changes the visual model on the client. It does not change the server-side entity logic or hitbox calculations.

Configuration File 📄

Supported 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.

UI Support 🛠️

The main configuration screen includes a Change Model screen for supported NPCs.

Change Model

Commands 📜

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:spider

Reset back to the default render type:

/easy_npc render set type <NPC> DEFAULT

Important: render set model is currently restricted to Doppler NPCs.

Compatibility Notes 🔄

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.

Reporting Issues 🐞

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.

⚠️ **GitHub.com Fallback** ⚠️