와악

TIL - 101

이시보 — Wed, 8 Jul 2026 22:55:48 +0900

인벤토리(WBP_InventoryPanel / InventoryPanelWidget) 작업

1. 장비 슬롯 버튼 툴팁이 마우스에 붙어 안 사라지던 문제

위치: NativeTick()
원인: 툴팁 강제 닫기 안전장치가 그리드만 검사 → 슬롯 버튼 호버 중 매 틱 CloseToolTip()이 불려 Slate 상태머신이 꼬임.
변경: 조건을 그리드 호버 || 슬롯 버튼 호버 통합으로 확장. 두 영역 어디에도 호버가 없을 때만 CloseToolTip() 호출.
- Button_SlotHead/Weapon/Chest/Hands_L/Hands_R/Legs/Feet를 IsWidgetOrDescendantHovered로 검사(null 안전).

2. 장비 교체 확인 창이 뜰 때 그리드 툴팁 잔상 제거

위치: ShowWeaponSwapConfirm(bShow=true)
원인: 더블클릭 시 마우스가 그리드 아이템 위에 있어 툴팁이 남음. 매 틱 CloseToolTip은 재소환 싸움을 일으켜 커서를 따라다님(회귀).
변경: 창이 뜨는 순간(엣지) 호버 중인 그리드 슬롯의 툴팁을 ClearWidgetTooltipRecursive로 제거 + CloseToolTip() + MarkInventoryTooltipsDirty().
- 창이 닫히고 마우스가 슬롯을 벗어나면 ApplyInventorySlotTooltips가 툴팁을 복구.

3. 교체 확인 창을 마우스 커서 옆에 표시

추가 함수: PositionConfirmDialogNearCursor(UWidget* DialogWidget)
- 커서 절대좌표 → 부모 Canvas 로컬좌표 변환(+12,+12 오프셋), 화면 밖으로 안 나가게 클램프.
- 앵커/정렬을 좌상단(0,0)으로 고정 후 UCanvasPanelSlot::SetPosition.
적용: 장비 교체 창(Border_WeaponSwapConfirm), 퀵슬롯 교체 창(Border_QuickSlotReplaceConfirm) 모두 커서 옆에 표시.
include 추가: Components/CanvasPanelSlot.h

4. 퀵슬롯 교체 창이 퀵슬롯 휠에 가려지던 z-order 문제

배경: 인벤토리 패널 z50, 퀵슬롯 휠 z80 → 패널 안(z50)의 교체 창이 휠(z80) 뒤에 깔림.
변경:
- HandleQuickSlotWheelSlotClicked에서 교체 확인 시 휠을 HitTestInvisible + z49(패널 아래)로 재배치(RemoveFromParent → AddToViewport(49)), bQuickSlotWheelLowered = true.
- 신규 헬퍼 RestoreQuickSlotWheelZOrder(): 휠을 원래 z80으로 복원.
- ConfirmQuickSlotReplace / CancelQuickSlotReplace에서 복원 호출(취소 시 휠 다시 Visible).
멤버 추가: bool bQuickSlotWheelLowered
⚠️ 주의: 휠을 패널 아래로 내리므로 패널 배경이 불투명하면 휠이 가려질 수 있음(필요 시 교체 창을 뷰포트 최상단으로 올리는 방식으로 전환).

5. 사용 버튼(Button_UseConsumable) — 소모품일 때만 표시

헤더: Button_UseConsumable을 BindWidgetOptional로 선언(WBP 위젯명 일치 필요).
위치: UpdateEquipActionButtons()
변경: 선택 아이템이 소모품일 때만 Visible, 그 외 Collapsed. 활성화는 CanUseSelectedConsumable()(보유 수량>0).
클릭 동작은 기존 WBP 처리 유지(가시성만 C++ 제어).
⚠️ WBP에 이 버튼 Visibility 바인딩이 있으면 제거해야 충돌 없음.

TIL - 100

이시보 — Tue, 7 Jul 2026 21:13:49 +0900

Manager_Interactor "Accessed None: OwnerController" 크래시

원인

OwnerController는 비복제 + 컴포넌트 BeginPlay에서만 캐싱됨.
서버→클라 RPC Client_Update_PointOfInterests가 그 BeginPlay보다 먼저 도착하면 None을 읽어 크래시 → 초기화 순서 레이스(코옵/조인·레벨 시작 시).
플러그인 버그 아님. 컴포넌트 위치·설정은 정상.

수정 (플러그인 미변경)

프로젝트 PC ARetrievePlayerController의 PostInitializeComponents(BeginPlay/RPC보다 먼저 실행)에서 리플렉션으로 OwnerController를 미리 세팅해 레이스 창 제거.

RetrievePlayerController.h

virtual void PostInitializeComponents() override;

RetrievePlayerController.cpp (익명 namespace 헬퍼 + 오버라이드)

void PrimeInteractorOwnerController(APlayerController* PC)
{
    if (!PC) return;
    TInlineComponentArray<UActorComponent*> Components(PC);
    for (UActorComponent* Comp : Components)
    {
        if (!Comp || !Comp->GetClass()->GetName().Contains(TEXT("Manager_Interactor"))) continue;
        if (FObjectProperty* OwnerProp =
            FindFProperty<FObjectProperty>(Comp->GetClass(), TEXT("OwnerController")))
        {
            OwnerProp->SetObjectPropertyValue_InContainer(Comp, PC);
        }
        break;
    }
}

void ARetrievePlayerController::PostInitializeComponents()
{
    Super::PostInitializeComponents();
    PrimeInteractorOwnerController(this); // OwnerController 선캐싱
}

TIL - 99

이시보 — Mon, 6 Jul 2026 23:09:45 +0900

루멘(Lumen) 이슈 정리

1. 쉬핑 패키징에서 루멘이 플레이어를 못 따라옴

증상: PIE는 정상, 쉬핑 빌드에서 특정 구역에서 거의 못 따라옴 (적 AI도 특정 구역 동일)
원인: 레벨 RecastNavMesh의 Runtime Generation이 Static이었음.
- 프로젝트는 bGenerateNavigationOnlyAroundNavigationInvokers=True (플레이어 인보커 주변만 런타임 네비메시 생성) 사용.
- 이 방식은 RuntimeGeneration = Dynamic이어야 동작. Static이면 런타임 생성이 안 돼 네비메시 구멍 → MoveToActor 실패 → 루멘은 2초마다 텔레포트 복구로만 붙음.
- PIE는 에디터가 네비메시를 항상 갖고 있어 문제가 가려졌던 것.
수정: RecastNavMesh Runtime Generation = Static → Dynamic
- 레벨에 배치된 RecastNavMesh 액터가 있으면 그 액터 Details에서 변경 후 레벨 저장
- 없으면 Project Settings ▸ Navigation Mesh ▸ Runtime Generation = Dynamic (DefaultEngine.ini에 반영)
검증: Development 설정으로 패키징 → 콘솔 show Navigation → 죽었던 구역에 네비메시 생성되는지 확인
주의: 네비메시는 플레이어 인보커 30m 버블 + NavMeshBoundsVolume 커버 구역에만 생성됨 (bounds 없는 구역은 Dynamic이어도 안 됨)

2. 특정 선 너머로 가면 루멘이 사라짐 (에디터 + 쉬핑 공통)

증상: 플레이어가 특정 선을 넘으면 루멘이 사라지고, 돌아오면 다시 생김
원인: 루멘(BP_LumenCharacter)이 P_Level_WP에 직접 배치된 액터이고 World Partition Spatially Loaded 상태.
- WP는 배치 액터를 edit-time 위치의 셀에 귀속 → 런타임에 이동해도 셀이 안 바뀜.
- 플레이어가 그 원본 셀의 스트리밍 범위를 벗어나면 셀 언로드 = 루멘 디스폰. 돌아오면 재로딩 = 재생성.
- WP 스트리밍은 PIE에서도 돌기 때문에 에디터에서도 재현됨 (쉬핑 전용 아님).
수정: P_Level_WP에서 배치된 BP_LumenCharacter 선택 → Details ▸ World Partition ▸ Is Spatially Loaded 체크 해제 → 레벨 저장
- (대안: 배치 대신 GameMode/PlayerController에서 런타임 스폰 → 자동 always-loaded)
같이 확인: 루멘이 리전별로 켜졌다 꺼지는 Data Layer에 할당돼 있지 않은지 (있으면 always-loaded 레이어로 이동)

TIL - 98

이시보 — Thu, 2 Jul 2026 21:03:02 +0900

BGM 시스템

개요

상황에 따라 BGM을 자동 전환하는 시스템. 세션 상태(메뉴/게임/결과), 전투 여부, 지역(존)에 따라
트랙을 고르고, 두 오디오 슬롯을 크로스페이드로 전환한다. 각 트랙은 개별 볼륨 배수를 가진다.

우선순위: 세션 상태(메뉴/결과) > 지역(존) > 전투 > 기본

구성 요소

FRetrieveMusicTrack: 사운드(TSoftObjectPtr<USoundBase>) + 볼륨 배수(0~2). 전역 설정·존 볼륨 공용.
URetrieveMusicSettings (UDeveloperSettings): Project Settings > Retrieve > Retrieve Music.
- MenuBGM / DefaultBGM / CombatBGM / ResultBGM, CrossfadeDuration, LoopGapSeconds
URetrieveMusicSubsystem (UWorldSubsystem): 재생·전환의 중심. 슬롯 A/B 크로스페이드.
ARetrieveMusicZoneVolume (AActor + UBoxComponent): 특정 구역 전용 BGM 볼륨.

상태별 BGM (세션)

메뉴는 별도 레벨이 아니라 ERetrieveSessionState로 관리됨. Channel.Session.StateChanged 구독으로 전환 감지.

세션 상태	BGM
MainMenu	`MenuBGM` (게임플레이 존/전투 무시)
Result	`ResultBGM`
Loading	무음(보류)
InGame	지역 > 전투 > 기본

전투 BGM 판정

진입: Channel.Enemy.PlayerSpotted로 적이 나(로컬 플레이어)를 포착한 순간. 포착한 몬스터를 교전 집합에 추가.
- 공격 발동·무기 장착만으로는 진입하지 않음.
유지/해제: 0.5초 폴링으로 교전 집합에서 파괴됨 / State.Enemy.Dead / State.Enemy.Chase 없음인
몬스터를 제거 → 집합이 비면(= 나를 추적하는 몬스터가 하나도 없으면) 기본 BGM 복귀.

지역(존) BGM

ZoneBGM(평상시) / bUseCombatMusic(토글) / ZoneCombatBGM(전투)
존 안 + bUseCombatMusic + 전투 중 + 전투곡 지정됨 → ZoneCombatBGM, 아니면 ZoneBGM
사운드 미지정 존 안에서는 무음 (기본 BGM이 새어나오지 않음)
진입/이탈은 오버랩 이벤트 + 직접 확인(RefreshPlayerOverlap) 병행

볼륨 (3단 구조)

최종 음량 = 트랙 볼륨 배수(에디터) × 음악 볼륨 슬라이더(옵션) × 마스터 볼륨

트랙 볼륨: FRetrieveMusicTrack.Volume — 파일별 음량 편차 보정
옵션 슬라이더: BGM 슬롯의 SoundClassOverride = MusicSoundClass로 기존 SoundMix 볼륨 시스템과 자동 연동

리루프

곡이 자연 종료되면 LoopGapSeconds 뒤에 같은 곡 재생(간격을 둔 반복)
주의: 사운드 에셋의 루프를 꺼야(원샷) 이 로직이 동작함. 에셋이 무한 루프면 간격 없이 이어짐.

해결한 주요 이슈

전투 종료 판정 — State.Player.Combat 태그(마지막 활동 후 3.5초) → 추적 몬스터 집합(추적 적 0이면 해제)으로 교체.
시작 지점 존이 무음 안 되던 문제 — 메뉴 경유로 시작 시 possess/카메라 전환 과정에서 존 진입 오버랩 이벤트가
누락됨. 해결: 존이 서브시스템에 자가등록(BeginPlay) + InGame 진입 후 0.3초×10회 재평가(RefreshPlayerOverlap,
GetOverlappingActors로 이벤트 비의존 직접 확인).
볼륨 적용 시 BGM 사라짐 — BGM 슬롯의 bIsUISound = true가 SoundMix 볼륨 적용과 충돌 → 해당 플래그 제거.

에디터 설정

Project Settings → Retrieve → Retrieve Music
- Menu / Default / Combat / Result BGM의 Sound 지정 + Volume 배수 조정
- Crossfade Duration(기본 1.5초), Loop Gap Seconds(기본 3초)
지역에 Retrieve Music Zone Volume 배치
- Box Extent를 구역 전체로, Zone BGM 지정 (필요 시 Use Combat Music + Zone Combat BGM)
- World Partition 레벨이면 Is Spatially Loaded 끄기 권장
(연동 확인) Retrieve Settings → Audio → Music Sound Class 지정 시 옵션 음악 볼륨 슬라이더가 BGM에 적용됨

TIL - 97

이시보 — Wed, 1 Jul 2026 22:13:06 +0900

BGM 시스템 (기본 / 전투 / 성 지역)

개요

배경음악을 상황에 따라 자동 전환하는 시스템. 우선순위는 성 지역 > 전투 > 기본이며,
두 개의 오디오 슬롯을 크로스페이드해 부드럽게 전환한다.

구성 요소

URetrieveMusicSettings (UDeveloperSettings): Project Settings에서 기본/전투 BGM 에셋과 크로스페이드 시간 지정.
URetrieveMusicSubsystem (UWorldSubsystem): 재생/전환/전투 판정의 중심. 슬롯 A/B 크로스페이드.
ARetrieveMusicZoneVolume (AActor + UBoxComponent): 성 구역처럼 특정 영역 전용 BGM을 재생하는 볼륨.

동작 규칙

성 지역(존): 볼륨 안에 있으면 전투 여부와 무관하게 ZoneBGM이 최우선.
전투 BGM 진입: Channel.Enemy.PlayerSpotted로 적이 나(로컬 플레이어)를 포착한 순간.
- 공격 발동·무기 장착만으로는 진입하지 않음.
전투 BGM 유지/종료: 나를 포착한 몬스터를 교전 집합에 넣고, 0.5초 주기로
파괴됨 / State.Enemy.Dead / State.Enemy.Chase 없음인 몬스터를 걷어낸다.
- 집합이 비면(= 추적하는 몬스터가 하나도 없으면) 기본 BGM으로 복귀 (최대 0.5초 내).
볼륨 연동: Retrieve Settings > Audio > Music Sound Class가 지정돼 있으면
기존 옵션 메뉴의 음악 볼륨 슬라이더가 BGM에도 그대로 적용됨.

상황	결과
적이 나를 포착	전투 BGM 진입
포착한 적이 계속 추적 중	전투 BGM 유지
적이 죽음 / 추적 포기(도망·흥미 잃음)	해당 적을 집합에서 제거
추적하는 적이 하나도 안 남음	기본 BGM 복귀
성 볼륨 안에 진입	전투 여부 무시하고 성 BGM

에디터 설정

Project Settings → Retrieve → Retrieve Music
- Default BGM / Combat BGM 에셋 지정 (USoundBase: Wave/Cue/MetaSound 모두 가능)
- Crossfade Duration (기본 1.5초)
성 구역에 Retrieve Music Zone Volume 배치
- Box Extent를 성 구역 전체를 덮도록 조정
- Zone BGM에 성 전용 트랙 지정
- World Partition 레벨이면 Is Spatially Loaded 끄기 권장 (경계에서 언로드로 오버랩 놓침 방지)
(선택) Retrieve Settings → Audio → Music Sound Class 지정 시 볼륨 슬라이더 연동

TIL - 96

이시보 — Tue, 30 Jun 2026 21:37:31 +0900

검방패 사운드 작업 정리

0. 한 줄 요약

검방패 콤보어택 스윙 사운드를 랜덤 큐 + 몽타주 노티파이로 구현·검증 완료
히트음/설정볼륨연동/CastSound/소환액터음은 방식 확정 후 보류 또는 진행 예정.

1. 완료된 작업 (monolith로 적용·저장·검증)

1-1. 랜덤 Sound Cue 2개 생성 — `/Game/Retrieve/Audio/SwordShield/`

큐	구성	변조
`SC_SSH_ComboSwing` (스윙)	`SW_Whoosh_Metal_4-1/2/3/5/7` → Random	Pitch 0.9~~1.1, Vol 0.85~~1.0, Randomize Without Replacement
`SC_SSH_SwordHit` (히트)	`SW_Sword_Hit_1-1/3/4` + `SW_Generic_Hit_1-1/4` → Random	Pitch 0.92~~1.08, Vol 0.9~~1.0

원본 wav 위치: Content/External/NaPH_RPG_Fantasy_Sounds_Bunle/Weapons_and_Combat/wav/
구조: WavePlayer(N) → Random → Modulator → Output
큐 안에는 cue(SC_)가 아니라 wav(SW_)를 넣음. cue = 레시피(랜덤/변조), wav = 재료.

1-2. 스윙 노티파이 9개 배치 (3 몽타주 × 콤보 3타)

Play Sound 노티파이를 각 콤보 타의 슬래시 VFX(PlayNiagaraEffect)와 같은 시점, SlashEffect 트랙에 배치 → SC_SSH_ComboSwing 연결

몽타주	스윙 시점(초)
`AM_SSH_WindComboAttack`	0.352 / 2.141 / 3.645
`AM_SSH_FireComboAttack`	0.344 / 2.125 / 3.641
`AM_SSH_WaterComboAttack`	0.810 / 2.166 / 3.977

검증: find_audio_references(SC_SSH_ComboSwing) → 위 3개 몽타주 모두 참조 확인 ✅

2. 핵심 아키텍처 (참고)

콤보 사운드 = 2개 레이어 (기존 VFX 패턴과 동일):

스윙(휘두르기) → 콤보 몽타주의 Play Sound AnimNotify (= 슬래시 VFX와 같은 위치)
히트(타격) → GCN_Hit_Impact GameplayCue (= 히트 VFX와 같은 위치)

콤보 구동: GA_Attack이 FWeaponComboStep.SectionName별로 몽타주 섹션을 따로 재생.
→ 노티파이는 반드시 해당 섹션 시간 범위 안에 있어야 그 타에서 울림.

3. 남은 작업 (TODO)

3-1. 히트음 — `GCN_Hit_Impact`에 연결 (보류: 읽기전용)

GCN_Hit_Impact (/Game/Retrieve/AbilitySystem/GameplayCues/), 타입 GameplayCueNotify_Static, tag GameplayCue.Combat.Hit
Burst Sounds 배열이 없는 타입 → OnExecute 그래프에 Play Sound at Location 노드 추가 필요
- Sound = SC_SSH_SwordHit
- Location = 기존 NS_Hit_Impact(Spawn System at Location)가 쓰는 위치 핀과 동일하게 연결 (보통 Parameters.Location)
막힌 이유: GCN_Hit_Impact.uasset이 읽기전용 → 해제 후 진행 (attrib -r 또는 속성창)

3-2. 설정 볼륨(SFX 슬라이더) 연동 — 미설정 상태

현재 ApplyAudio()는 SoundMix + SoundClass override 방식인데 SoundMix/SoundClass 애셋이 프로젝트에 미할당 → Master 슬라이더만 작동, SFX 등 개별 채널은 무효
연동하려면:
1. SoundMix 1개 + SoundClass 계층 생성 (Master 루트 → SFX/Music/Ambience/UI/Voice 자식)
2. Project Settings → Game → "Retrieve Settings"에서 SettingsSoundMix / 각 채널 SoundClass 할당
3. 큐들(SC_SSH_ComboSwing/SC_SSH_SwordHit/SC_SSH_HeavySwing)의 Sound Class = SFX로 지정
코드 위치: Source/Retrieve/Settings/RetrieveSettingsSubsystem.cpp (ApplyAudio), RetrieveSettingsConfig.h

3-3. CastSound — 미연결(dead field)

FSkillCombination::CastSound(RetrieveDataTableTypes.h:857), FWeaponHeavyAttack::CastSound(:1331) 둘 다 코드에서 안 읽힘
BeginBurstSkill(Row)이 9개 필드만 복사하고 CastSound는 복사 안 함 → 데이터 넣어도 무동작

살리려면 ①C++: BeginBurstSkill에 아래 추가(재컴파일 필요), 또는 ②시전 몽타주에 AnimNotify

if (USoundBase* Cast = Row->CastSound.LoadSynchronous())
    if (const AActor* O = GetOwner())
        UGameplayStatics::PlaySoundAtLocation(O->GetWorld(), Cast, O->GetActorLocation());

참고: FBurstHitInstance::HitSound(per-hit)는 이미 작동 중(PlayerBurstComponent.cpp:400)

3-4. 소환 액터(WorldSpawnActor) 사운드 → 액터 BP에 (몽타주 아님)

이유: 월드 액터는 Owner + 정면*WorldSpawnDistance(플레이어에서 떨어진 곳)에 스폰됨. 몽타주 노티파이는 캐릭터 위치에서 울려 위치가 틀림. BurstWorldActorBase 설계도 "비주얼은 BP 자식 SceneRoot 아래 추가".
방법(에디터, WorldSpawnActorClass가 가리키는 BP):
- 권장: Audio Component 추가(SceneRoot 아래), Sound=큐, Auto Activate=true → 스폰 위치에서 재생·따라다님·파괴 시 자동정지
- 또는 일회성: Event BeginPlay → Play Sound at Location (Location=GetActorLocation)
퇴장(가라앉기)음은 BeginSink가 private C++라 BP 훅 불가 → 필요시 별도 C++ 노출

4. 트러블슈팅

4-1. `BP_FFF_WorldActor` 저장 에러 (RF_Standalone 누락)

에러: ... does not have any of the provided object flags (0x10000002)
의미: BP 오브젝트에 RF_Standalone(0x2) / RF_HasExternalPackage(0x10000000) 둘 다 없음 → 최상위 애셋으로 인식 안 돼 저장 거부. (자동화/복제로 생성된 BP에서 흔함)
해결 A(작업 유지): 에디터 콘솔에 save.FixupStandaloneFlags 1 입력 → 저장(Ctrl+S). 한 번 저장되면 영구 수정. (안 먹으면 -dpcvars=save.FixupStandaloneFlags=1 인자로 재실행)
해결 B(확실): 깨진 BP 삭제 → BurstWorldActorBase 부모로 Blueprint Class 재생성 → 컴포넌트 재추가

5. 주의/리마인더

⚠️ 사운드 번들 Content/External/NaPH_RPG_Fantasy_Sounds_Bunle/가 git 미추적 → 새 큐가 이 wav 참조하므로 번들 커밋(또는 팀 공유) 필수, 안 그러면 팀원 쪽 참조 깨짐
새 큐는 추적 경로 Content/Retrieve/Audio/SwordShield/에 저장됨
Wind 몽타주에 빈 Sound 트랙 잔재 가능(첫 시도 부산물, 무해)
스윙음이 슬래시와 동시 재생 — 더 "치고 나가는" 느낌 원하면 노티파이 1~2프레임 앞당김

TIL - 95

이시보 — Mon, 29 Jun 2026 21:46:32 +0900

전투 VFX 작업

1. 상태이상 VFX (Burn / Cold)

방식: 머티리얼 overlay 틴트 + Niagara 파티클 (GameplayCue 기반)
태그: GameplayCue.Status.Burn / GameplayCue.Status.Cold (네이티브, RetrieveGameplayTags)
머티리얼: M_StatusOverlay(부모, Unlit·Additive·Fresnel 발광) + MI_StatusBurn / MI_StatusFrost
notify: GCN_Status_Burn/Cold (Looping)
- OnActive: 타깃 메시에 SetOverlayMaterial + NS 스폰
- OnRemove: overlay 해제 + 스폰 컴포넌트 정리
몸 전체 커버: NS에 Skeletal Mesh Location 모듈 + User.Mesh DI
- CPU sim은 메시에 Allow CPU Access 필요 → GPU sim으로 전환해 해결
1초 주기 펄스: EmitterState Loop 1s + SpawnBurst + SpawnRate off

2. 타격 임팩트 VFX (Hit Impact)

방식: 데미지 GE에 burst GameplayCue
태그: GameplayCue.Combat.Hit (네이티브)
연결: GE_BasicHitDamage → Gameplay Cues 컴포넌트에 태그 추가
notify: GCN_Hit_Impact (burst / GameplayCueNotify_Static)
- OnExecute: 타격 지점에 임팩트 NS 스폰
- 위치는 Params.Location이 비어 있음 → EffectContext의 HitResult ImpactPoint/Normal 사용
발광: VFX_Color를 HDR(>1)로 + Bloom 활성
원소별 색: EffectContext → Get Instigator Actor → PlayerState → GetCurrentElementTag → 색 매핑 → VFX_Color(활성화 전 세팅)

핵심 함정

GameplayCue/태그는 네이티브로 관리 (RetrieveGameplayTags + 리빌드). monolith 런타임 config 태그 핫-추가는 GameplayTags.dll 크래시 유발.
GameplayCueNotify OnRemove: 사망 시 MyTarget·스폰 컴포넌트가 무효화될 수 있음 → IsValid 가드 필수.
Niagara DI / User 파라미터(메시·색)는 Activate 전에 세팅 (비활성 스폰 → set → Activate). 안 그러면 첫 버스트에 안 먹음.
GE로 발동된 cue의 Params.Location은 자동으로 안 채워짐 → EffectContext의 HitResult에서 가져올 것.
Static cue에서 GetPlayerState(인덱스)는 월드 컨텍스트가 없어 실패 → EffectContext의 Instigator 사용.
CPU Niagara 스켈레탈 메시 샘플링은 Allow CPU Access 필요, GPU sim이면 불필요.

TIL - 94

이시보 — Fri, 26 Jun 2026 21:13:11 +0900

GAS에서 지속 데미지(Burn)가 매 틱 피격 리액션을 유발하는 문제

증상

플레이어가 몬스터에게 Burn(GE_Burn)을 부여하면, 몬스터가 화상 데미지를 받는 매 틱마다 움찔(Flinch) 거리는 현상.

원인 분석

Burn은 Periodic(주기) 데미지라 틱마다 PostGameplayEffectExecute → BroadcastHitEvent가 호출된다.

BroadcastHitEvent는 공격 GE의 asset tag를 읽어 두 개의 이벤트를 발행한다.

구분	매칭 베이스 태그	Burn에서의 값
공격자 이벤트	`GameplayEvent.Attack.HitSuccess`	`GameplayEvent.Attack.HitSuccess.Burn` ✅
타겟 이벤트	`GameplayEvent.Hit`	Burn엔 `Hit.` 태그가 없어 기본값 `GameplayEvent.Hit.Normal`로 떨어짐* ⚠️

→ 타겟(몬스터)에게 매 틱 GameplayEvent.Hit.Normal이 전송됨
→ HitReactionComponent::HandleHitEvent 수신
→ ResolveReactType에서 HitReact.Type.* 태그가 없으면 기본값 Flinch 반환
→ 결국 Burn 틱마다 Flinch 발동

핵심: 피격 리액션 억제는 GE 데미지 처리(CombatAttributeSet) 단계에서 발행되는 GameplayEvent.Hit 이벤트가 트리거다. 데미지 계산과 리액션 발행이 같은 함수에 묶여 있다.

해결

BroadcastHitEvent에서 공격 이벤트가 DoT(Burn)면 타겟 Hit 이벤트만 건너뛴다. 데미지 / 플로터 / AI 인지는 그대로 유지.

EventData.EventTag = AttackerEventTag;
UAbilitySystemBlueprintLibrary::SendGameplayEventToActor(AttackerActor, AttackerEventTag, EventData);

// Burn 등 지속 데미지(DoT)는 데미지만 적용하고 피격 반응(움찔/몽타주)은 발생시키지 않는다.
const bool bIsDamageOverTime =
    AttackerEventTag.MatchesTag(RetrieveGameplayTags::GameplayEvent_Attack_HitSuccess_Burn);

if (TargetActor != AttackerActor && !bIsDamageOverTime)
{
    EventData.EventTag = TargetEventTag;
    UAbilitySystemBlueprintLibrary::SendGameplayEventToActor(TargetActor, TargetEventTag, EventData);
}

결과

항목	Burn 틱	일반 공격
데미지	✅	✅
데미지 플로터	✅	✅
AI 인지	✅	✅
피격 리액션	❌ (차단)	✅

배운 점 / 확장

MatchesTag를 써서 ...Burn.X 하위 태그가 생겨도 자동 커버.
데미지 적용 vs 피격 반응을 분리해서 생각해야 한다 — "데미지를 받되 리액션은 안 함"은 이벤트 발행 단계에서 타겟 이벤트만 막는 것으로 해결.
추후 독·감전 등 DoT 추가 시 bIsDamageOverTime 조건에 || AttackerEventTag.MatchesTag(...) 한 줄씩 추가.

TIL - 93

이시보 — Tue, 23 Jun 2026 22:05:19 +0900

전투/UI

데미지 플로터가 뜨는 조건 (GAS)

데미지 GE가 ExecCalc_BasicHitDamage → IncomingDamage 메타 어트리뷰트를 거쳐야 CombatAttributeSet::BroadcastHitEvent가 Channel.Combat.DamageDealt를 발행한다.
BroadcastHitEvent는 GE의 GameplayEvent.Attack.HitSuccess.* 태그를 뽑아 그걸 키로 DT_HitFeedback을 조회(없으면 .Light 폴백). 매칭 행이 없으면 AttackFeedbackComponent가 플로터를 건너뛴다.
⇒ 새 공격에 플로터를 띄우려면: 데미지 GE에 HitSuccess.* 태그 + 해당 태그의 DT_HitFeedback 행 추가. 태그를 나누면(버스트 .Burst, 번 .Burn) 플로터를 따로 연출 가능.

원소모드 = ASC loose tag

현재 원소(불/물/바람)는 PlayerState::GetCurrentElementTag() = ASC의 Element.* loose 태그.
버스트/흡수는 게이지 슬롯 조합이 아니라 이 "현재 모드"로 결정. 게이지 슬롯은 원소 구분 없는 충전 칸이고, 색은 현재 모드 하나로 통일.

도트(DoT)는 사망 시 직접 제거해야 함

주기형 GE(GE_Burn)는 대상이 죽어도 계속 틱 → 시체에서 플로터가 계속 뜬다.
사망 처리(HealthComponent::HandleHealthChanged, 권위 측)에서 ASC->RemoveActiveEffectsWithGrantedTags({State.Status.Burn})로 제거하면 멈춤.

UMG: 수동 RenderTransform은 위젯 애니에 덮어써진다

SetRenderScale() 직후 위젯 애니(RiseFade)가 같은 Render Transform(Scale 채널/트랜스폼 전체)을 키프레임하면 수동 스케일이 무시된다.
⇒ 애니는 위치+불투명도만 키, Scale은 빼거나 / 스케일은 부모·텍스트로 분리해 곱연산.

TIL - 92

이시보 — Wed, 17 Jun 2026 22:46:50 +0900

다중 Row 드랍 & 인벤토리 직접 지급

개요

적 사망 시 여러 드랍 Row를 각각 확률 굴림하여, 마지막으로 공격한 플레이어의 인벤토리로 직접 지급한다. (아이템 액터 스폰 없음)

주요 변경

1. 데이터 구조 — `RetrieveDataTableTypes.h`

FEnemyDropRow: ItemTag(FGameplayTag) → ItemId(FName) + ItemCategoryTag(FGameplayTag) (인벤토리 키와 일치)
FMonsterDataRow: DropRow(FName) → DropRows(TArray<FName>)

2. 드랍 처리 — `DropComponent.h/.cpp`

Initialize(UDataTable*, const TArray<FName>&) — 배열 수신
ProcessDrop(): 서버 권한 확인 → 마지막 공격자 폰의 InventoryComponent 확보 → DropRows 각 행을 DropChance로 독립 굴림 → AddItem(ItemId, ItemCategoryTag, Quantity)

3. 적용 지점 — `RetrieveEnemyCharacter.cpp`

InitializeComponents()에서 DropRows.Num() > 0일 때 배열 전달
ProcessDrop() 호출은 BP_EnemyBase(사망 시)에서 단일 호출

4. 버그 수정 — `CombatAttributeSet.cpp` (마지막 공격자 null 문제)

증상: 플레이어가 죽여도 LastDamageInstigator가 null → 드랍 대상(인벤토리) 못 찾음. MonsterDied.Killer도 계속 null이던 잠재 버그.
원인: 데미지가 IncomingDamage 메타 어트리뷰트 → SetHealth()로 적용됨. 이로 인한 Health 변경은 GE 직접 수정이 아니라서 HandleHealthChanged의 ChangeData.GEModData가 null → instigator 세팅 누락. (NotifyDamageContext는 정의만 있고 호출처 없음)
수정: PostGameplayEffectExecute에서 SetHealth() 직전에 EffectContext의 instigator/causer를 HealthComponent->NotifyDamageContext()로 전달.
효과: 근접·원거리·버스트·화상(DoT) 등 모든 데미지 경로에서 마지막 공격자 확정. Killer 잠재 버그도 함께 해결.

미적용 / 참고

보스: RetrieveBossCharacter::HandleDeathStarted는 상위 RetrieveEnemyCharacter를 건너뛰므로 이 드랍 경로를 타지 않음. 보스도 동일 드랍이 필요하면 별도 배선 필요.
PlayerState fallback(DropComponent의 폰 해석 보강)은 instigator가 폰으로 확정되어 불필요 → 미적용.

와악

TIL - 101

인벤토리(WBP_InventoryPanel / InventoryPanelWidget) 작업

1. 장비 슬롯 버튼 툴팁이 마우스에 붙어 안 사라지던 문제

2. 장비 교체 확인 창이 뜰 때 그리드 툴팁 잔상 제거

3. 교체 확인 창을 마우스 커서 옆에 표시

4. 퀵슬롯 교체 창이 퀵슬롯 휠에 가려지던 z-order 문제

5. 사용 버튼(Button_UseConsumable) — 소모품일 때만 표시

TIL - 100

Manager_Interactor "Accessed None: OwnerController" 크래시

원인

수정 (플러그인 미변경)

TIL - 99

루멘(Lumen) 이슈 정리

1. 쉬핑 패키징에서 루멘이 플레이어를 못 따라옴

2. 특정 선 너머로 가면 루멘이 사라짐 (에디터 + 쉬핑 공통)

TIL - 98

BGM 시스템

개요

구성 요소

상태별 BGM (세션)

전투 BGM 판정

지역(존) BGM

볼륨 (3단 구조)

리루프

해결한 주요 이슈

에디터 설정

TIL - 97

BGM 시스템 (기본 / 전투 / 성 지역)

개요

구성 요소

동작 규칙

에디터 설정

TIL - 96

검방패 사운드 작업 정리

0. 한 줄 요약

1. 완료된 작업 (monolith로 적용·저장·검증)

1-1. 랜덤 Sound Cue 2개 생성 — /Game/Retrieve/Audio/SwordShield/

1-2. 스윙 노티파이 9개 배치 (3 몽타주 × 콤보 3타)

2. 핵심 아키텍처 (참고)

3. 남은 작업 (TODO)

3-1. 히트음 — GCN_Hit_Impact에 연결 (보류: 읽기전용)

3-2. 설정 볼륨(SFX 슬라이더) 연동 — 미설정 상태

3-3. CastSound — 미연결(dead field)

3-4. 소환 액터(WorldSpawnActor) 사운드 → 액터 BP에 (몽타주 아님)

4. 트러블슈팅

4-1. BP_FFF_WorldActor 저장 에러 (RF_Standalone 누락)

5. 주의/리마인더

TIL - 95

전투 VFX 작업

1. 상태이상 VFX (Burn / Cold)

2. 타격 임팩트 VFX (Hit Impact)

핵심 함정

TIL - 94

GAS에서 지속 데미지(Burn)가 매 틱 피격 리액션을 유발하는 문제

증상

원인 분석

해결

결과

배운 점 / 확장

TIL - 93

전투/UI

데미지 플로터가 뜨는 조건 (GAS)

원소모드 = ASC loose tag

도트(DoT)는 사망 시 직접 제거해야 함

UMG: 수동 RenderTransform은 위젯 애니에 덮어써진다

TIL - 92

다중 Row 드랍 & 인벤토리 직접 지급

개요

주요 변경

1. 데이터 구조 — RetrieveDataTableTypes.h

2. 드랍 처리 — DropComponent.h/.cpp

3. 적용 지점 — RetrieveEnemyCharacter.cpp

4. 버그 수정 — CombatAttributeSet.cpp (마지막 공격자 null 문제)

미적용 / 참고

1-1. 랜덤 Sound Cue 2개 생성 — `/Game/Retrieve/Audio/SwordShield/`

3-1. 히트음 — `GCN_Hit_Impact`에 연결 (보류: 읽기전용)

4-1. `BP_FFF_WorldActor` 저장 에러 (RF_Standalone 누락)

1. 데이터 구조 — `RetrieveDataTableTypes.h`

2. 드랍 처리 — `DropComponent.h/.cpp`

3. 적용 지점 — `RetrieveEnemyCharacter.cpp`

4. 버그 수정 — `CombatAttributeSet.cpp` (마지막 공격자 null 문제)