hytale-events

Implement Hytale event handling with IEvent, IAsyncEvent, and EcsEvent.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/Reign-software/hyforged --skill hytale-events-reign-software
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hytale-events
Source: https://github.com/Reign-software/hyforged/tree/main/.github/skills/hytale-events
Command: npx skills add https://github.com/Reign-software/hyforged --skill hytale-events-reign-software

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents Hytale's event system for handling game events in plugins. Covers IEvent (global events), IAsyncEvent (async events), and EcsEvent (ECS entity/block events). Use when listening to player join/disconnect, chat, crafting, damage, block break/place, entity death, or any server event. Triggers - event, IEvent, IAsyncEvent, EcsEvent, CancellableEcsEvent, EntityEventSystem, EventRegistry, registerGlobal, registerAsync, PlayerReadyEvent, PlayerDisconnectEvent, PlayerChatEvent, BreakBlockEvent, PlaceBlockEvent, Damage, CraftRecipeEvent, DropItemEvent, DeathSystems, OnDeathSystem, event handler, event listener.

Core Features & Use Cases

  • Supports IEvent, IAsyncEvent, and EcsEvent event categories.
  • Demonstrates registration, handling, and cancellation patterns.
  • Includes examples for player join, chat, block events, crafting, and death handling.

Quick Start

Register global, async, and ECS events in a plugin to start handling Hytale server events.

Frequently Asked Questions about hytale-events

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

FAQPage Schema
How do I register an event listener for a Hytale plugin to handle player joins?

To handle player joins in a Hytale plugin, register PlayerReadyEvent using registerGlobal. This IEvent listener executes custom logic immediately when a player successfully connects to the game server.

What is the difference between IEvent, IAsyncEvent, and EcsEvent in Hytale?

IEvent handles global synchronous server events, IAsyncEvent manages asynchronous operations, and EcsEvent processes entity or block-related events. Choosing the right Hytale event type depends on whether your logic requires thread safety or interacts with the ECS.

How do I cancel a block break or item drop event in a Hytale server plugin?

To cancel block break or item drop events in a Hytale plugin, implement CancellableEcsEvent within your EcsEvent handler. This intercepts BreakBlockEvent or DropItemEvent and prevents the default game behavior from executing.

Can I use ECS event systems to handle entity death and damage in Hytale?

Yes, you can use ECS event systems to handle entity death and damage in Hytale. By registering OnDeathSystem and Damage EcsEvent handlers, your plugin can listen to combat interactions and execute custom logic upon entity defeat.

How do I intercept player chat messages in a Hytale plugin?

To intercept player chat messages in a Hytale plugin, register a global event listener for PlayerChatEvent. This IEvent handler captures chat input from connected players, allowing you to modify, log, or cancel the message before it broadcasts.

Do I need a specific folder structure to set up a Hytale event handling plugin?

Yes, setting up a Hytale event handling plugin requires a root SKILL.md file with valid YAML frontmatter specifying name and description. You can also include optional resources folders for scripts, references, and assets to support your event handlers.