Troubleshooting
The plugin disabled itself on startup, with a message about Paper's command API
Your server software or version doesn't support what this plugin needs. See Supported platforms — you need Paper or Folia, version 1.20.6 or newer.
The plugin disabled itself and mentioned ProtocolLib
ProtocolLib either isn't installed, or is installed but failed to enable for some other reason. Check your console for ProtocolLib's own startup messages above this plugin's.
"Unable to set value of field" errors in the console
Check your plugins folder for more than one ProtocolLib jar — for example ProtocolLib.jar alongside ProtocolLib (2).jar. Two copies of the same plugin can conflict with each other in ways that produce exactly this kind of error. Delete the older one and restart.
An NPC's nametag shows the wrong text
If you set a display name and it isn't showing, double check you used /npc displayname and not just looking at the NPC's internal /npc create name — those are two different things on purpose, since the internal name has stricter character limits than what you can actually display.
A skin won't load
Confirm the username is spelled correctly and belongs to a real Minecraft account. /npcs skin_cache clear forces a fresh lookup if you suspect a stale result is cached.
Right-clicking does nothing
Confirm the NPC actually has an action configured for the interact trigger — see Actions & triggers. Use /npc info <name> to check what's currently set.
Animations don't play
Animations only play once, immediately, when you run /npc animation — they aren't a persistent state. If you don't see it, you likely weren't looking at the NPC, or weren't close enough to be a "viewer" of it (see Supported platforms for general version requirements that affect packet behavior).