7강. AttributeSet 설계와 Attribute의 역할

?1. 이번 강의에서 해결할 문제

Health, AttackPower, Damage를 모두 같은 영구 수치로 만들면 데미지 계산의 중간값이 복제되고 저장되거나, 임시 Buff가 Base 값을 영구 변경합니다. Attribute가 나타내는 상태와 변경 수명을 먼저 분류해야 합니다.

✓2. 학습 목표

✓이 강의를 마치면

• Base Value와 Current Value를 구분합니다.
• 영구 Attribute와 Meta Attribute를 나눕니다.
• Attribute 직접 변경 대신 Effect 흐름을 선택합니다.

◇3. 핵심 개념

FGameplayAttributeData는 Base와 Current 값을 관리합니다. Instant Effect는 일반적으로 Base를 변경하고 Duration·Infinite Modifier는 활성 중 Current에 영향을 주며 종료 시 되돌아갑니다. Damage처럼 계산 입력을 잠시 전달하고 Health로 소비한 뒤 0으로 되돌리는 값은 Meta Attribute로 둘 수 있습니다.

§4. 구현

공통 접근자 매크로를 프로젝트 Header에 정의합니다.

GASAttributeSet.h

#pragma once

#include "AttributeSet.h"
#include "AbilitySystemComponent.h"

#define ATTRIBUTE_ACCESSORS(ClassName, PropertyName) \
    GAMEPLAYATTRIBUTE_PROPERTY_GETTER(ClassName, PropertyName) \
    GAMEPLAYATTRIBUTE_VALUE_GETTER(PropertyName) \
    GAMEPLAYATTRIBUTE_VALUE_SETTER(PropertyName) \
    GAMEPLAYATTRIBUTE_VALUE_INITTER(PropertyName)

Attribute를 책임별로 분류합니다.

Resource: Health, MaxHealth, Mana, MaxMana
Combat Stat: AttackPower, Defense, CriticalChance
Meta: IncomingDamage, IncomingHealing
Derived/Optional: MoveSpeedMultiplier

게임 규칙이 독립적으로 변경되는 대규모 프로젝트는 HealthSet, CombatSet처럼 나눌 수 있지만, 작은 데모에서는 한 Set이 더 읽기 쉽습니다. 여러 Set을 쓸 때 같은 Attribute를 중복 정의하지 않습니다.

→5. 코드가 동작하는 이유

접근자 매크로는 Reflection Property와 값 Getter·Setter·Initializer를 일관되게 제공합니다. Meta Attribute를 영구 상태와 분리하면 Execution Calculation이 계산 결과를 전달하고 AttributeSet이 방어·무적·사망 같은 최종 규칙을 한곳에서 처리할 수 있습니다.

§6. 실패 사례와 해결

!자주 하는 실수

• Damage를 Health처럼 저장·복제: 처리 뒤 0으로 비우는 Meta Attribute로 사용합니다.
• Buff가 Base 공격력을 영구 변경: Duration Modifier로 Current 값을 변경합니다.
• AttributeSet을 기능마다 무조건 분리: 변경 이유와 소유 주기가 실제로 다를 때 나눕니다.
• Actor 코드에서 Setter 직접 호출: 초기화 외 변경은 서버 Gameplay Effect 경로를 우선합니다.

✎7. 직접 실습

✎직접 실습

최종 데모 수치 10개를 Resource, Combat Stat, Meta, Derived로 분류하고 Base·Current 중 어느 값이 변하는지 적으세요. Buff 종료 뒤 되돌아가야 할 값도 표시합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Base Value와 Current Value는 어떤 수명 차이가 있나요?
2. IncomingDamage를 Meta Attribute로 두는 이유는 무엇인가요?
3. Attribute를 일반 Setter로 직접 바꾸는 경로가 늘어나면 무엇을 잃나요?

■9. 핵심 요약

■핵심 요약

Attribute는 영구 수치, 임시 Modifier와 계산용 Meta 값을 구분해야 합니다. 다음 강의에서는 체력·마나·공격력·방어력을 RepNotify 가능한 실제 AttributeSet으로 구현합니다.