Function Library
함수 라이브러리 분리 결정표
함수 라이브러리는 어디서나 부를 수 있는 작은 도구 모음입니다. 인스턴스 상태를 바꾸는 로직까지 넣으면 결합이 오히려 커집니다.
넣기 좋음입력 기반 계산Pure 함수데이터 조회 보조
남겨야 함액터 상태 변경입력 이벤트 처리월드 인스턴스 소유 로직
01호출 범위여러 블루프린트에서 반복되는지 먼저 확인합니다.
02입출력 계약필요한 값은 입력 핀으로 받고 결과는 출력 핀으로 돌려줍니다.
03상태 분리액터 변수 변경은 호출한 블루프린트 안에 남깁니다.
04검색 이름BFL_ 접두사와 용도 중심 이름으로 검색 가능하게 만듭니다.
후보
판정
이유
주의
거리 계산
라이브러리 적합
Actor 두 개를 받아 Float 반환
유효성 검사
데이터 Row 조회
조건부 적합
반복 조회를 캡슐화 가능
실패 분기 반환
문 열기
액터 내부 유지
컴포넌트와 상태를 직접 변경
소유자 책임
좋음작은 순수 도구
입력만 보고 결과를 반환하므로 어디서 불러도 예측 가능합니다.
주의월드 참조
World Context가 필요하면 실패 처리와 호출 범위를 함께 문서화합니다.
위험상태 변경 집중
모든 액터 로직을 라이브러리에 몰면 디버깅 위치가 사라집니다.