modding-doc-item-interaction

What problem does it solve?

Create and wire custom items and item interactions in Hytale plugins, bridging item data, client assets, and in-game behavior to streamline plugin development.

Core Features & Use Cases

• Define Server/Item/Items JSON structures to specify items with translations, icons, models, and textures.
• Implement custom interaction classes and codecs in Java and register them for JSON-driven activation and chaining.
• Link interactions to item definitions and compose advanced JSON interaction chains (Condition, Charging, Serial, Replace) for complex behaviors.

Quick Start

Create a basic custom item JSON, a simple interaction class, and register its codec in your plugin, then reference the interaction id in the item JSON to trigger it in-game.