Troubleshooting

NPC Spawns Without a Skin

Symptoms: Normal NPC appears as Steve. Causes: Skin fetching is asynchronous and the Mineskin API may be slow. Diagnosis: Check console for SocketTimeoutException. Fix: The skin will be cached once it arrives. Wait a moment or execute /menpc setskin again. Verification: Re-logging or respawning the NPC applies the skin instantly from cache.

Interaction Doesn't Work

Symptoms: Nothing happens when clicking an NPC. Causes: The player clicked during a cooldown, or interaction settings are disabled for that click type. Fix: Verify /menpc interaction <id> <clickType> is configured and enabled in the GUI.

Console Action Rejected

Symptoms: Cannot assign a [console] interaction. Causes: Using an unsafe placeholder like {npc_name} or {player_display}, or lacking modelenginenpc.command.interaction.console permission. Fix: Use safe identity placeholders like {player} or {player_uuid}.