ESC 일시정지 시 외부 입력 차단

Author: chohyeonho

Assets/Plugins/FMOD/Cache/Editor/FMODStudioCache.asset

@@ -490,7 +490,7 @@ MonoBehaviour:
   StringsBanks:
   - {fileID: 6573240060274684362}
   cacheVersion: 131858
-  cacheTime: 639150932071371481
+  cacheTime: 639150090963297375
   SerializableEventsDict:
   - key: event:/SFX/Player/Landing
     index: 0
@@ -1116,7 +1116,7 @@ MonoBehaviour:
   Path: FMOD_Project/Build/Desktop/Master.bank
   Name: Master
   StudioPath: bank:/Master
-  lastModified: 639150932071371481
+  lastModified: 639150090963297375
   FileSizes:
   - Name: Desktop
     Value: 3753952
@@ -1136,7 +1136,7 @@ MonoBehaviour:
   Path: FMOD_Project/Build/Desktop/Master.strings.bank
   Name: Master.strings
   StudioPath: bank:/Master.strings
-  lastModified: 639149993704398228
+  lastModified: 639150012489183501
   FileSizes:
   - Name: Desktop
     Value: 2922

Assets/_Project/Assets/01_PM/PlanMD/esc 일시정지 입력 차단 계획.md

@@ -0,0 +1,36 @@
+**ESC 일시정지 입력 차단 계획**
+
+**요약**
+- ESC 일시정지는 **로컬 플레이어 입력만 멈추는 방식**으로 처리합니다.
+- 멀티플레이 세션, 서버 로직, 다른 플레이어, UI 애니메이션은 계속 동작합니다.
+- 현재 문제의 핵심은 `PlayerInputActions`만 꺼지고 `PlayerController.Update()`의 카메라/이동 루프가 계속 도는 점이므로, 게임플레이 루프 자체를 일시정지 상태에서 막습니다.
+
+**주요 변경**
+- [PlayerController.cs](<C:\Users\robor\Documents\GitHub\NUNBORA\Assets\_Project\Scripts\02_Player\PlayerController.cs>)에서 `PauseMenuManager.IsAnyUIOpen()`이 true면 게임플레이 업데이트를 중단합니다.
+  - 카메라 회전, 이동 FSM, 중력, `Controller.Move`, 자세 전환, 아이템 사용을 막습니다.
+  - 일시정지 진입 시 `currentVelocity`도 0으로 만들어 관성처럼 미끄러지는 현상을 막습니다.
+- [RoomLauncher.cs](<C:\Users\robor\Documents\GitHub\NUNBORA\Assets\_Project\Scripts\06_Backend\RoomLauncher.cs>)의 `OnInput`에서 일시정지 또는 UI 오픈 중이면 빈 입력을 전송합니다.
+  - 네트워크 입력에 이전 프레임의 이동/시점/공격 값이 새는 것을 막습니다.
+- [PlayerInputHandler.cs](<C:\Users\robor\Documents\GitHub\NUNBORA\Assets\_Project\Scripts\02_Player\PlayerInputHandler.cs>)의 기존 `SetInputActive(false)`와 입력 리셋 구조는 유지하되, UI가 닫힌 뒤에만 정상 입력으로 복귀하도록 정리합니다.
+
+**일시정지 중 막아야 할 것**
+- 마우스 시점 회전, 카메라 반동 복귀, 뷰모델 흔들림
+- 이동, 달리기, 점프, 앉기, 중력 이동, 남아 있는 속도
+- 공격/아이템 사용, 조준, 상호작용, 홀드 상호작용
+- 아이템 줍기, 문 열기, 상점/루팅 상호작용
+- 퀵슬롯 숫자키, 재장전/회전 같은 게임플레이 단축키
+- 네트워크 이동/시점/액션 입력 전송
+- 메뉴 뒤쪽의 상호작용 하이라이트와 안내 프롬프트 갱신
+
+**테스트**
+- ESC 화면에서 마우스를 움직여도 카메라가 움직이지 않아야 합니다.
+- 이동/달리기/점프 중 ESC를 눌러도 플레이어가 멈춰야 합니다.
+- 낙하나 이동 중 ESC를 눌렀을 때 미끄러지지 않아야 합니다.
+- 일시정지 메뉴 버튼, 설정창, 확인창은 정상 클릭되어야 합니다.
+- 재개 후 커서가 다시 잠기고 입력이 정상 복구되어야 합니다.
+- 멀티플레이에서는 내 일시정지가 다른 플레이어나 서버 진행을 멈추지 않아야 합니다.
+
+**가정**
+- ESC 일시정지는 멀티플레이 기준으로 로컬 입력만 차단합니다.
+- `Time.timeScale = 0`은 사용하지 않습니다.
+- 기존 인벤토리/상점/루팅 UI도 `PauseMenuManager.IsAnyUIOpen()` 기준으로 게임플레이 입력을 막습니다.

Assets/_Project/Scripts/01_PM/PlayerInteraction.cs

@@ -81,6 +81,14 @@ private void Update()
             return;
         }
 
+        if (PauseMenuManager.IsAnyUIOpen())
+        {
+            ClearCurrentInteractable();
+            ClearProximityHint();
+            player.InputHandler.ConsumeInteract();
+            return;
+        }
+
         CheckInteractionFocus();
         if (currentLookObject == null)
         {

Assets/_Project/Scripts/02_Player/PlayerCameraHandler.cs

@@ -52,12 +52,37 @@ private void Update()
             return;
         }
 
+        if (ShouldBlockLocalCameraEffectsForUI())
+        {
+            targetAmplitude = 0f;
+            targetFrequency = 0f;
+            noiseComponent.AmplitudeGain = 0f;
+            noiseComponent.FrequencyGain = 0f;
+            return;
+        }
+
         UpdateHeadbobTargets();
 
         noiseComponent.AmplitudeGain = Mathf.Lerp(noiseComponent.AmplitudeGain, targetAmplitude, Time.deltaTime * transitionSpeed);
         noiseComponent.FrequencyGain = Mathf.Lerp(noiseComponent.FrequencyGain, targetFrequency, Time.deltaTime * transitionSpeed);
     }
 
+    private bool ShouldBlockLocalCameraEffectsForUI()
+    {
+        if (!PauseMenuManager.IsAnyUIOpen())
+        {
+            return false;
+        }
+
+        if (player.IsLocalPlayer)
+        {
+            return true;
+        }
+
+        return LocalPlayerReferenceResolver.TryGetLocalPlayer(out PlayerController localPlayer) &&
+               localPlayer == player;
+    }
+
     private void UpdateHeadbobTargets()
     {
         Vector3 horizontalVelocity = new Vector3(player.Controller.velocity.x, 0f, player.Controller.velocity.z);
@@ -109,4 +134,4 @@ public void TestLocalCameraSetup()
             Debug.LogWarning("씬에 CinemachineCamera가 없습니다.");
         }
     }
-}
+}

Assets/_Project/Scripts/02_Player/PlayerController.cs

@@ -82,6 +82,7 @@ public class PlayerController : MonoBehaviour, IPlayerNetworkConfigurable
     [Header("Camera Recoil")]
     public float recoilReturnSpeed = 2f; // 반동이 원위치로 돌아오는 속도
     private float currentRecoilOffset = 0f; // 현재 적용된 반동 수치
+    private bool wasGameplayBlockedByUI;
 
     private void Awake()
     {
@@ -182,6 +183,14 @@ private void Update()
 
         CheckEnvironmentFlags();
 
+        if (ShouldBlockLocalGameplayForUI())
+        {
+            FreezeLocalGameplayForUI();
+            return;
+        }
+
+        wasGameplayBlockedByUI = false;
+
         if (canLook)
         {
             HandleLook();
@@ -206,6 +215,11 @@ private void Update()
 
     private void FixedUpdate()
     {
+        if (ShouldBlockLocalGameplayForUI())
+        {
+            return;
+        }
+
         StateMachine.CurrentState.PhysicsUpdate();
     }
 
@@ -215,6 +229,36 @@ private void CheckEnvironmentFlags()
         IsGrounded = Controller.isGrounded;
     }
 
+    private bool ShouldBlockLocalGameplayForUI()
+    {
+        if (!PauseMenuManager.IsAnyUIOpen())
+        {
+            return false;
+        }
+
+        if (IsLocalPlayer)
+        {
+            return true;
+        }
+
+        return LocalPlayerReferenceResolver.TryGetLocalPlayer(out PlayerController localPlayer) &&
+               localPlayer == this;
+    }
+
+    private void FreezeLocalGameplayForUI()
+    {
+        currentVelocity = Vector3.zero;
+        InputHandler?.ClearInputState();
+
+        if (!wasGameplayBlockedByUI && Animator != null)
+        {
+            Animator.SetSprinting(false);
+            Animator.UpdateMovement(Vector2.zero);
+        }
+
+        wasGameplayBlockedByUI = true;
+    }
+
     private void ApplyGravity()
     {
         if (IsGrounded && currentVelocity.y < 0)

Assets/_Project/Scripts/02_Player/PlayerInputHandler.cs

@@ -24,6 +24,8 @@ public class PlayerInputHandler : MonoBehaviour, IPlayerNetworkConfigurable
     private bool _useNetworkInputOverride;
     private PlayerInputSnapshot _networkSnapshot;
     private bool _previousNetworkCrouch;
+    private bool _networkConfigured;
+    private bool _isLocalPlayer;
 
     private void Awake()
     {
@@ -54,6 +56,12 @@ private void Awake()
 
     private void Update()
     {
+        if (ShouldBlockLocalGameplayInput())
+        {
+            ResetAllInputs();
+            return;
+        }
+
         if (_useNetworkInputOverride)
         {
             ApplySnapshotToCurrentState(_networkSnapshot);
@@ -67,7 +75,14 @@ private void Update()
 
     private void OnEnable()
     {
-        inputActions.Enable();
+        if (!ShouldBlockLocalGameplayInput())
+        {
+            inputActions.Enable();
+        }
+        else
+        {
+            ResetAllInputs();
+        }
     }
 
     private void OnDisable()
@@ -95,7 +110,7 @@ public void DisableInput()
     /// </summary>
     public void SetInputActive(bool isActive)
     {
-        if (isActive)
+        if (isActive && !ShouldBlockLocalGameplayInput())
         {
             inputActions.Enable();
         }
@@ -121,6 +136,28 @@ private void ResetAllInputs()
         _previousNetworkCrouch = false;
     }
 
+    public void ClearInputState()
+    {
+        ResetAllInputs();
+    }
+
+    private bool ShouldBlockLocalGameplayInput()
+    {
+        if (!PauseMenuManager.IsAnyUIOpen())
+        {
+            return false;
+        }
+
+        if (_networkConfigured)
+        {
+            return _isLocalPlayer;
+        }
+
+        return LocalPlayerReferenceResolver.TryGetLocalPlayer(out PlayerController localPlayer) &&
+               localPlayer != null &&
+               localPlayer.InputHandler == this;
+    }
+
 
 
     public void SetNetworkInputOverride(bool enabled)
@@ -138,8 +175,14 @@ public void SetNetworkInputOverride(bool enabled)
             return;
         }
 
-        if (isActiveAndEnabled && inputActions != null)
+        if (isActiveAndEnabled && inputActions != null && !ShouldBlockLocalGameplayInput())
+        {
             inputActions.Enable();
+        }
+        else
+        {
+            ResetAllInputs();
+        }
     }
 
     public void ApplyNetworkSnapshot(PlayerInputSnapshot snapshot)
@@ -175,6 +218,9 @@ private void ApplySnapshotToCurrentState(PlayerInputSnapshot snapshot)
 
     public void ConfigureForNetwork(bool isLocalPlayer)
     {
+        _networkConfigured = true;
+        _isLocalPlayer = isLocalPlayer;
+
         if (isLocalPlayer)
         {
             SetInputActive(true);

Assets/_Project/Scripts/02_Player/Utilities/PlayerViewmodelController.cs

@@ -73,6 +73,11 @@ private void LateUpdate()
     {
         if (inputHandler == null || player == null) return;
 
+        if (ShouldBlockLocalViewmodelForUI())
+        {
+            return;
+        }
+
         // ==========================================
         // 1. Sway
         // ==========================================
@@ -152,4 +157,20 @@ private void LateUpdate()
         viewmodelTransform.localPosition = defaultLocalPos + currentSwayPos + currentBobPos + currentRecoilPos;
         viewmodelTransform.localRotation = defaultLocalRot * currentSwayRot * currentRecoilRot;
     }
-}
+
+    private bool ShouldBlockLocalViewmodelForUI()
+    {
+        if (!PauseMenuManager.IsAnyUIOpen())
+        {
+            return false;
+        }
+
+        if (player.IsLocalPlayer)
+        {
+            return true;
+        }
+
+        return LocalPlayerReferenceResolver.TryGetLocalPlayer(out PlayerController localPlayer) &&
+               localPlayer == player;
+    }
+}

Assets/_Project/Scripts/06_Backend/RoomLauncher.cs

@@ -1504,6 +1504,13 @@ public void OnInput(NetworkRunner runner, NetworkInput input)
 
         BackendPlayerNetworkInput payload = default;
         PlayerInputHandler inputHandler = GetOrResolveLocalInputHandler(runner);
+        if (PauseMenuManager.IsAnyUIOpen())
+        {
+            inputHandler?.ClearInputState();
+            input.Set(payload);
+            return;
+        }
+
         if (inputHandler != null)
         {
             payload.Move = inputHandler.MoveInput;