UHT 규칙 계약

Reflection UPROPERTY 선언 점검표

언리얼 리플렉션 매크로는 문법 장식이 아니라 UHT가 클래스를 발견하고 에디터와 블루프린트에 연결하는 계약입니다.

UCLASS UPROPERTY UFUNCTION UHT

클래스 계약

UCLASS와 GENERATED_BODY가 있어야 엔진 타입 시스템에 클래스가 등록됩니다.

속성 계약

UPROPERTY 지정자는 직렬화, 편집 가능 여부, 블루프린트 읽기 권한을 정합니다.

함수 계약

UFUNCTION은 블루프린트 호출, 이벤트 구현, 네트워크 RPC 같은 노출 경로를 엽니다.

빌드 신호

generated.h 위치나 매크로 누락 오류는 일반 C++보다 리플렉션 계약부터 의심합니다.

매크로를 많이 붙이는 것이 목표가 아닙니다. 에디터가 알아야 하는 클래스, 저장해야 하는 값, 호출해야 하는 함수만 정확히 노출하세요.