hytale-tag-system

Document Hytale's hierarchical tag system and AssetRegistry API usage.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill clarifies Hytale's complex hierarchical tag system, enabling developers to efficiently implement tag-based lookups, define tagged assets, and understand tag expansion patterns within the Hyforged framework.

Core Features & Use Cases

  • Hierarchical Tag Structure: Understand how categories and values form a queryable tag map.
  • Tag Expansion: Learn how tags are expanded into searchable strings for flexible querying.
  • AssetRegistry API: Utilize integer indices for fast O(1) tag lookups.
  • Hyforged Stat API: Leverage convenience methods for category-based and index-based stat queries.
  • Use Case: When defining a new item or stat in Hytale, use this Skill to correctly structure its tags for optimal discoverability and game logic integration.

Quick Start

Consult the documentation to understand how to use the AssetRegistry to get or create tag indices for Hytale assets.

Frequently Asked Questions about hytale-tag-system

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

FAQPage Schema
How does the Hytale tag system work for querying assets?

The Hytale tag system uses a hierarchical structure where categories and values form a queryable tag map. It expands tags into searchable strings to enable flexible asset querying within the Hyforged framework.

How do I get or create tag indices using the AssetRegistry API?

You use the AssetRegistry API to get or create integer indices for Hytale assets. This mechanism maps tags to integers, enabling fast O(1) lookups for your game logic integration.

What is the best way to define tagged assets and stats in Hytale?

The best way to define tagged assets and stats is by leveraging the Hyforged Stat API. It provides convenience methods for category-based and index-based queries, ensuring optimal discoverability and logic integration.

Can I use the Hyforged framework for category-based stat queries?

Yes, the Hyforged Stat API supports category-based and index-based stat queries. It allows developers to efficiently structure item tags and retrieve specific stat definitions through a queryable tagging mechanism.

Why does my Hytale asset lookup return incorrect tag expansions?

Incorrect tag expansions often occur when the hierarchical category and value structure is misconfigured. You must ensure tags follow the documented expansion rules to generate correct searchable strings for the AssetRegistry.