체크포인트와 세이브 설계

새 블루프린트 클래스 생성: 콘텐츠 브라우저에서 마우스 오른쪽 버튼 클릭 > 블루프린트 클래스(Blueprint Class) > All Classes에서 SaveGame을 검색하여 선택합니다.

• 이름을 지정합니다. (예: BP_MySaveGame)

저장할 변수 추가: BP_MySaveGame 블루프린트를 열고, 게임의 상태를 나타내는 필요한 변수들을 추가합니다.

• 플레이어 관련: PlayerLocation (Vector), PlayerHealth (Float), PlayerInventory (Array of Structs), CurrentWeapon (Enum/String)
• 게임 진행 관련: CurrentLevelName (Name), QuestProgress (Map/Struct), UnlockedAbilities (Array of Enum)
• 월드 상태 관련: DestroyedEnemies (Array of GUIDs), CollectedItems (Array of GUIDs)
• 중요: SaveGame 클래스에 저장할 변수들은 SaveGame 클래스 자체가 지원하는 변수 타입이어야 합니다. 일반적으로 기본 변수 타입(Int, Float, Bool, String, Vector, Rotator, Transform 등), Enum, Struct, 그리고 이들의 배열 타입은 지원됩니다. 오브젝트 참조의 직렬화는 액터와 모든 컴포넌트의 상태를 통째로 저장·재생성하는 기능이 아닙니다. 저장용 GUID나 명시적 ID와 복원할 데이터를 따로 저장하고, 로드 시 ID로 대상을 찾거나 생성합니다. 런타임 GetUniqueID는 재실행 후에도 같은 대상을 가리키는 영구 ID가 아닙니다.

• 새로운 액터 블루프린트(예: BP_Checkpoint)를 만들고, Box Collision 컴포넌트와 Static Mesh (시각적 표시용)를 추가합니다.
• 양쪽 컴포넌트의 Query/Overlap 응답과 Generate Overlap Events를 설정한 뒤, Box Collision에 On Component Begin Overlap 이벤트를 생성합니다.

• On Component Begin Overlap 이벤트에서 Other Actor를 Cast To BP_PlayerCharacter로 캐스팅합니다.
• 캐스팅 성공 시, Get Game Mode 노드를 호출하고 여러분의 게임 모드(GM_MyGame)로 캐스팅합니다.
• GM_MyGame에서 Save Game 커스텀 이벤트를 호출하도록 연결합니다. (또는 GM_MyGame에서 해당 로직을 직접 구현)
• 중복 저장 방지: bIsActivated를 검사하고 저장 성공을 확인한 뒤에만 True로 바꿉니다. 비동기 저장이면 bIsSaving으로 진행 중 요청을 막고, 완료 시 이를 해제합니다. 실패했다면 다시 시도할 수 있어야 합니다.

세이브 슬롯 이름 정의: Save Slot Name 변수(String)를 생성하고 MyGameSaveSlot 등으로 이름을 지정합니다. (여러 개의 세이브 파일을 관리할 경우 슬롯 번호 등을 추가)

• SaveGame이라는 커스텀 이벤트를 생성합니다.
• Does Save Game Exist 노드를 사용하여 해당 슬롯에 기존 세이브 파일이 있는지 확인합니다.
  • Slot Name 핀에 미리 정의한 Save Slot Name 변수를 연결합니다.
• True (기존 세이브 파일 있음)
  • Load Game From Slot 노드를 호출하여 기존 SaveGame 오브젝트를 로드합니다.
  • Return Value를 Cast To BP_MySaveGame으로 캐스팅합니다.
  • 유효한 오브젝트와 캐스트 성공을 확인한 뒤 현재 상태를 업데이트합니다. 파일이 있어도 로드가 실패할 수 있으므로 실패 시 저장을 중단하고 오류를 알립니다. 기존 파일을 조용히 빈 데이터로 덮어쓰지 않습니다.
• False (기존 세이브 파일 없음)
  • Create SaveGame Object 노드를 호출하여 새로운 BP_MySaveGame 오브젝트를 생성합니다.
  • SaveGame Class 핀에 BP_MySaveGame을 선택합니다.
  • Return Value를 Cast To BP_MySaveGame으로 캐스팅합니다.
• 공통 로직 (새로 생성했든 로드했든)
  • 유효한 SaveGame과 Get Player Pawn(0)의 플레이어 참조를 확인합니다. 현재 위치를 Get Actor Location으로 읽어 PlayerLocation에 저장합니다.
  • 플레이어의 현재 체력: Get Player Pawn > (Cast to PlayerCharacter) > Get Health → BP_MySaveGame의 PlayerHealth 변수에 저장.
  • 다른 모든 저장할 데이터들도 유사하게 BP_MySaveGame 오브젝트의 해당 변수에 업데이트합니다.
  • 최종적으로 Save Game To Slot 노드를 호출합니다.
    • SaveGame Object 핀에 업데이트된 BP_MySaveGame 오브젝트를 연결합니다.
    • Slot Name 핀에 Save Slot Name 변수를 연결합니다.
    • User Index는 보통 0으로 설정합니다. (단일 유저 세이브)
  • 저장 노드의 불리언 결과가 참일 때만 게임 저장 완료!를 출력합니다. 거짓이면 실패를 표시하며 체크포인트도 활성화하지 않습니다. 모든 저장·조회·로드 노드에서 슬롯명과 User Index를 같게 사용합니다.

• LoadGame이라는 커스텀 이벤트를 생성합니다. (UI 버튼 클릭 시 호출되도록)
• Does Save Game Exist 노드를 사용하여 해당 슬롯에 세이브 파일이 있는지 확인합니다.
  • False일 경우, Print String으로 저장된 게임이 없습니다! 메시지를 출력하고 함수 종료.
• True일 경우
  • Load Game From Slot 노드를 호출하여 BP_MySaveGame 오브젝트를 로드합니다.
  • Return Value를 Cast To BP_MySaveGame으로 캐스팅합니다.
  • 로드 결과와 캐스트가 실패하면 오류를 표시하고 종료합니다. 파일 존재는 데이터의 유효성을 보장하지 않습니다.
  • 저장된 CurrentLevelName이 다르면 로드한 SaveGame 참조를 프로젝트의 GameInstance에 PendingSave로 보관하고 Open Level (by Name)을 호출합니다. 이전 GameMode는 레벨과 함께 교체되므로 그 뒤 실행선에서 새 플레이어를 복원하려 하지 않습니다.
  • 새 레벨의 GameMode가 Pawn 스폰을 마친 뒤 명시적인 ApplyPendingSave 함수를 호출하도록 연결합니다. 같은 레벨이면 현재 Pawn이 준비됐는지 확인하고 이 복원 함수를 바로 호출합니다.
  • 복원 함수는 유효한 플레이어의 Set Actor Location(PlayerLocation), 캐스트 후 Set Health(PlayerHealth)를 적용하고, 저장용 ID로 월드의 수집 아이템·적 상태를 복원합니다.
  • 적용 완료 후 GameInstance의 PendingSave를 비우고 게임 불러오기 완료!를 표시합니다. Open Level 전체에 자동 연결되는 범용 On Level Loaded 이벤트가 있다고 가정하지 않습니다.