godot-combat-system

Implement Godot 4 combat systems with hitboxes, damage, and combos.

488|36|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/thedivergentai/gd-agentic-skills --skill godot-combat-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-combat-system
Source: https://github.com/thedivergentai/gd-agentic-skills/tree/main/skills/godot-combat-system
Command: npx skills add https://github.com/thedivergentai/gd-agentic-skills --skill godot-combat-system

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive framework for implementing complex combat mechanics in Godot Engine, addressing common challenges in action, RPG, and fighting games.

Core Features & Use Cases

  • Hitbox/Hurtbox Architecture: Implement precise collision detection for attacks and damage reception.
  • Damage Calculation: Utilize a DamageData class for flexible and contextual damage application, including armor and resistances.
  • Health & State Management: Manage character health, invincibility, and combat states (attacking, stunned, etc.).
  • Combo & Ability Systems: Create intricate combo chains and manage ability cooldowns.
  • Use Case: Develop a 2D action-platformer where enemies can hit the player, and the player can perform light and heavy attacks, special moves with cooldowns, and block incoming damage.

Quick Start

Use the godot-combat-system skill to implement a health component with a maximum health of 150 and a take_damage function that accepts DamageData.

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 hitbox and hurtbox collision detection in Godot 4?

Hitbox and hurtbox collision detection in Godot 4 is implemented using Area2D nodes to precisely register attacks and damage reception. This architecture decouples attack hitboxes from character hurtboxes, allowing flexible combat interactions.

What is the best way to calculate damage with armor and resistances in GDScript?

Damage calculation in GDScript is handled using a DamageData class, which enables flexible and contextual damage application. This approach supports complex mechanics like armor mitigation and elemental resistances within Godot combat systems.

How do I create a combo system and manage ability cooldowns in Godot?

Combo systems and ability cooldowns in Godot are created using combat state machines to track intricate combo chains. This framework manages state transitions and enforces cooldown timers for special moves.

Can I use this combat framework for both 2D action-platformers and fighting games?

Yes, this combat framework supports 2D action-platformers, RPGs, and fighting games. It provides reusable GDscript components for health management, invincibility frames, and blocking, adapting to various combat contexts.

How do I manage character health, invincibility, and stunned states in Godot?

Character health, invincibility, and stunned states in Godot are managed through dedicated health components and combat state machines. These systems track maximum health, process incoming damage, and enforce temporary invincibility or stun states.