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.