게임 프로젝트 기초집LESSON 03

프로젝트 구조 설계: Scene·Prefab·Script·Data 폴더를 역할별로 나누기

난이도초급 프로젝트

예상 시간40분

선수지식2강 핵심 게임 루프

3강. 프로젝트 구조 설계: Scene·Prefab·Script·Data 폴더를 역할별로 나누기

1. 이번 강의에서 해결할 문제

새 스크립트와 Prefab을 Assets 루트에 계속 만들면 참조와 책임을 찾기 어렵습니다. 이동·생성·규칙·UI가 어디에 있어야 하는지 폴더와 네임스페이스로 정합니다.

2. 학습 목표

3. 핵심 개념

폴더는 기술 종류만이 아니라 변경 이유를 보여 줍니다. 게임 규칙은 Core, 택배와 생성은 Gameplay, 표시만 UI, 소리 재생은 Audio에 둡니다. Unity 에셋은 .meta와 GUID 참조를 사용하므로 파일 탐색기보다 Unity Project 창에서 이동합니다.

4. 단계별 실습

프로젝트 구조

Assets/_Project/
├─ Art/
├─ Audio/
├─ Data/
├─ Docs/
├─ Prefabs/
├─ Scenes/Main.unity
└─ Scripts/
   ├─ Core/
   ├─ Data/
   ├─ Gameplay/
   ├─ UI/
   └─ Audio/

C# · 파일 경로: Assets/_Project/Scripts/Core/GameState.cs

GameState.cs
namespace DeliverySorter.Core
{
    public enum GameState { Start, Playing, Paused, GameOver }
}

Unity Editor 작업: Project 창에서 폴더를 만들고 Main.unity를 저장합니다. Packages나 다른 기존 과정 폴더는 이동하지 않습니다.

PowerShell · 실행 위치: 프로젝트 루트

Get-ChildItem .\Assets\_Project -Directory
Get-ChildItem .\Assets\_Project\Scripts -Directory

예상 결과: 역할별 폴더가 표시됩니다. Inspector 연결 작업: 에셋 이동 뒤 Scene과 Prefab의 Missing 참조가 없는지 확인합니다.

5. 코드가 동작하는 이유

네임스페이스가 같은 이름 충돌을 줄이고 폴더가 책임의 물리적 위치를 알려 줍니다. Unity 안에서 이동하면 GUID가 유지되어 직렬화된 참조가 보존됩니다.

6. 자주 하는 실수와 해결법

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ