create-component

Create Component

Generate a reusable component as a scene + script. Composition pattern: drop the component as a child of the entity that should "have" the behavior.

Save scenes to scenes/components/<name>.tscn and scripts to scripts/components/<name>.gd.

HealthComponent

Decoupled HP from the entity. Any entity that can take damage drops one in.

scripts/components/health_component.gd:

class_name HealthComponent
extends Node

signal health_changed(old: int, new: int)
signal died
signal revived

@export var max_health: int = 100
@export var invulnerable: bool = false

var current_health: int

func _ready() -> void:
    current_health = max_health

func take_damage(amount: int, _source: Node = null) -> void:
    if invulnerable or current_health <= 0:
        return
    var prev := current_health
    current_health = maxi(0, current_health - amount)
    if current_health != prev:
        health_changed.emit(prev, current_health)
    if current_health == 0:
        died.emit()

func heal(amount: int) -> void:
    if current_health <= 0:
        return
    var prev := current_health
    current_health = mini(max_health, current_health + amount)
    if current_health != prev:
        health_changed.emit(prev, current_health)

func revive(amount: int = -1) -> void:
    var was_dead := current_health == 0
    current_health = max_health if amount < 0 else mini(max_health, amount)
    if was_dead:
        revived.emit()
    health_changed.emit(0, current_health)

func get_health_ratio() -> float:
    return float(current_health) / float(max_health) if max_health > 0 else 0.0

scenes/components/health_component.tscn: Node root, attach the script.

HurtboxComponent (2D and 3D variants)

Receives damage. Attach as child Area2D / Area3D with a CollisionShape sibling.

scripts/components/hurtbox_component_2d.gd:

class_name HurtboxComponent2D
extends Area2D
## Receives damage. Forwards to a HealthComponent reference.

@export var health_component: HealthComponent
@export var damage_modifier: float = 1.0  ## e.g. 0.5 = takes half damage

func _ready() -> void:
    area_entered.connect(_on_area_entered)

func _on_area_entered(area: Area2D) -> void:
    if area is HitboxComponent2D and health_component:
        var dmg := int(area.damage * damage_modifier)
        health_component.take_damage(dmg, area.owner)