hytale-npc-templates

Document Hytale's JSON-based NPC template and behavior system.

13|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/JBurlison/Hytale-Mod-Agent --skill hytale-npc-templates
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hytale-npc-templates
Source: https://github.com/JBurlison/Hytale-Mod-Agent/tree/main/.github/skills/hytale-npc-templates
Command: npx skills add https://github.com/JBurlison/Hytale-Mod-Agent --skill hytale-npc-templates

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to defining and implementing NPC behavior in Hytale using JSON-based templates, enabling the creation of complex AI for game characters.

Core Features & Use Cases

  • NPC Behavior Definition: Design NPC AI, including states, sensors, actions, and motions.
  • Template & Variant System: Understand how to create abstract templates and specific NPC variants.
  • Combat & Detection Logic: Configure NPC combat mechanics, threat detection, and inter-NPC interactions.
  • Use Case: You need to create a new type of enemy NPC for your Hytale mod. Use this Skill to define its idle behavior, how it detects players, its attack patterns, and its reactions to damage.

Quick Start

Use the hytale-npc-templates skill to understand how to define an NPC's 'Idle' state and its associated actions.

Frequently Asked Questions about hytale-npc-templates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define Hytale NPC behavior using JSON templates?

Hytale NPC behavior is defined through JSON templates that structure states, substates, sensors, actions, and motions into a data-driven AI system. You create abstract templates and specific variants to control character behavior.

How does NPC detection and combat work in Hytale modding?

NPC detection in Hytale modding uses sensors for sight and hearing, while combat logic configures melee attacks, attack chaining, and damage checks. State transitions dictate how an NPC shifts from detection to combat behaviors.

Can I create reusable instruction components for Hytale NPCs?

Yes, you can build reusable instruction components and sensors in Hytale NPC templates. The system supports Component_Instruction and Component_Sensor structures to standardize behaviors like Standard_Detection across multiple NPC variants.

What is the best way to configure state transitions for Hytale NPC AI?

The best way to configure Hytale NPC AI state transitions is to define StateTransitions within your JSON template, specifying how an NPC moves between idle, chase, and combat substates based on sensor inputs and timeout actions.

How do NPC groups and beacons handle inter-NPC interaction in Hytale?

Inter-NPC interaction in Hytale is managed using beacons and AttitudeGroup configurations. These components define how NPCs communicate, group together, and set their DefaultPlayerAttitude and InteractionVars.

How do I set up leashing and searching behavior for a Hytale NPC?

Leashing and searching behaviors are set up in Hytale NPC templates using Soft_Leash parameters and Intelligent_Chase states. These define how far an NPC wanders from its spawn point and how it queries the environment.