📜 Health Bar System 코드 문서

개요

res://common_hpbar/
이 코드는 Godot 엔진에서 ProgressBar를 활용한 체력 시스템을 구현합니다. Health Bar는 플레이어의 현재 체력을 나타내며, Damage Bar는 데미지를 시각적으로 지연된 효과로 표현합니다. Timer를 사용하여 Damage Bar 업데이트에 지연을 추가해, 체력 감소를 시각적으로 강조합니다.

---

속성

• timer (Timer 노드): 데미지 효과의 시각적 지연을 관리합니다. 데미지가 발생하면 타이머가 시작되어 일정 시간이 지난 후에 Damage Bar가 업데이트됩니다.

• damage_bar (ProgressBar 노드): Health Bar와는 별도로, 데미지를 반영하기 위해 지연된 상태로 체력 감소를 시각적으로 표시하는 ProgressBar입니다.

• health (int): 플레이어의 현재 체력을 나타내는 변수입니다. 이 변수는 _set_health 함수를 통해 값이 설정됩니다.

---

함수

func init_health(_health: int) -> void

• 설명: 플레이어의 초기 체력 값을 설정하는 함수입니다.
• 매개변수:
  • _health: 초기 체력 값.
• 동작:
  • health 변수에 _health 값을 할당하여 플레이어의 체력을 초기화합니다.
  • max_value와 value 속성을 설정하여 Health Bar와 Damage Bar가 초기 체력을 표시하도록 합니다.

func _set_health(new_health: int) -> void

• 설명: health 값을 업데이트하고, 데미지가 발생한 경우 타이머를 작동시키는 setter 함수입니다.
• 매개변수:
  • new_health: 업데이트할 체력 값.
• 동작:
  • new_health 값을 health에 설정하고, value 속성을 업데이트합니다.
  • health가 0 이하로 떨어지면 노드를 삭제합니다.
  • health가 감소한 경우(prev_health보다 낮아진 경우), timer가 작동하여 Damage Bar에 시각적 지연 효과를 제공합니다.
  • health가 감소하지 않은 경우에는 Damage Bar의 value를 즉시 health와 동일하게 설정합니다.

func _on_timer_timeout() -> void

• 설명: 타이머 시간이 종료되었을 때 호출되는 함수입니다. Damage Bar가 Health Bar의 체력 값을 따라가도록 업데이트합니다.
• 동작:
  • damage_bar.value를 health와 동일하게 설정하여 두 막대가 일치하도록 만듭니다.

---

코드 흐름

1. init_health 함수가 호출되어 초기 체력 값을 설정합니다.
2. 체력 값이 변경될 때마다 _set_health 함수가 호출됩니다.
   • 체력이 감소했을 경우, 타이머가 시작되고 지연 후에 _on_timer_timeout 함수가 실행됩니다.
3. _on_timer_timeout 함수가 실행되면 Damage Bar가 Health Bar와 동일한 값으로 설정됩니다.

---

참고 유튜브 주소

📼 https://youtu.be/f90ieBOoIYQ?si=nyOZOAt1t7tkZuJk

---

후원

🍻 맥주 개발자를 위한 후원 링크

더 많은 개발 팁과 경험담이 필요하신 분들은 제 소셜 채널도 확인해 주세요!

🌲Link tree

혹시라도 저에 대해서 더 알고 싶으시다면! 🕵️🍻 About Redping