Category
Preparing references and filters for this topic. 이 주제의 레퍼런스와 필터를 준비하고 있습니다.
같은 오브젝트·계층·외부 참조에 맞는 Component 조회 API와 cache 시점, 누락 검사 방법을 정리합니다.
[RequireComponent(typeof(Rigidbody))]
public sealed class PlayerMover : MonoBehaviour
{
private Rigidbody body;
private void Awake()
{
if (!TryGetComponent(out body))
{
enabled = false;
}
}
}Inspector에 저장되는 field의 조건, 지원·미지원 타입, rename migration과 runtime 저장 경계를 정리합니다.
[SerializeField] private float moveSpeed = 5f;
[SerializeField] private Transform target;
public float MoveSpeed => moveSpeed;Transform Inspector의 local 값과 world API를 구분하고, SetParent·회전·scale 변화가 배치에 주는 영향을 확인합니다.
transform.position = new Vector3(0f, 1f, 0f); // world 위치
transform.localPosition = new Vector3(0f, 0f, 2f); // 부모 기준 위치Scene view 도구·frame·view 조작의 기본 단축키와 OS·버전·개인 profile에 따른 확인 방법을 정리합니다.
GameObject의 Inspector 항목과 Component·Transform의 책임을 구분하고, 참조·활성화·제거 API의 범위를 확인합니다.
GameObject player = gameObject;
Rigidbody body = player.GetComponent<Rigidbody>();
Transform point = player.transform;
Destroy(body); // Rigidbody만 제거
// Destroy(player); // GameObject와 붙은 Component를 제거GameObject 활성화와 Behaviour·Renderer·Collider의 enabled 상태를 구분하고, 계층 기준 실제 활성 상태를 확인합니다.
gameObject.SetActive(false); // 이 GameObject와 active child hierarchy를 비활성화
renderer.enabled = false; // 화면 렌더링만 끔
collider.enabled = false; // 이 Collider의 physics 참여만 끔초기화·활성화·프레임·파괴 단계의 보장 범위와 스크립트 사이 순서에 의존하지 않는 연결 방법을 정리합니다.
private void Awake() => _rb = GetComponent<Rigidbody>();
private void OnEnable() => GameEvents.Paused += HandlePause;
private void Start() => _hud = FindFirstObjectByType<Hud>();
private void Update() => ReadInput();
private void FixedUpdate() => ApplyPhysics();
private void LateUpdate() => FollowTarget();
private void OnDisable() => GameEvents.Paused -= HandlePause;코루틴의 대기 종류, 중복 실행 방지, GameObject와 MonoBehaviour 비활성화에 따른 수명 차이를 정리합니다.
private Coroutine _flashHandle;
private void OnHit()
{
if (_flashHandle != null) StopCoroutine(_flashHandle);
_flashHandle = StartCoroutine(FlashDamage());
}
private IEnumerator FlashDamage()
{
indicator.SetActive(true);
yield return new WaitForSeconds(0.15f);
indicator.SetActive(false);
_flashHandle = null;
}`Update`, `FixedUpdate`, `LateUpdate`의 호출 기준과 단발 입력을 물리 단계로 넘기는 안전한 소비 규칙을 정리합니다.
private Vector2 _moveInput;
private bool _jumpRequested;
private void Update()
{
_moveInput = new Vector2(Input.GetAxisRaw("Horizontal"), Input.GetAxisRaw("Vertical"));
if (Input.GetButtonDown("Jump")) _jumpRequested = true;
}
private void FixedUpdate()
{
Vector3 step = new Vector3(_moveInput.x, 0f, _moveInput.y).normalized;
_rb.MovePosition(_rb.position + step * moveSpeed * Time.fixedDeltaTime);
if (!_jumpRequested) return;
_jumpRequested = false;
_rb.AddForce(Vector3.up * jumpImpulse, ForceMode.Impulse);
}`OnEnable`/`OnDisable`의 반복 호출 시점과 이벤트·코루틴·Input Action의 소유 수명을 맞추는 기준을 정리합니다.
private void OnEnable()
{
GameEvents.EnemyDied += HandleEnemyDied;
}
private void OnDisable()
{
GameEvents.EnemyDied -= HandleEnemyDied;
}프레임·물리·unscaled 시간에서 각각 어떤 delta 값을 쓰고 긴 프레임과 pause의 결과를 어떻게 다룰지 정리합니다.
private void Update()
{
transform.position += Vector3.forward * speed * Time.deltaTime;
}
private void FixedUpdate()
{
_rb.MovePosition(_rb.position + direction * speed * Time.fixedDeltaTime);
}일시정지와 슬로모션에서 scaled/unscaled 시간을 고르고 `fixedDeltaTime`을 원래 값으로 복구하는 기준을 정리합니다.
private float _baseFixedDeltaTime;
private void Awake() => _baseFixedDeltaTime = Time.fixedDeltaTime;
public void SetSlowMotion(float scale)
{
Time.timeScale = scale;
Time.fixedDeltaTime = _baseFixedDeltaTime * scale;
}
public void ResumeGame()
{
Time.timeScale = 1f;
Time.fixedDeltaTime = _baseFixedDeltaTime;
}`OnCollision`과 `OnTrigger`를 언제 고르고, Rigidbody/Collider/Is Trigger 조합이 어떻게 콜백 동작을 바꾸는지 정리합니다.
private void OnTriggerEnter(Collider other)
{
if (other.CompareTag("Player"))
{
Debug.Log("Player entered");
}
}Legacy Input Manager와 Input System 1.14의 선택, Project Settings, 입력 읽기와 물리 적용의 경계를 정리합니다.
private bool jumpBuffered;
private void Update()
{
if (Input.GetButtonDown("Jump"))
jumpBuffered = true;
}
private void FixedUpdate()
{
if (!jumpBuffered)
return;
jumpBuffered = false;
Jump();
}Rigidbody의 상태에 따라 `MovePosition`, 힘, 속도, 위치 스냅을 고르고 입력과 물리 단계를 분리하는 기준을 정리합니다.
[SerializeField] private float moveSpeed = 5f;
private Rigidbody _body;
private Vector3 _moveDirection;
private void Awake() => _body = GetComponent<Rigidbody>();
private void Update()
{
_moveDirection = new Vector3(
Input.GetAxisRaw("Horizontal"), 0f, Input.GetAxisRaw("Vertical")
).normalized;
}
private void FixedUpdate()
{
Vector3 step = _moveDirection * moveSpeed * Time.fixedDeltaTime;
_body.MovePosition(_body.position + step);
}직선 물리 query에서 origin·distance·LayerMask·trigger 정책과 `RaycastHit` 결과를 안전하게 읽는 기준을 정리합니다.
[SerializeField] private LayerMask interactableMask;
if (Physics.Raycast(
transform.position + Vector3.up * eyeHeight,
transform.forward,
out RaycastHit hit,
interactDistance,
interactableMask,
QueryTriggerInteraction.Ignore))
{
IInteractable target = hit.collider.GetComponent<IInteractable>();
target?.Interact();
}플레이어 이동에서 직접 제어하는 CharacterController와 물리 반응을 받는 Rigidbody의 책임·설정·API 경계를 비교합니다.
private Vector3 _verticalVelocity;
private void Update()
{
if (_controller.isGrounded && _verticalVelocity.y < 0f)
_verticalVelocity.y = -groundStickSpeed;
_verticalVelocity.y += Physics.gravity.y * Time.deltaTime;
Vector3 motion = ReadMoveDirection() * moveSpeed + _verticalVelocity;
CollisionFlags flags = _controller.Move(motion * Time.deltaTime);
}충돌 pair 규칙, 물리 query 필터, trigger 포함 여부를 Layer·LayerMask·Collision Matrix로 분리해 정리합니다.
[SerializeField] private LayerMask interactableMask;
bool found = Physics.Raycast(
origin,
direction,
out RaycastHit hit,
interactDistance,
interactableMask,
QueryTriggerInteraction.Ignore
);AI Navigation의 bake 기준, NavMeshAgent Inspector 값, 목적지 요청과 경로 완료 상태를 분리해 정리합니다.
public bool TryMoveTo(Vector3 target)
{
if (!_agent.isOnNavMesh) return false;
return _agent.SetDestination(target);
}
private bool HasReachedDestination()
{
if (_agent.pathPending) return false;
if (!_agent.hasPath) return false;
if (_agent.pathStatus != NavMeshPathStatus.PathComplete) return false;
return _agent.remainingDistance <= _agent.stoppingDistance;
}Input Action Asset, Action Map, Action, PlayerInput Inspector와 player별 action instance·이벤트 연결을 정리합니다.
Game.inputactions
Gameplay: Move (Value/Vector2), Jump (Button)
UI: Navigate (Value/Vector2), Submit (Button)
PlayerInput
Actions = Game.inputactions
Default Action Map = GameplayInteraction phase·timeout, control scheme의 장치 계약, composite binding과 rebinding override 저장·충돌 처리를 정리합니다.
Jump: Button + Press
Charge: Button + Hold(duration=0.5초)
Move: Value/Vector2 + 2D Vector composite (W/A/S/D)
Keyboard&Mouse scheme: Keyboard + Mouse 필요
Gamepad scheme: Gamepad 필요Prefab 생성·parent·좌표 지정과 Destroy의 예약 시점·delay·pool 반환 경계를 정리합니다.
Prefab asset·scene instance·override·variant의 Inspector 적용 범위와 nested prefab의 apply 대상을 정리합니다.
UnityEngine.Pool.ObjectPool의 생성·대여·반환 callback, double release 검사, max size와 lifecycle reset을 정리합니다.
Single·Additive·async scene load의 active scene, activation, binding, unload ownership을 구분합니다.
DontDestroyOnLoad의 root object 제약, child 보존 범위, duplicate 생성·static reset·scene reference 정리 방법을 확인합니다.
private void Awake()
{
DontDestroyOnLoad(gameObject); // root GameObject에서 호출
}ScriptableObject asset의 Inspector 값, 공유 instance 특성, Editor asset 저장과 deployed build runtime 상태의 경계를 정리합니다.
[CreateAssetMenu(menuName = "Game/Weapon Definition")]
public sealed class WeaponDefinition : ScriptableObject
{
[SerializeField] private string displayName;
[SerializeField] private int baseDamage;
public int BaseDamage => baseDamage;
}PlayerPrefs의 string·int·float API, 기본값·Save 시점, platform local storage와 보안·schema 한계를 정리합니다.
private const string MusicVolumeKey = "settings.musicVolume.v1";
float volume = PlayerPrefs.GetFloat(MusicVolumeKey, 0.8f);
PlayerPrefs.SetFloat(MusicVolumeKey, volume);
PlayerPrefs.Save();세션 공유, 씬 수명주기, 앱 재실행 뒤 저장을 분리해 DontDestroyOnLoad·ScriptableObject·PlayerPrefs·JSON을 고릅니다.
Addressables 2.7 기준으로 address·label·AssetReference·group을 자산 식별과 수명 소유권 관점에서 정리합니다.
[SerializeField] private AssetReferenceGameObject enemyPrefab;
// AssetReference는 Inspector에 연결된 addressable key입니다.
// 실제 메모리 수명은 LoadAssetAsync/InstantiateAsync handle이 결정합니다.Addressables 2.7의 handle 상태·실패·release·instance 소유권을 한 요청당 한 release 원칙으로 정리합니다.
using UnityEngine.AddressableAssets;
using UnityEngine.ResourceManagement.AsyncOperations;
private AsyncOperationHandle<GameObject> _prefabHandle;
private bool _ownsPrefabHandle;
private async void LoadPrefab()
{
_prefabHandle = Addressables.LoadAssetAsync<GameObject>(enemyKey);
_ownsPrefabHandle = true;
await _prefabHandle.Task;
if (_prefabHandle.Status != AsyncOperationStatus.Succeeded)
{
Debug.LogError(_prefabHandle.OperationException);
ReleasePrefab();
return;
}
_instance = Instantiate(_prefabHandle.Result);
}
private void OnDestroy() => ReleasePrefab();
private void ReleasePrefab()
{
if (!_ownsPrefabHandle) return;
if (_prefabHandle.IsValid()) Addressables.Release(_prefabHandle);
_ownsPrefabHandle = false;
}Addressables 2.7에서 remote group·profile·catalog update·bundle cache를 배포 순서와 실패 정책으로 정리합니다.
Button.onClick의 Inspector persistent listener와 코드 runtime listener, 등록·해제·풀링 시 소유권을 정리한 레퍼런스입니다.
Animator Controller의 파라미터와 전이 조건을 연결하고, 각 타입의 기본값·소비 시점·스크립트 API를 빠르게 확인합니다.
private static readonly int SpeedId = Animator.StringToHash("Speed");
private static readonly int GroundedId = Animator.StringToHash("Grounded");
private static readonly int AttackId = Animator.StringToHash("Attack");
[SerializeField] private Animator animator;
public void ApplyState(float inputMagnitude, bool isGrounded, bool attackPressed)
{
animator.SetFloat(SpeedId, inputMagnitude);
animator.SetBool(GroundedId, isGrounded);
if (attackPressed)
{
animator.ResetTrigger(AttackId); // 이전에 남은 요청을 취소해야 할 때만 사용
animator.SetTrigger(AttackId);
}
}정적인 UI와 자주 바뀌는 UI를 Canvas 경계로 나누고, Canvas Inspector와 스크립트 정렬 값을 함께 점검하는 레퍼런스입니다.
Graphic Raycaster의 입력 검사 범위, Raycast Target, 물리 blocker와 런타임 Raycast API를 정리한 레퍼런스입니다.
UGUI Layout Group, Content Size Fitter, Layout Element의 Inspector 값과 같은 RectTransform을 동시에 제어할 때의 충돌을 정리한 레퍼런스입니다.
SetActive, CanvasGroup, Canvas.enabled의 표시·입력·수명주기 차이와 CanvasGroup Inspector 값을 정리한 레퍼런스입니다.
RectTransform의 anchor·pivot·offset과 Canvas Scaler의 해상도 대응 값을 Inspector와 스크립트 API 기준으로 정리한 레퍼런스입니다.
Cinemachine 3.1의 Brain과 Cinemachine Camera를 연결하고, priority·channel·blend·스크립트 제어 지점을 확인합니다.
Unity Camera + CinemachineBrain
<- live CinemachineCamera의 상태를 선택·blend
CinemachineCamera
<- Tracking Target, Position Control, Rotation Control, Lens를 선언Cinemachine 3.1의 Position Control·Rotation Control·Lens를 분리해 구도와 반응성을 튜닝합니다.
Timeline Asset과 Playable Director를 분리하고, Director Inspector의 재생 시간·Wrap Mode·binding·스크립트 API를 확인합니다.
Timeline Asset
Animation / Audio / Activation / Signal Track과 Clip의 시간
↓
PlayableDirector (씬)
Playable, Update Method, Wrap Mode, Generic Bindings
↓
특정 Animator, AudioSource, GameObject, Cinemachine Brain/CameraTimeline Track의 역할을 분리하고, SignalAsset·SignalEmitter·SignalReceiver·INotificationReceiver를 게임 상태와 안전하게 연결합니다.
SignalAsset "BossIntroFinished"
-> SignalEmitter marker (Signal Track의 12.0초)
-> Signal Track이 binding된 SignalReceiver로 notification 전송
-> SignalReceiver reaction의 UnityEvent
-> 게임 규칙 코드가 idempotent하게 상태 변경Unity 6.5 UI Toolkit의 UIDocument·PanelSettings, UXML·USS·C# 역할과 runtime event·binding 연결을 정리한 레퍼런스입니다.
Unity 6.5에서 UI Toolkit과 uGUI를 화면 유형, rendering/input 경계, 기존 자산과 PanelSettings·Canvas workflow로 선택하는 레퍼런스입니다.
Shader Graph의 Target·Surface·Blackboard 설정과 Material·MaterialPropertyBlock 스크립트 연결을 정리합니다.
URP Lit Graph
Target: Universal
Surface Type: Opaque
Blackboard: BaseColor, Smoothness
Material: Enemy.mat
Renderer 한 개 override: MaterialPropertyBlockShader Graph에서 property와 keyword를 어떻게 노출하고, material 단위 변형을 어떻게 관리할지 정리합니다.
Unity Profiler 모듈, Record·Deep Profile·Call Stacks 설정, 타깃 기기 측정과 프레임 스파이크 판독을 정리한 레퍼런스입니다.
Profiler Memory 모듈과 Memory Profiler snapshot의 역할, used·reserved·untracked memory, 같은 상태끼리의 snapshot 비교를 정리한 레퍼런스입니다.
Profile Analyzer의 CPU frame·thread·marker 통계와 Compare view를 사용해 동일 조건의 변경 전후 회귀를 판정하는 레퍼런스입니다.
Frame Debugger에서 render target, draw event, shader pass, UI와 투명 오브젝트의 순서를 읽고 Profiler·overdraw 보기와 구분하는 레퍼런스입니다.
타깃 기기와 frame pacing을 기준으로 CPU·GPU·메모리·로딩 예산을 정하고 median·p95·worst frame으로 회귀를 판정하는 레퍼런스입니다.
`Fixed Timestep`과 `Maximum Allowed Timestep`이 물리 정확도·CPU 비용·느린 프레임에서의 시간 손실에 미치는 영향을 정리합니다.
private void FixedUpdate()
{
// fixedDeltaTime은 물리 step 하나의 game-time 간격입니다.
_body.AddForce(thrust * Time.fixedDeltaTime, ForceMode.Force);
}반복 물리 query에서 재사용 버퍼·포화 감지·결과 순서·trigger 필터를 관리해 GC를 줄이는 기준을 정리합니다.
[SerializeField] private LayerMask enemyMask;
private readonly Collider[] _hits = new Collider[32];
private int FindEnemies(Vector3 center, float radius)
{
int count = Physics.OverlapSphereNonAlloc(
center,
radius,
_hits,
enemyMask,
QueryTriggerInteraction.Ignore
);
if (count == _hits.Length)
Debug.LogWarning("Overlap buffer may be saturated.");
for (int i = 0; i < count; i++)
ProcessEnemy(_hits[i]);
return count;
}일반 query, 재사용 버퍼, 배치 job 중 실제 병목과 결과 소비 시점에 맞는 물리 query 방식을 정리합니다.
NativeArray<RaycastCommand> commands = new(count, Allocator.TempJob);
NativeArray<RaycastHit> results = new(count, Allocator.TempJob);
try
{
for (int i = 0; i < count; i++)
commands[i] = new RaycastCommand(origins[i], directions[i], QueryParameters.Default);
JobHandle handle = RaycastCommand.ScheduleBatch(commands, results, minCommandsPerJob: 1);
handle.Complete();
for (int i = 0; i < count; i++)
if (results[i].collider != null) ProcessHit(results[i]);
}
finally
{
if (commands.IsCreated) commands.Dispose();
if (results.IsCreated) results.Dispose();
}실기기 프레임 시간에서 CPU·GPU 병목과 frame pacing을 분리하고, draw event·SetPass·SRP Batcher·GPU Instancing을 해석하는 레퍼런스입니다.
비어 있거나 불필요한 Update 계열 메시지를 제거할 기준과 event·coroutine·중앙 Tick의 책임, 구독 해제 조건을 정리한 레퍼런스입니다.
내부 asset·third-party·test·generated output의 책임을 분리하고, folder 구조와 build inclusion을 구분합니다.
Assets/
Game/ # 팀이 소유하는 gameplay·art·scenes·prefabs
ThirdParty/ # 외부 asset의 원본과 update 경계
Tests/ # test assemblies와 fixtures
_Dev/ # sandbox, profiling, migration toolsasset과 .meta의 GUID·import 설정 관계, 외부 이동 시 보존 조건, Preset Manager의 적용 범위를 정리합니다.
Assets/Characters/Player.prefab
Assets/Characters/Player.prefab.meta대량 Update 호출에서만 고려할 중앙 Tick 등록 구조와 중복 등록, 순회 중 해제, 예외 전파의 소유권을 정리한 레퍼런스입니다.
반복 lookup·검색·할당을 Profiler에서 찾고, 캐시 소유권과 무효화 조건을 정해 줄이는 방법을 정리합니다.
private Rigidbody body;
private void Awake()
{
if (!TryGetComponent(out body))
enabled = false;
}
private void FixedUpdate()
{
body.AddForce(Vector3.forward, ForceMode.Acceleration);
}개발 중에는 로그를 유지하되, 릴리스 빌드에서는 과도한 `Debug.Log` 비용을 줄이는 Unity 기본 전략입니다.
[System.Diagnostics.Conditional("ENABLE_LOG")]
public static void Log(object message)
{
Debug.Log(message);
}Animator 파라미터와 Shader property를 문자열 대신 ID로 호출할 때의 범위, Material 소유권, 실행 세션 한계를 정리합니다.
private static readonly int SpeedId = Animator.StringToHash("Speed");
private static readonly int BaseColorId = Shader.PropertyToID("_BaseColor");asmdef Inspector의 참조·플랫폼·테스트 설정을 기준으로 컴파일 범위와 의존성을 분리하는 방법을 정리합니다.
Game.Runtime.asmdef 게임 실행 코드
Game.Editor.asmdef UnityEditor 도구, Game.Runtime 참조
Game.Tests.asmdef NUnit 테스트, Game.Runtime 참조Unity Test Framework 1.6의 test asmdef, EditMode·PlayMode runner, NUnit·UnityTest, command-line 결과 확인을 정리합니다.
Game.Runtime.asmdef
Game.Tests.EditMode.asmdef -> Game.Runtime, Test Assemblies, Editor platform
Game.Tests.PlayMode.asmdef -> Game.Runtime, Test AssembliesScriptableObject event channel의 asset 설정, Raise·구독·해제 API, scene 전환과 play mode reset에서의 listener 수명주기를 정리합니다.
DamageDealer --Raise()--> DamageEvent asset --Action--> UI / audio / quest listenersUnity 의존 코드는 얇게 두고, 핵심 로직은 순수 C#으로 분리해 테스트 가능성을 높이는 구조를 정리합니다.
MonoBehaviour
-> 입력, lifecycle, scene wiring
순수 C# class
-> 규칙, 계산, 상태 전이공식 batchmode를 재현 기준선으로 두고, `unity-cli`와 MCP의 설치·버전·권한·복구 경계를 정리합니다.
# CI 기준선: static Editor method를 실행하고 실패는 non-zero로 끝냅니다.
"$UNITY" -batchmode -projectPath "$PROJECT" \
-executeMethod BuildTools.BuildPlayer -quit -logFile "$LOG"
# Test Framework: -runTests와 -batchmode, 결과 파일을 함께 둡니다.
# Unity 6.5에서는 -quit을 함께 쓰면 진행 중인 테스트가 끝나기 전에 종료될 수 있습니다.
"$UNITY" -runTests -batchmode -projectPath "$PROJECT" \
-testPlatform EditMode -testResults "$RESULTS"