hytale-npc-templates

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

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/xDinkyx/Hytale-Colonies-Plugin --skill hytale-npc-templates-xdinkyx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hytale-npc-templates
Source: https://github.com/xDinkyx/Hytale-Colonies-Plugin/tree/main/.github/skills/hytale-npc-templates
Command: npx skills add https://github.com/xDinkyx/Hytale-Colonies-Plugin --skill hytale-npc-templates-xdinkyx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and reference for understanding and utilizing Hytale's JSON-based NPC template and behavior system, enabling the creation of complex and dynamic Non-Player Characters.

Core Features & Use Cases

  • Data-Driven NPC Behavior: Define NPC AI, states, sensors, and actions using structured JSON templates.
  • Template & Variant System: Understand how to create abstract templates and concrete variants for diverse NPC types.
  • Use Case: A game developer can use this Skill to learn how to define a new NPC, such as a guard that patrols a specific area, reacts to threats, and performs combat actions, all through configuration files.

Quick Start

Use the hytale-npc-templates skill to find examples of NPC combat state configurations.

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 AI behavior using JSON templates?

Hytale NPC AI behavior is defined using data-driven JSON templates that structure states, substates, sensors, and actions. You configure template structures and variants to specify how non-player characters detect threats, interact, and transition between behaviors.

What is the difference between an NPC template and a variant in Hytale?

An NPC template in Hytale serves as an abstract blueprint for defining core behaviors, while a variant is a concrete implementation of that template. This system allows developers to create diverse NPC types by reusing base templates with specific variant configurations.

How does the Hytale NPC state transition system work?

The Hytale NPC state transition system works by moving between configured states and substates based on sensor inputs and action outcomes. Templates define specific conditions for transitions, allowing NPCs to shift from patrolling to combat or searching based on environmental detection.

Can I configure NPC combat and detection logic without writing scripts in Hytale?

Yes, you can configure NPC combat and detection logic entirely through JSON templates in Hytale. The behavior system supports data-driven components for sensors, combat actions, inter-NPC interaction, and leashing, eliminating the need for direct scripting.

What components are available for inter-NPC interaction and leashing in Hytale?

Hytale provides reusable instruction components within JSON templates to handle inter-NPC interaction and leashing behaviors. These components allow developers to define boundaries and cooperative actions, ensuring NPCs maintain specific spatial relationships and responses.

What are the limitations of using JSON templates for Hytale NPC behavior design?

The primary limitation of using JSON templates for Hytale NPC behavior is that complex logic must fit within the predefined structure of states, substates, and reusable instruction components. Highly dynamic or procedural behaviors may be constrained by the data-driven configuration boundaries.