1) 폴더/깃 구조 결정

권장 디렉토리 구조

D:\\Github\\ToyboxNightmare\\
├─ .git/
├─ External/
│  └─ GameFramework/              ← 외부 C# 프레임워크 (별도 .csproj)
│     ├─ .git/                    ← (옵션) Git 서브모듈로 관리 가능
│     ├─ GameFramework.csproj
│     ├─ Runtime/
│     └─ ... (소스 코드)
├─ Assets/
│  ├─ Plugins/
│  │  ├─ GameFramework.dll        ← 빌드된 DLL (자동 복사)
│  │  └─ GameFramework.pdb        ← Debug 빌드 시에만
│  ├─ Scripts/                    ← 게임 로직 (DLL 참조)
│  └─ ...
├─ Packages/
│  └─ manifest.json               ← Unity.SharpZipLib 등록
└─ ProjectSettings/

이 구조의 장점

1. Assets 외부 배치의 핵심 이점

• Unity가 External/ 폴더를 컴파일 대상에서 제외한다
• unsafe 코드, 고급 C# 문법 사용 시 Unity 설정과 무관하게 자유롭게 개발할 수 있다
• .csproj 파일 기반으로 Visual Studio의 모든 기능(리팩토링, 분석, NuGet 등)을 완전히 활용할 수 있다
• 참조/네임스페이스 충돌을 방지한다 (Unity의 자동 컴파일 파이프라인 우회)

2. 빌드 산출물만 Unity로 전달

• DLL + PDB 조합으로 깔끔한 디버깅 환경을 구성한다
• 프레임워크 소스 변경 → 빌드 → Post-build로 자동 복사 → Unity가 리로드하는 흐름이다
• CI/CD 파이프라인 구성 시 명확한 빌드 단계를 분리할 수 있다

3. Git 서브모듈 활용 (선택적)

# GameFramework를 별도 저장소로 관리하는 경우
git submodule add [<https://github.com/yourname/GameFramework.git>](<https://github.com/yourname/GameFramework.git>) External/GameFramework

• 프레임워크를 여러 프로젝트에서 재사용할 수 있다
• 버전 관리 독립성을 확보할 수 있다 (Unity 프로젝트 ≠ 프레임워크 버전)

피해야 할 안티패턴