✍️Today I Learned

📅 2025-12-18

• 타이머로 주기적인 연료 소모 시스템 구현
• 델리게이트로 UI와 로직 분리
• 특정 아이템만 받는 커스텀 인벤토리 컴포넌트
• StartTime 저장으로 클라이언트 프로그레스바 구현

---

타이머로 주기적인 연료 소모 시스템 구현

연료를 넣으면 불을 켤 수 있는 가로등 액터를 만들었다. 핵심은 서버에서 타이머로 연료를 주기적으로 소모하고, 연료가 없으면 자동으로 불을 끄는 구조다.

구현 방식

void ATSStreetLamp::SetFuelTimer()
{
    if (bIsFueling) return;
    
    GetWorldTimerManager().SetTimer(
        FuelTimerHandle, 
        this, 
        &ATSStreetLamp::UseFuel, 
        MaintenanceInterval,  // 초당 소모 간격
        true,   // 반복
        0.f     // 즉시 시작
    );
    bIsFueling = true;
}

void ATSStreetLamp::UseFuel()
{
    if (LampInventory->GetItemCount(MaintenanceCostID) > 0)
    {
        // 연료 소모 & 불 켜기
        LampInventory->ConsumeItem(MaintenanceCostID, 1);
        ChangeLightScaleByErosion(ErosionSubSystem->GetCurrentErosion());
        StartTime = GetWorld()->GetTimeSeconds();  // 🔑 현재 시간 저장
    }
    else
    {
        // 연료 없으면 불 끄기 & 타이머 중지
        SetLightScale(0);
        GetWorldTimerManager().ClearTimer(FuelTimerHandle);
        bIsFueling = false;
    }
    OnFuelModeChanged.Broadcast(bIsFueling);
}

핵심 포인트

• MaintenanceInterval마다 UseFuel() 호출로 연료 1개씩 소모
• 연료가 있으면 계속 타이머 반복, 없으면 ClearTimer()로 중지
• StartTime을 Replicated로 저장해서 클라이언트도 경과 시간 계산 가능하게 함
• bIsFueling 상태로 현재 가동 중인지 추적

---

델리게이트로 UI와 로직 분리

UI 업데이트를 위해 FOnFuelModeChanged 델리게이트를 만들었다. 연료 상태가 바뀔 때마다 브로드캐스트해서 위젯에서 구독하도록 했다.

델리게이트 선언 & 사용

// .h
DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnFuelModeChanged, bool, bIsFueling);

UPROPERTY(BlueprintAssignable, Category = "Lamp|Events")
FOnFuelModeChanged OnFuelModeChanged;

// .cpp
UPROPERTY(ReplicatedUsing = OnRep_IsFueling)
bool bIsFueling = false;

void ATSStreetLamp::OnRep_IsFueling()
{
    OnFuelModeChanged.Broadcast(bIsFueling);
}

위젯 측 구현

• 위젯에서 OnFuelModeChanged를 구독
• bIsFueling이 false면 프로그레스바 업데이트 타이머 pause
• true면 타이머 재개해서 0.2초마다 남은 시간 계산

이렇게 하면 액터 로직과 UI 업데이트가 완전히 분리되고, 위젯은 상태 변화에만 반응하면 된다.

---

특정 아이템만 받는 커스텀 인벤토리 컴포넌트

램프는 연료 아이템만 받을 수 있어야 한다. UTSLampInventory를 만들어서 CanPlaceItemInSlot()을 오버라이드했다.

bool UTSLampInventory::CanPlaceItemInSlot(int32 StaticDataID, EInventoryType InventoryType, int32 SlotIndex)
{
    if (Super::CanPlaceItemInSlot(StaticDataID, InventoryType, SlotIndex))
    {
        if (StaticDataID != MaintenanceCostID)  // 연료 아이템만 허용
        {
            return false;
        }
    }
    OnFuelTransferred.Broadcast();  // 연료 추가됨 알림
    return true;
}

void UTSLampInventory::ClearSlot(FSlotStructMaster& Slot)
{
    Super::ClearSlot(Slot);
    Slot.ItemData.StaticDataID = MaintenanceCostID;  // 빈 슬롯도 연료 ID로
    Slot.MaxStackSize = MaintenanceCostQty;
}

추가 구현

• Internal_TransferItem()에서도 MaintenanceCostID 체크
• 연료가 추가되면 OnFuelTransferred 델리게이트 브로드캐스트
• 램프 액터에서 이걸 구독해서 SetFuelTimer() 호출

// BeginPlay에서 델리게이트 바인딩
LampInventory->OnFuelTransferred.AddDynamic(this, &ATSStreetLamp::SetFuelTimer);

이렇게 하면 플레이어가 연료를 넣는 순간 자동으로 타이머가 시작된다.

---

StartTime 저장으로 클라이언트 프로그레스바 구현

서버에서만 타이머가 돌지만, 클라이언트도 프로그레스바를 보여줘야 한다. 이를 위해 StartTime을 Replicated 변수로 만들었다.

UPROPERTY(Replicated)
float StartTime = 0.f;

// UseFuel()에서 연료 소모할 때마다 갱신
StartTime = GetWorld()->GetTimeSeconds();

위젯에서 계산

// 위젯의 0.2초 타이머에서
float OperatingTime = CurrentTime - StartTime;
float Progress = 1.0f - (OperatingTime / MaintenanceInterval);

이렇게 하면:
1. 서버가 연료 소모할 때마다 StartTime 업데이트
2. 클라이언트는 StartTime과 현재 시간 차이로 경과 시간 계산
3. MaintenanceInterval로 나눠서 진행률 계산

서버 타이머 없이도 클라이언트가 독립적으로 프로그레스바 업데이트 가능!

---

💡 느낀 점 (What I Felt)

Tick을 사용하지 않고 부하를 줄이려고 노력했다. 연료를 소비하거나 불을 끄는 시점만 델리게이트로 확실하게 동기화하고 나머지는 클라이언트에서 예측하여 남은 연료 가동시간을 UI에 나타냈다. 이때도 Tick보다는 타이머를 사용해 램프가 가동되는 순간에만 타이머를 활성화하는 방식으로 부하를 줄였다.

기존의 인벤토리를 커스텀하여 특정 아이템만 넣을 수 있고 최대로 넣을 수 있는 연료 아이템의 수도 제한하도록 CanPlaceItemInSlot()를 오버라이드했다. 기존에는 아이템 데이터에서 MaxStack을 가져와 슬롯에 적용하는 방식이었는데 이번 로직을 구현하기 위해 스택할 때 슬롯의 MaxStack을 가지고 오는 방식으로 수정했다. 기존 인벤토리 컴포넌트를 꽤 확장성 높게 만든 것 같아 뿌듯하다.