hytale-persistent-data

Store persistent player and entity data using custom components with Codec serialization.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stores persistent data on players and entities across sessions using custom components with Codec serialization, enabling stable state persistence and easy extension for new data types.

Core Features & Use Cases

  • Define persistent components with BuilderCodec and KeyedCodec for structured data.
  • Register and manage components in the runtime EntityStore registry to enable persistence across sessions.
  • Serialize and deserialize component state using BSON-friendly codecs, supporting nested and collection types.

Quick Start

Install the hytale-persistent-data skill into your plugin, register the component with your registry, and begin persisting data immediately.

Frequently Asked Questions about hytale-persistent-data

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

FAQPage Schema
How do I save custom player data across sessions in Hytale plugins?

To save custom player data across sessions in Hytale plugins, use custom components with Codec serialization to store persistent data within the EntityStore registry. This approach ensures stable state persistence by serializing complex data types to BSON.

What is BuilderCodec used for when managing persistent Hytale entity data?

BuilderCodec is used to define persistent components for structured data, enabling stable state persistence and easy extension for new data types. It works alongside KeyedCodec to serialize and deserialize component state using BSON-friendly codecs.

How to serialize complex data types to BSON for Hytale modding workflows?

You serialize complex data types to BSON in Hytale modding workflows by applying BuilderCodec and KeyedCodec to define structured persistent components. These codecs handle nested and collection types during component state serialization and deserialization.

Does this persistent data approach support nested and collection types in Hytale?

Yes, this persistent data approach supports nested and collection types in Hytale by using BSON-friendly codecs for serialization and deserialization. This allows complex data structures to be reliably stored and retrieved across sessions.

How do I retrieve runtime component data using ensureAndGetComponent in Hytale?

You retrieve runtime component data in Hytale by utilizing the ensureAndGetComponent and getComponent methods. These functions interact with the runtime EntityStore registry to retrieve or automatically initialize the required persistent component state.

When do I need registry-based component management for Hytale persistent data?

You need registry-based component management for Hytale persistent data when creating custom components that must persist across sessions. Registering components in the runtime EntityStore enables stable state persistence and structured data retrieval.