hytale-player-stats

Modify Hytale player and entity stats via EntityStatMap on the world thread.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables developers to read and modify Hytale player/entity stats safely and efficiently, using the EntityStatMap and DefaultEntityStatTypes to manage core attributes like health, stamina, mana, oxygen, signature energy, and ammo.

Core Features & Use Cases

  • Manage core stats via EntityStatMap with operations to set, add, subtract, and reset values.
  • Heal players, apply damage, or adjust resource pools within a plugin with proper world-thread safety.
  • Create stat-related commands and automations that respond to in-game events or admin actions.

Quick Start

Heal a player by restoring health to its maximum using the EntityStatMap.

Frequently Asked Questions about hytale-player-stats

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

FAQPage Schema
How do I read and modify Hytale entity stats like health and mana in plugin development?

You can read and modify Hytale entity stats by using the EntityStatMap to manage core attributes like health, stamina, mana, oxygen, signature energy, and ammo. This allows setting, adding, subtracting, and resetting values programmatically within your plugin.

Does modifying player stats in Hytale require thread-safe updates?

Yes, modifying player stats requires thread-safe updates on the world thread. Performing healing, damage application, or resource pool adjustments directly on the world thread prevents concurrency issues during plugin execution.

What is the best way to heal a player or apply damage using Hytale's DefaultEntityStatTypes?

The best way to heal a player or apply damage is by using the EntityStatMap alongside DefaultEntityStatTypes. You can programmatically add or subtract health values to restore or deplete the player's health pool safely.

Can I create Hytale commands that automatically adjust entity stamina and oxygen levels?

Yes, you can create stat-related commands and automations that respond to in-game events or admin actions. By leveraging the EntityStatMap, plugins can dynamically adjust stamina, oxygen, and other resource pools based on triggers.

Why does my Hytale plugin crash when trying to reset entity ammo or signature energy values?

Crashes often occur if stat modifications are not executed with proper world-thread safety. You must ensure all EntityStatMap operations for resetting ammo or signature energy are applied safely on the world thread to avoid concurrency errors.