skills.rest
Reign-software
Reign-softwareOFFICIAL
Explore all skills by this author →
GitHub

hytale-items

Create and manage custom HJSON-based Hytale items with the Item Registry API.

Updated Jan 19, 2026
Search Tags:#plugin-development#items#interactions#crafting#hytale#json-definition#item-registry
One-click install
npx skills add https://github.com/Reign-software/hyforged --skill hytale-items-reign-software
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hytale-items
Source: https://github.com/Reign-software/hyforged/tree/main/.github/skills/hytale-items
Command: npx skills add https://github.com/Reign-software/hyforged --skill hytale-items-reign-software

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents and guides the creation and management of custom Hytale items, including JSON item definitions, the Item Registry API, crafting recipes, and building item interactions.

Core Features & Use Cases

  • Define custom items with JSON in Server/Item/Items and configure related assets (icons, models, textures) in Common paths.
  • Query and inspect the item registry at runtime using the Item API (e.g., Item.getAssetMap()) and handle unknown items safely.
  • Create crafting recipes by embedding a Recipe block in the item JSON, including time, inputs, and bench requirements.
  • Build custom interactions by extending SimpleInstantInteraction, registering the codec, and linking to items via the Interactions block in the item JSON.
  • Chain and compose interactions with Condition, Charging, Serial, and Replace to create complex item behaviors.

Quick Start

Use the item creation steps: create a new item JSON, add an inventory icon and assets, implement a SimpleInstantInteraction, and link it to the item via the Interactions block.

Frequently Asked Questions about hytale-items

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

FAQPage Schema
How do I create custom Hytale items using JSON definitions?▼

To create custom Hytale items, you define them using JSON in the Server/Item/Items directory and configure related assets like icons and textures in Common paths. This establishes the item's base properties for the server registry.

How do I query the Hytale item registry at runtime?▼

You can query the Hytale item registry at runtime using the Item API, specifically methods like Item.getAssetMap(). This allows your plugin to inspect registered items and safely handle unknown items during server operation.

How do I add crafting recipes to custom Hytale items?▼

You add crafting recipes by embedding a Recipe block directly into the item's JSON definition. This block specifies the crafting time, required inputs, and bench requirements needed to craft the item in-game.

How do I build custom item interactions in Hytale plugin development?▼

You build custom item interactions by extending SimpleInstantInteraction, registering the codec, and linking it to items via the Interactions block in the item JSON definition to trigger specific behaviors.

Can I chain multiple interactions for complex Hytale item behaviors?▼

Yes, you can chain and compose interactions using Condition, Charging, Serial, and Replace patterns. This allows you to create complex, multi-step item behaviors within your Hytale server plugin.

What's the best way to organize assets for a custom Hytale item?▼

The best way to organize assets is to place inventory icons, models, and textures in the Common asset paths while keeping the core JSON item definition in Server/Item/Items. This separation ensures proper asset loading.

Related Skills

Explore More Software Engineering Skills→
JBurlisonJBurlison
13

hytale-blocks

Create custom Hytale blocks with BlockType JSON definitions and asset packs.

Community
Intermediate
JBurlisonJBurlison
13

hytale-items

Documents the Hytale Item Registry API, custom item JSON definitions, crafting recipes, and interaction chaining workflows.

Community
Advanced
Reign-softwareReign-software

hytale-tag-system

Organize and query Hytale asset tags with a hierarchical tag system.

Official
Intermediate
MnkyArtsMnkyArts
5

hytale-custom-items

Define custom Hytale items with JSON asset files.

Community
Intermediate