해당 문서는 붕괴 스타레일의 이벤트 콘텐츠를 모작한 내용을 기록한 문서이다.

현재 서버 연동이 없는 상태에서 클라이언트가 임시적으로 처리하고 있으며, 향후 서버 추가 시 수정될 구조를 고려하여 설계가 되었다.

EventPage

신규 이벤트 또는 특정 조건 이벤트 해금 시

주요 기능

• 이벤트 토글 및 배너 UI
  • 선택한 이벤트 배너와 상세 정보를 실시간으로 업데이트하여 표시
• RedDot 알림
  • 클라이언트 로컬 저장소를 활용해 사용자가 이미 확인한 이벤트는 기록되며, 재접속 시 새 이벤트에만 레드닷 아이콘을 표시
• 이벤트 보상 처리
  • 각 이벤트에 따른 보상 데이터를 UI로 보여주고, 서버 통신을 통해 보상 요청 처리를 진행
• 이벤트 만료 타이머
  • 각 이벤트 만료 시간을 실시간으로 계산하여, 남은 시간을 UI에 표시하고 만료 시 자동으로 최신 이벤트 데이터를 갱신
• 특정 조건에 따른 이벤트 UI 자동 오픈
  • 레벨업, 콘텐츠 해금 등의 조건이 만족될 경우, 해당 이벤트가 자동으로 오픈되는 기능 추가

이벤트 데이터 구조

• 서버에서는 현재 진행중인 이벤트 TableID와 시작 및 만료시간, 받은 보상 아이템을 보낸다

• 클라이언트는 TableID를 기획 데이터 테이블에서 검색해서 배너 및 이벤트 토글을 생성한다

• 데이터 구조

  tableNo	eventName	eventDesc	openType	openValue	bannerPath	toggleImgPath	openPagePath	rewardItems
  int	string	string	EventOpenType	string	string	string	string	Tarray

이벤트 데이터 세팅 방식

• 기획자는 eventName, eventDesc, openType, openValue 등을 설정하여 이벤트를 정의한다.
• openType을 통해 특정 조건(레벨업, 콘텐츠 해금 등)을 설정하고, openValue에 해당 조건의 세부값을 입력한다
• bannerPath, toggleImgPath를 통해 UI에 표시될 배너 및 토글 이미지를 정의한다
• openPagePath를 활용하여 특정 이벤트가 발생할 때 자동으로 해당 UI 페이지를 열도록 설정한다
• rewardItems에는 이벤트 보상 아이템 ID 목록을 설정하여, 해당 이벤트를 통해 지급될 보상을 관리한다

UI/UX 고려 사항

• 토글 그룹 제어
  • 이벤트 토글 버튼은 그룹 내에서 하나만 활성화되도록 설계하여, 사용자가 선택한 이벤트의 배너와 보상 정보가 직관적으로 표시되도록 구성
• 실시간 남은 시간 표시
  • 타이머를 활용하여 남은 시간을 실시간으로 표시하여, 이벤트가 만료되면 자동으로 UI를 갱신
• RedDot 알림
  • 로컬 저장소에서 이벤트 확인 여부를 유지하여, 불필요한 서버 요청을 방지하고 성능 최적화
• 자동 UI 탭 활성화
  • 특정 이벤트가 활성화될 조건이 만족되었을 때 UI가 자동으로 탭을 활성화 하도록 구현

서버 연동 시 이벤트 데이터 갱신 흐름

1. 클라이언트 접속 시, 서버에서 최신 이벤트 목록을 가져옴
2. 서버는 현재 진행 중인 데이터를 반환
3. 클라이언트는 받은 데이터를 저장
4. 특정 이벤트 종료 시 서버에 새로운 이벤트 정보를 다시 동기화

서버가 추가될 시 고려사항

• 이벤트 데이터 동기화 방식 변경
  • 현재는 클라이언트에서 임시 데이터를 사용하여 이벤트를 관리하고 있지만, 서버 연동 훙에는 서버에서 관리하는 이벤트 데이터를 받아와야 함
  • 클라이언트가 주기적으로 서버 API를 호출하는 방식과, 서버에서 Push 방식으로 데이터를 전송하는 방식 중 어떤 것을 선택할지 결정해야 함
• 이벤트 상태 저장 및 갱신 방식
  • 현재는 클라이언트에서 이벤트 상태를 관리하지만, 서버 연동 후에는 클라이언트가 이벤트 완료 요청을 보내고, 서버가 데이터를 갱신한 후 다시 이벤트 데이터를 내려주어야 함.
  • 사용자가 이벤트를 완료하면, 서버에 이벤트 완료 요청을 보내고 이후 서버에서 변경된 데이터를 동기화하는 방식으로 설계 필요
• 이벤트 조건 처리 방식
  • 현재는 클라이언트에서 직접 이벤트 오픈 여부를 판단하지만, 서버 연동 후에는 서버에서 이벤트 오픈 조건을 확인할 수도 있음
  • 예를 들어, 특정 레벨 달성 시 이벤트가 활성화되는 경우, 클라이언트가 직접 판단하는 것이 아니라 서버에서 “이벤트 오픈 가능” 응답을 반환하는 방식이 가능

확장성 및 유지보수 고려사항

• 이벤트 시스템 모듈화
  • 이벤트 UI(토글, 배너), 타이머, 보상 처리 기능을 각각의 모듈로 분리하여 새로운 이벤트 유형을 추가할 때 코드 수정이 최소화될 수 있도록 설계됨
  • 예를 들어, 새로운 이벤트 유형이 추가될 경우 기존 이벤트 처리 로직을 변경하지 않고 새로운 모듈을 추가하는 방식으로 확장 가능
• 이벤트 오픈 조건 확장 가능
  • 현재 이벤트 오픈 조건은 레벨업, 콘텐츠 해금 등 일부 기준에 한정되어 있으나, 서버 연동 후 다양한 오픈조건을 추가할 수 있도록 구조 설계
  • 예를 들어, 특정 퀘스트 완료, 아이템 획득, 특정 기간 내 접속 여부 등 다양한 조건을 서버에서 설정하고, 클라이언트가 이를 적용할 수 있도록 확장 가능.

이벤트 데이터 요청 및 갱신

• 데이터 요청 및 업데이트

  • 위젯이 활성화되면 서버에 이벤트 데이터 동기화를 진행

  • 기존 이벤트와 비교하여 신규 이벤트는 추가하고, 만료된 이벤트는 제거

  • 특정 조건 충족 시 자동으로 UI가 활성화 되도록 구현

  • 주요 코드

    void UPTUserData_Event::OnCheckOpenEvent(EEventOpenType OpenType, const FString& OpenValue)
    {
    	if (CheckOpenEvent(OpenType, OpenValue))
    	{
    		UpdateEvents(true);
    
    		UPTUIManagerSubsystem* UIManager = GetWorld()->GetGameInstance()->GetSubsystem<UPTUIManagerSubsystem>();
    		if (!UIManager)
    		{
    			UE_LOG(PTLog, Error, TEXT("[PTLobbyContentButton] UIMaangerSubsystem is nullptr"));
    			return;
    		}
    
    		TArray<FString> OpenEvents;
    
    		for (const FRequestEventData& Data : EventRequestDatas)
    		{
    			FEventData* EventData = GetEventData(Data.TableId);
    			if (!EventData)
    				continue;
    			if (EventData->openType == OpenType && EventData->openValue == OpenValue)
    			{
    				OpenEvents.Add(Data.TableId);
    			}
    		}
    
    		UPTEventOpenPage* EventOpenWidget = UIManager->GetWidget<UPTEventOpenPage>(DynamicLayerTag, "WBP_DynamicLayout", EventOpenPagePath);
    		EventOpenWidget->Init(OpenEvents);
    	}
    }

이벤트 배너 및 타이머 관리

• 데이터 테이블 및 서버 데이터를 기반으로 만료 타이머를 관리하며, UI에 필요한 리소스를 로딩

• 서버 시간을 기준으로 남은 시간을 계산하여 표시

• 주요 코드(일부)

  PTPlayerDataSubsystem* PlayerData = GetWorld()->GetGameInstance()->GetSubsystem<UPTPlayerDataSubsystem>();
  
  	if (!PlayerData)
  	{
  		UE_LOG(PTLog, Error, TEXT("[PTEventBanner] PTPlayerDataSubsystem is nullptr"));
  		return;
  	}
  
  	UPTUserData_Event* UserEvent = PlayerData->GetData<UPTUserData_Event>(EUserDataType::Event);
  
  	FRequestEventData* EventData = UserEvent->FindEventData(TableID);
  	if (!EventData)
  	{
  		UE_LOG(PTLog, Error, TEXT("[PTEventBanner] RequestEventData is nullptr TableID : %s"), *TableID);
  		return;
  	}
  
  	ExpireTime = EventData->ExpireDate;
  
  	FTimespan Remaining = ExpireTime - FDateTime::Now();
  	OnUpdateRemainTimer(Remaining);

사용자 인터렉션 및 RedDot 처리

• 사용자가 이벤트 토글 버튼을 선택하면 해당 이벤트의 배너와 상세 정보를 업데이트

• RedDot 상태를 클라이언트 로컬 저장소에 저장하며, 업데이트 시 자동으로 리셋됨

• 주요 코드

  void UPTEventToggleData::SaveRedDot()
  {
      UContentsStorage* ContentsStorage = LocalStorage->GetStorageType<UContentsStorage>(ELocalStorageType::Contents);
      if (!ContentsStorage->ContentsData.EventIDs.Contains(UniqueID))
      {
          ContentsStorage->ContentsData.EventIDs.Add(UniqueID);
          ContentsStorage->SaveData();
      }
  }