modding-doc-combat-log

Capture per-player combat events for HUD display and debugging.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hyforged combat logging is a centralized solution for recording, formatting, and displaying in-game combat events per player, enabling real-time HUD updates and historical review.

Core Features & Use Cases

  • Records CombatEvent data and groups events into CombatEncounter with a 10s timeout for per-player histories.
  • Provides a HUD renderer via CombatLogHudSystem and a formatter for ASCII-based display, plus a /combatlog command for replay.
  • Supports programmatic logging paths, death/xp lines, and per-player state management for debugging and gameplay feedback.

Quick Start

Install and enable the modding-doc-combat-log unit to start recording and displaying combat events on the HUD.

Frequently Asked Questions about modding-doc-combat-log

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

FAQPage Schema
How do I capture and display combat events on a player HUD in Hyforged?

To capture and display combat events on a player HUD in Hyforged, enable the modding-doc-combat-log unit to route CombatEvent data through CombatLogHudSystem for real-time rendering during gameplay and testing.

What is a CombatEncounter and how does the timeout work for combat logging?

A CombatEncounter is a grouped history of per-player combat events with a 10-second timeout, meaning the system finalizes the encounter log if no new combat events are recorded within that window.

Can I replay combat logs during gameplay to review previous encounters?

Yes, you can replay combat logs during gameplay by using the /combatlog command, which accesses the per-player historical state managed by the CombatLogService to display past events.

Does the combat logging system support programmatic logging paths for debugging?

The combat logging system supports programmatic logging paths for debugging, allowing developers to record death and XP lines while managing per-player state for gameplay feedback.

How do I format combat log data for ASCII-based display?

You format combat log data for ASCII-based display by passing CombatEvent records through the built-in formatter, which structures the text before the HUD renderer outputs it to the screen.