Types - MarkusBordihn/BOs-Easy-NPC GitHub Wiki
Easy NPC supports different kinds of NPC entities depending on what you want to build.
Standard NPCs are the normal Easy NPC entities used by most players. They are available as spawn eggs and support the regular feature set such as:
- dialogs
- trading
- actions
- equipment
- poses
- objectives

The current lineup:
- Humanoid: Humanoid, Humanoid (slim), Orc, Ork Warrior, Fairy, Villager, Wandering Trader, Zombie Villager, Iron Golem
- Illager: Evoker, Illusioner, Pillager, Vindicator, Witch
- Undead: Zombie, Husk, Drowned, Zombified Piglin, Skeleton, Stray, Bogged, Wither Skeleton
- Piglin: Piglin, Piglin Brute
- Animal: Cat, Chicken, Fox, Pig, Wolf, Horse, Skeleton Horse, Zombie Horse
- Other: Allay, Vex, Enderman, Creeper, Spider, Cave Spider, Slime, Ghast
Humanoid-style NPCs are usually the best choice when you want:
- player or remote skins
- armor and held items
- custom poses
- player heads and decorative equipment
The Doppler NPC is a shapeshifter: instead of a fixed model it renders the model of another entity type. Pick the entity in the model configuration screen, or set it with a command:
/easy_npc render set model <NPC> minecraft:spiderUse it when you want an NPC that looks like an existing mob but keeps the Easy NPC dialog, trading, and action setup. Which entity types are allowed is controlled by the server, see CustomModels.
The Doppler NPC does not support the custom pose editor โ it borrows the target entity's renderer and animations.
Raw NPCs are mainly intended for modders and special technical setups. They behave more like their underlying vanilla mob and are not the normal choice for gameplay maps.
You can summon them directly, for example:
/summon easy_npc:zombie_rawRaw NPCs do not use the same friendly spawn-egg workflow as the standard NPC lineup.
Some NPC types are only available when a supported integration mod is present.
When Cobblemon is installed, Easy NPC adds a Cobblemon NPC type. This NPC can use Cobblemon species visuals - including male, female, and shiny variants - while still using the normal Easy NPC configuration flow.
Use it when you want:
- Cobblemon-themed quest NPCs
- starter or healer NPCs
- Pokemon-style shop or dialog characters
When Easy Model Entities is installed, Easy NPC adds an Easy Model NPC type. It renders any entity profile provided by a resource pack and data pack, so you can bring your own Blockbench model into the game without writing Java code.
This is the type to pick when none of the built-in models fits your character. It is also the only integration type that supports the custom pose editor.
When Epic Fight is installed, Easy NPC registers additional [EF] spawn eggs (for example
[EF] Humanoid, [EF] Skeleton, [EF] Pillager). These NPCs use Epic Fight combat behavior and
animations instead of the vanilla combat system.
See ModIntegration for setup examples and current limitations of all integrations.
You can also create NPCs with /summon, but NPCs spawned that way do not automatically get an
owner.
/summon easy_npc:husk
/easy_npc owner set <NPC> <player>Not every NPC type has every configuration screen. A missing screen is intentional - it would have no effect on that type.
| NPC Type | Skins | Poses | Scaling | Objectives | Model Selection |
|---|---|---|---|---|---|
| Standard | yes | yes | yes | yes | - |
| Humanoid | yes | yes | yes | yes | - |
| Doppler | - | - | - | yes | Entity type |
| Cobblemon | - | - | - | yes | Species |
| Easy Model | - | custom pose | yes | yes | Model profile |
| Epic Fight | yes | experimental | experimental | experimental | - |
| Raw | yes | yes | yes | - | - |
Notes:
- Doppler, Cobblemon, and Easy Model NPCs get their look from the selected model, so the skin screens are hidden.
- Easy Model NPCs with humanoid arms and legs also get the default, basic, and advanced pose screens.
-
experimentalmeans the screen appears once Experimental Features is enabled in the main configuration screen. Epic Fight brings its own animation and combat system, which is why those screens can conflict. - Raw NPCs keep the behavior of their underlying vanilla mob, so the objective screens are hidden.
Dialogs, trading, actions, equipment, and attributes work on all of these types.
- Pick a standard NPC for most gameplay use cases
- Pick a humanoid NPC if skins, armor, or player heads matter
- Pick a Doppler NPC if it should look like an existing mob
- Pick an Easy Model NPC if you have your own Blockbench model
- Pick a raw NPC only for advanced or technical scenarios
- Pick an integration NPC when a supported mod adds a better-fitting specialized type