hytale-items

Document Hytale's item system, including the Item Registry API and custom item JSON definitions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive documentation and guidance for creating and managing custom items within the Hytale game engine, simplifying the process of item definition, crafting, and behavior implementation.

Core Features & Use Cases

  • Item Registry API: Learn how to query, check existence, and access properties of all items in Hytale.
  • Custom Item Definition: Define new items using JSON, including models, icons, and properties.
  • Crafting Recipes: Create custom crafting recipes with required ingredients and crafting stations.
  • Interaction System: Build complex item behaviors using a data-driven JSON system or custom Java code.
  • Use Case: A mod developer wants to create a new sword with a unique crafting recipe and a special ability that damages enemies on right-click. This Skill guides them through defining the item's JSON, setting up the recipe, and implementing the custom interaction logic.

Quick Start

Use the hytale-items skill to define a new custom item with the ID 'my_custom_sword' that can be crafted using 'Iron_Ingot' and 'Wood_Plank'.

Frequently Asked Questions about hytale-items

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

FAQPage Schema
How do I create a custom item in Hytale using JSON?

To create a custom item in Hytale, define its properties, models, and icons using custom item JSON definitions. You can register the new item to make it available within the game engine.

How does the Hytale Interaction system work for custom item behaviors?

The Hytale Interaction system uses a data-driven JSON structure to build complex item behaviors. You can also implement custom Java interactions, link them to items, and chain interactions using flow control.

How do I query existing items using the Hytale Item Registry API?

You can use the Item Registry API to query and check the existence of items in Hytale. It allows you to access properties of all registered items and work directly with ItemStacks.

What is the best way to define crafting recipes for custom Hytale items?

The best way to define crafting recipes for custom Hytale items is by specifying required ingredients and crafting stations. This integrates your custom items into the game's crafting system.

Can I implement custom Java code for Hytale item interactions instead of JSON?

Yes, you can implement custom Java interactions for Hytale items instead of using the data-driven JSON system. This allows for highly customized item behaviors linked directly through Java code.

How do I chain multiple interactions for a Hytale item?

You can chain multiple interactions for a Hytale item by using flow control within the data-driven Interaction system. This enables the sequencing of complex item behaviors and custom logic.