09. 게임오버와 재시작 — 풀 재사용 점검

SceneManager.LoadScene(SceneManager.GetActiveScene().name); // ❌ 이 프로젝트에서는 쓰지 않는다

// Assets/GameMain/Procdure/ProcedureGameOver.cs using UnityEngine.InputSystem; using UnityGameFramework.Runtime; using ProcedureOwner = GameFramework.Fsm.IFsm<GameFramework.Procedure.IProcedureManager>; namespace ToyBoxNightmare { /// <summary> /// 게임오버 상태. R 키를 누르면 ProcedureMain 으로 돌아가 새 판을 시작한다. /// /// 엔티티 회수는 여기서 하지 않는다. 게임을 소유한 <see cref="ProcedureMain"/> 이 /// OnLeave 에서 정리하므로, 이 프로시저에 진입한 시점에는 이미 비어 있다. /// /// 재시작을 씬 리로드로 하지 않는다. 프로시저 전이가 유일하게 안전한 재시작 경로다. /// </summary> public class ProcedureGameOver : ProcedureBase { public override bool UseNativeDialog => false; protected override void OnEnter(ProcedureOwner procedureOwner) { base.OnEnter(procedureOwner); int remainingEntityCount = CountRemainingEntities(); Log.Info("ProcedureGameOver: Enter. 잔존 엔티티 {0}개. R 키로 재시작.", remainingEntityCount); } protected override void OnLeave(ProcedureOwner procedureOwner, bool isShutdown) { CloseHud(); base.OnLeave(procedureOwner, isShutdown); } /// <summary> /// HUD 를 닫는다. <see cref="ProcedureMain"/> 이 진입에서 열고 여기서 닫아 짝이 맞는다. /// Main 쪽 OnLeave 에서 닫으면 게임오버 문구가 보이기도 전에 사라진다. /// </summary> private static void CloseHud() { UIComponent ui = GameEntry.GetComponent<UIComponent>(); if (ui == null) return; CloseIfOpen(ui, UITable.HudForm); CloseIfOpen(ui, UITable.PauseMenuForm); } private static void CloseIfOpen(UIComponent ui, string assetName) { UIForm form = ui.GetUIForm(assetName); if (form == null) return; ui.CloseUIForm(form); } protected override void OnUpdate(ProcedureOwner procedureOwner, float elapseSeconds, float realElapseSeconds) { base.OnUpdate(procedureOwner, elapseSeconds, realElapseSeconds); if (!IsRestartRequested()) return; ChangeState<ProcedureMain>(procedureOwner); } /// <summary>재시작 키(R)가 이번 프레임에 눌렸는가.</summary> private static bool IsRestartRequested() { // 일시정지 중에는 재시작을 받지 않는다. 메뉴를 띄운 채 R 이 눌리면 // timeScale 0 인 상태로 새 판이 시작된다. if (GamePause.IsPaused) return false; // 키보드가 연결돼 있지 않으면 Keyboard.current 가 null 이다(패드만 꽂힌 경우 등). Keyboard keyboard = Keyboard.current; return keyboard != null && keyboard.rKey.wasPressedThisFrame; } /// <summary> /// 회수가 제대로 됐는지 확인용. 0 이 아니면 ProcedureMain.OnLeave 를 의심할 것. /// </summary> private static int CountRemainingEntities() { // 앱 종료 중이면 컴포넌트가 이미 파괴됐을 수 있다. 그때는 셀 대상도 없다. EntityComponent entityComponent = GameEntry.GetComponent<EntityComponent>(); if (entityComponent == null) return 0; return entityComponent.GetAllLoadedEntities().Length; } } }

// Assets/GameMain/Procdure/ProcedureMain.cs using UnityEngine.AI; using UnityGameFramework.Runtime; using ProcedureOwner = GameFramework.Fsm.IFsm<GameFramework.Procedure.IProcedureManager>; namespace ToyBoxNightmare { public class ProcedureMain : ProcedureBase { private SurvivalGame mGame = null; /// <summary>UI 실패 이벤트를 구독 중인가. 구독/해지 짝을 보장한다.</summary> private bool mSubscribedUIFailure = false; public override bool UseNativeDialog => false; protected override void OnEnter(ProcedureOwner procedureOwner) { base.OnEnter(procedureOwner); Log.Info("ProcedureMain: Enter"); WarnIfSceneIsIncomplete(); // 배경음악은 SoundComponent 로 튼다. 이미 나오고 있으면 그대로 둔다. GameSound.PlayMusic(); // 구독이 먼저다. OpenUIForm 은 비동기라 실패 통지가 이 아래 호출 도중에도 올 수 있다. SubscribeUIFailure(); OpenForms(); mGame = new SurvivalGame(); mGame.Initialize(); } /// <summary> /// 이 게임은 <c>Assets/Scenes/MainScene.unity</c> 에서 돌아야 한다. 방(Environment)·NavMesh· /// 카메라 추종(<see cref="PlayerCameraFollow"/>)이 그 씬에 놓여 있기 때문이다. /// 새 씬에 GameFramework 프리팹만 놓고 실행해도 게임은 시작되지만, 적이 움직이지 않고 /// 카메라도 따라오지 않는다 — 콘솔에는 Unity 의 NavMesh 경고만 잔뜩 남는다. /// 원인을 바로 알 수 있게 진입하자마자 한 번 알린다. /// </summary> private static void WarnIfSceneIsIncomplete() { bool hasNavMesh = NavMesh.CalculateTriangulation().vertices.Length > 0; bool hasCameraFollow = GameEntry.GetComponent<PlayerCameraFollow>() != null; if (hasNavMesh && hasCameraFollow) return; Log.Error("이 씬에는 예제 게임에 필요한 것이 없다(NavMesh: {0}, 카메라 추종: {1}). " + "Assets/Scenes/MainScene.unity 를 열고 실행할 것.", hasNavMesh ? "있음" : "없음", hasCameraFollow ? "있음" : "없음"); } /// <summary> /// HUD 를 띄운다. <b>닫는 것은 <see cref="ProcedureGameOver"/> 다</b> — /// 여기서 OnLeave 에 닫으면 게임오버로 전이하는 순간 "Game Over!" 문구가 함께 사라진다. /// 한 판마다 Main 진입에서 열고 GameOver 이탈에서 닫아 짝이 맞는다. /// </summary> private void OpenForms() { UIComponent ui = GameEntry.GetComponent<UIComponent>(); if (ui == null) { Log.Error("ProcedureMain: UIComponent 가 없다. UI 없이 진행한다."); return; } // 그룹이 곧 겹치는 순서다. 일시정지 메뉴는 HUD 보다 깊이가 큰 Popup 그룹에 연다. OpenOnce(ui, UITable.HudForm, UITable.DefaultGroup); OpenOnce(ui, UITable.PauseMenuForm, UITable.PopupGroup); } /// <summary>이미 떠 있으면 두 번 열지 않는다(프로시저 재진입 방어).</summary> private static void OpenOnce(UIComponent ui, string assetName, string uiGroupName) { if (ui.HasUIForm(assetName)) return; ui.OpenUIForm(assetName, uiGroupName); } private void SubscribeUIFailure() { EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) { Log.Error("ProcedureMain: EventComponent 가 없다. UI 열기 실패를 감지하지 못한다."); return; } events.Subscribe(OpenUIFormFailureEventArgs.EventId, OnOpenUIFormFailure); mSubscribedUIFailure = true; } /// <summary>구독한 적이 있을 때만 해지한다. 미등록 핸들러 해지는 코어에서 즉시 예외다.</summary> private void UnsubscribeUIFailure() { if (!mSubscribedUIFailure) return; mSubscribedUIFailure = false; // 종료 순서에 따라 EventComponent 가 먼저 파괴돼 있을 수 있다. EventComponent events = GameEntry.GetComponent<EventComponent>(); if (events == null) return; events.Unsubscribe(OpenUIFormFailureEventArgs.EventId, OnOpenUIFormFailure); } private void OnOpenUIFormFailure(object sender, GameFramework.Event.GameEventArgs e) { OpenUIFormFailureEventArgs ne = e as OpenUIFormFailureEventArgs; if (ne == null) { GameAssert.Unreachable("ProcedureMain: OpenUIFormFailure 핸들러에 다른 타입이 들어왔다."); return; } Log.Error("UI 폼 '{0}'(그룹 {1}) 열기 실패: {2} — Addressables 주소와 UITable 문자열이 같은지 확인할 것.", ne.UIFormAssetName, ne.UIGroupName, ne.ErrorMessage); } protected override void OnUpdate(ProcedureOwner procedureOwner, float elapseSeconds, float realElapseSeconds) { base.OnUpdate(procedureOwner, elapseSeconds, realElapseSeconds); // OnEnter 가 아직 돌지 않았거나 이미 OnLeave 로 정리된 상태 방어. if (mGame == null) return; mGame.Update(elapseSeconds, realElapseSeconds); // 게임오버는 SurvivalGame 이 PlayerDied 를 받아 세운다. // 전이 시 OnLeave 가 mGame.Shutdown() 을 부르고, ProcedureGameOver 가 // 남은 엔티티를 확인한다. if (mGame.GameOver) { ChangeState<ProcedureGameOver>(procedureOwner); } } protected override void OnLeave(ProcedureOwner procedureOwner, bool isShutdown) { // 만든 순서의 반대로 치운다. 엔티티는 게임이 띄운 것이므로 엔티티가 먼저다. // 게임을 먼저 내리면, 회수되는 엔티티가 기대고 있을 수 있는 판 상태가 먼저 사라진다. CleanupEntities(); mGame?.Shutdown(); mGame = null; UnsubscribeUIFailure(); base.OnLeave(procedureOwner, isShutdown); } /// <summary> /// 이 판에서 만든 엔티티를 전부 회수한다. /// /// 로딩 중인 엔티티까지 반드시 같이 처리해야 한다. GetAllLoadedEntities 는 /// 이미 인스턴스화된 것만 반환하므로, ShowEntity 직후 Addressables 로드가 /// 진행 중인 엔티티는 빠진다. 그대로 두면 로드가 끝나는 순간 이전 판의 적이 /// 다음 판 화면에 스폰된다. /// </summary> private static void CleanupEntities() { EntityComponent entityComponent = GameEntry.GetComponent<EntityComponent>(); // 앱 종료 경로(isShutdown)로 들어오면 컴포넌트가 이미 파괴됐을 수 있다. // 이때는 회수할 대상도 함께 사라진 뒤라 조용히 빠져나가는 게 맞다. if (entityComponent == null) return; int loadingCount = entityComponent.GetAllLoadingEntityIds().Length; int loadedCount = entityComponent.GetAllLoadedEntities().Length; entityComponent.HideAllLoadingEntities(); entityComponent.HideAllLoadedEntities(); if (loadingCount > 0 || loadedCount > 0) { Log.Info("ProcedureMain: 엔티티 회수 — 로드됨 {0}, 로딩 중 {1}", loadedCount, loadingCount); } } } }

ProcedureMain: Enter Character selected: Girl 무기 4종 요청. 마우스 좌클릭 발사 / Tab 으로 전환. Player spawned: Girl Game over. Final score: 0 ProcedureMain: 엔티티 회수 — 로드됨 7, 로딩 중 0 ProcedureGameOver: Enter. 잔존 엔티티 0개. R 키로 재시작.

ProcedureMain: Enter

void Update() { if (GameManager.Instance.IsPlayerChosen) { gameObject.SetActive(false); // 고르면 스스로를 끈다 return; } // … 마우스를 따라간다 }

// Assets/GameMain/Entity/EntityData/SpotlightData.cs using GameFramework; namespace ToyBoxNightmare { /// <summary> /// 캐릭터 선택 조명(<see cref="CharacterSelectSpotlight"/>)의 스폰 데이터. /// 조명은 프리팹에 놓인 자리 그대로 쓰므로 Id 말고는 담을 것이 없다. /// </summary> public class SpotlightData : EntityData { public static SpotlightData Create(int entityId, int typeId) { SpotlightData data = ReferencePool.Acquire<SpotlightData>(); data.Fill(entityId, typeId); return data; } } }

// Assets/GameMain/Camera/CharacterSelectSpotlight.cs using UnityEngine; using UnityGameFramework.Runtime; namespace ToyBoxNightmare { /// <summary> /// 캐릭터 선택 화면의 조명. 커서가 가리키는 바닥을 따라 비춘다. /// /// <b>엔티티다.</b> "선택 중에만 있어야 하는 것" 이라 수명을 엔티티로 표현한다 — /// <see cref="SurvivalGame"/> 이 판을 시작하면서 띄우고 캐릭터가 골라지면 회수한다. /// 그래서 "지금 선택 중인가" 를 매 프레임 따로 묻지 않는다. 떠 있으면 선택 중이다. /// /// 프리팹(<c>CharacterSelectSpotlight</c>)에는 이 로직을 붙여 두지 않는다. 프레임워크가 띄울 때 붙인다. /// </summary> public class CharacterSelectSpotlight : EntityLogicBase { /// <summary>커서를 따라다닐 조명 자식. 프리팹에서는 꺼진 채로 저장돼 있다.</summary> private const string SpotlightPath = "Select spot PC"; private GameObject mSpotlight = null; protected internal override void OnInit(object userData) { base.OnInit(userData); Transform spotlight = CachedTransform.Find(SpotlightPath); if (spotlight == null) { Log.Warning("CharacterSelectSpotlight: 자식 '{0}' 을 찾지 못했다. 선택 화면 연출이 나오지 않는다.", SpotlightPath); return; } mSpotlight = spotlight.gameObject; } protected internal override void OnShow(object userData) { base.OnShow(userData); SetSpotlightActive(true); } protected internal override void OnHide(bool isShutdown, object userData) { // 풀에 돌아갈 때는 프리팹 기본 상태(꺼짐)로 되돌린다. SetSpotlightActive(false); base.OnHide(isShutdown, userData); } protected internal override void OnUpdate(float elapseSeconds, float realElapseSeconds) { base.OnUpdate(elapseSeconds, realElapseSeconds); if (mSpotlight == null) return; // 커서가 바닥 밖(하늘, UI 위)을 가리키면 마지막 방향을 그대로 둔다. if (!MouseGround.TryGetGroundPoint(out Vector3 groundPoint)) return; mSpotlight.transform.LookAt(groundPoint); } private void SetSpotlightActive(bool active) { if (mSpotlight == null) return; if (mSpotlight.activeSelf == active) return; mSpotlight.SetActive(active); } } }

/// <summary>선택 화면 조명. 캐릭터를 고르는 동안에만 떠 있는 엔티티다.</summary> private const string SpotlightAsset = "CharacterSelectSpotlight";

private CharacterSelectSpotlight mSpotlight = null;

private void SpawnSelectCharacters() { SpawnSelectCharacter(GirlCharacterKey, GirlSelectPosition); SpawnSelectCharacter(BoyCharacterKey, BoySelectPosition); SpawnSelectSpotlight(); } /// <summary> /// 선택 화면 조명을 띄운다. 조명은 "선택 중" 이라는 상태 그 자체라서, /// 선택 캐릭터와 같이 띄우고 같이 치운다(<see cref="DismissSelectCharacters"/>). /// </summary> private void SpawnSelectSpotlight() { EntityComponent entityComponent = GameEntry.GetComponent<EntityComponent>(); if (entityComponent == null) return; int id = EntitySerialId.Next(); entityComponent.ShowEntity( id, typeof(CharacterSelectSpotlight), SpotlightAsset, WeaponTable.EffectGroup, SpotlightData.Create(id, DefaultEntityTypeId)); }

if (ne.EntityLogicType == typeof(CharacterSelectSpotlight)) { CacheSpotlight(ne.Entity); return; }

private void CacheSpotlight(Entity entity) { CharacterSelectSpotlight spotlight = entity.Logic as CharacterSelectSpotlight; if (spotlight == null) { Log.Error("CharacterSelectSpotlight 로 스폰했는데 로직이 그 타입이 아니다: {0}", entity.EntityAssetName); return; } // 조명이 로드되는 사이에 이미 캐릭터를 골랐다. 선택 화면이 끝났으니 바로 돌려보낸다. // (CharacterSelected 구독은 선택 순간에 스스로 풀리므로 그 플래그로 판별한다.) if (!mCharacterSelectSubscribed) { spotlight.SafeHide(); return; } mSpotlight = spotlight; }

// 조명이 아직 로드 중이면 null 이다. 그 경우는 도착하는 순간 CacheSpotlight 가 돌려보낸다. if (mSpotlight != null) { mSpotlight.SafeHide(); } // 회수한 뒤에는 참조를 반드시 비운다. mGirlSelect = null; mBoySelect = null; mSpotlight = null;