Types - MarkusBordihn/BOs-Easy-NPC GitHub Wiki

NPC Types ๐Ÿค–

Easy NPC supports different kinds of NPC entities depending on what you want to build.

Standard NPCs ๐Ÿฅš

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

Spawn Eggs

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 and Similar Types ๐Ÿ‘ค

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

Doppler NPC ๐Ÿชž

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

Use 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 ๐Ÿงช

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_raw

Raw NPCs do not use the same friendly spawn-egg workflow as the standard NPC lineup.

Integration NPCs ๐Ÿ”Œ

Some NPC types are only available when a supported integration mod is present.

Cobblemon NPC ๐Ÿพ

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

Easy Model NPC ๐Ÿงฑ

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.

Epic Fight NPCs ๐Ÿ—ก๏ธ

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.

Summoning and Ownership ๐Ÿ“œ

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>

Which Screens Each Type Offers ๐Ÿ–ฅ๏ธ

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.
  • experimental means 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.

Choosing the Right Type ๐ŸŽฏ

  • 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
โš ๏ธ **GitHub.com Fallback** โš ๏ธ