godot-combat-system

Implement modular Godot combat with DamageData, HealthComponent, and Hitbox/Hurtbox patterns.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/yyypasserby1102/ghost --skill godot-combat-system-yyypasserby1102
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-combat-system
Source: https://github.com/yyypasserby1102/ghost/tree/main/.opencode/skills/godot-combat-system
Command: npx skills add https://github.com/yyypasserby1102/ghost --skill godot-combat-system-yyypasserby1102

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Building robust and reusable combat systems in Godot can be error-prone due to ad-hoc implementations of health, damage, hit detection, and state logic. This Skill provides a modular blueprint that standardizes how damage flows through a HealthComponent, applies invulnerability windows, and orchestrates combat states and effects.

Core Features & Use Cases

  • Component-based Hitbox/Hurtbox architecture for reliable collision and damage handling.
  • DamageData-driven damage, knockback, and invincibility frame support to ensure consistent combat feel across enemies and players.
  • HealthComponent with signals for health changes, death, and healing, enabling clean UI and gameplay reactions.
  • Combat State Machine, combo system, and ability framework to support a variety of enemy and player behaviors in action RPGs and fighters.
  • Clear examples and patterns (combat_system_patterns.gd and hitbox_hurtbox.gd) to accelerate integration into Godot projects.

Quick Start

Wire the provided Hitbox, Hurtbox, and HealthComponent patterns into your player or enemy to prototype combat immediately.

Frequently Asked Questions about godot-combat-system

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

FAQPage Schema
How do I implement a modular combat system in Godot?

A modular combat system in Godot uses a component-based architecture with DamageData, HealthComponent, and Hitbox/Hurtbox patterns to standardize damage flow, health tracking, and combat state transitions across entities.

What is the best way to handle hit detection and damage calculation in Godot?

The best way to handle hit detection and damage calculation in Godot is by using a DamageData-driven approach combined with Hitbox and Hurtbox components to ensure consistent collision handling and combat feel.

Can I use this combat state machine pattern for action RPGs and fighting games in Godot?

Yes, this Godot combat state machine pattern explicitly supports action RPGs and fighting games by providing a flexible framework for combos, abilities, and enemy behaviors within a standardized health and damage flow.

How do I manage invulnerability frames and knockback in a Godot combat system?

You manage invulnerability frames and knockback in a Godot combat system by passing them as parameters within DamageData objects, allowing the HealthComponent to apply invincibility windows and physical responses consistently.

Why does my Godot combat logic break when coordinating health changes and death states?

Godot combat logic breaks from ad-hoc implementations, but using a HealthComponent with dedicated signals for health changes, death, and healing ensures clean UI updates and reliable gameplay state transitions.

Do I need external dependencies to build a component-based health and damage system in Godot?

No external dependencies are needed to build this component-based health and damage system in Godot, as it relies entirely on internal scripts and standardized component patterns for immediate integration.