NPC Commands

NPC spawning and AI management commands from NPCPlugin.

Namespace: hytale.command.npc.*

Can be disabled/replaced: Yes, via /plugin unload

Files

File	Commands	Description
npc.md	All /npc subcommands	Complete NPC management

Command Categories

Spawning

• /npc spawn <role> - Spawn NPCs with various options
• /npc all - Spawn all NPC roles in a grid
• /npc test probe - Test position validity (air, water, collision)

Management

• /npc clean - Remove all NPCs
• /npc freeze / /npc thaw - Freeze/unfreeze NPCs
• /npc dump - Dump NPC data (supports --json)

AI & Behavior

• /npc appearance - Change NPC model
• /npc attack - Override attack behavior
• /npc blackboard - AI state inspection (11 subcommands)
• /npc flock - Flocking behavior (uses view cone targeting)
• /npc path - Pathfinding commands
• /npc role - Get/set NPC role
• /npc give - Give items to NPCs
• /npc message - Send messages to NPC AI

Debugging

• /npc debug - Debug flag management
• /npc step - Step frozen NPC behavior
• /npc benchmark - Performance benchmarking
• /npc sensorstats - Sensor statistics

View Cone Targeting

Several commands (/npc flock) use view cone targeting instead of entity IDs:

• Affects NPCs within 8 blocks
• Must be within 30 degree angle of player’s view

Quick Examples

/npc spawn Wolf --count=5           # Spawn 5 wolves
/npc spawn Trork --frozen           # Spawn frozen NPC
/npc freeze                         # Freeze all NPCs
/npc step --all                     # Step all frozen NPCs once
/npc debug set pathfinding          # Enable pathfinding debug
/npc dump --json                    # Dump looked-at NPC as JSON