modding-doc-combat

根据Modding_Doc/Combat中的文档指引，为Hyforged战斗系统提供指导。在新增伤害类型、疾病状态、治疗效果，或从Modding_Doc/Combat中集成CombatService时使用。触发关键词：战斗、伤害、疾病状态、暴击、格挡、治疗、DamageSpec、CombatService、模组文档。

name: modding-doc-combat description: Doc-derived guidance for the Hyforged Combat system. Use when adding damage types, ailments, healing, or integrating CombatService from Modding_Doc/Combat. Triggers - combat, damage, ailment, critical, block, healing, DamageSpec, CombatService, modding doc.

Modding Doc: Combat

This skill summarizes Modding_Doc/Combat at a high level and links to the full references.

Documentation References

•Combat System Overview — Concepts, pipeline, JSON schemas, configuration
•Combat API Reference — CombatService, DamageSpec, HealingService

Doc-Derived How-To (Adding Combat Features)

•Define damage type extensions in src/main/resources/Server/<YourMod>/Damage/ with resistance and penetration stat IDs plus element tags.
•Define ailments in src/main/resources/Server/<YourMod>/Combat/Ailments/ for threshold-based status effects.
•For abilities or skills, build a DamageSpec and call CombatService.applyDamage(...) using a CommandBuffer.
•For healing, use HealingSpec with HealingService.applyHealing(...) (bypasses combat defenses).
•Validate using CombatConfig debug logging and the combat log commands described in the Modding_Doc.

Notes:

•Keep everything data-driven and namespaced; avoid hard-coded values.
•Ensure related stats exist in the Stats system (resistance, penetration, crit, block, healing).