15강. Content Only Plugin과 Code Plugin 선택 기준

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

머티리얼과 Blueprint 묶음에 불필요한 C++ Module을 만들거나, 반대로 모든 프로젝트에서 같은 C++ 판정과 Editor 검사를 Blueprint Utility로 복사합니다. 플러그인 유형은 생성 마법사의 템플릿이 아니라 배포할 계약과 소비 환경으로 선택해야 합니다.

✓2. 학습 목표

✓이 강의를 마치면

• Content Only와 Code Plugin의 빌드·배포 차이를 설명합니다.
• Blueprint·Asset만으로 충분한 기능과 C++ Module이 필요한 기능을 구분합니다.
• 두 최종 플러그인을 Code Plugin으로 선택한 근거를 기록합니다.

◇3. 핵심 개념

Content Only Plugin은 .uplugin과 Content를 제공하고 Source Module이 없습니다. 에셋 템플릿, 재질, 사운드와 Blueprint 라이브러리 배포에 적합할 수 있습니다. Code Plugin은 Source Module을 빌드하므로 지원 Engine·Platform·Toolchain과 Binary 호환성을 관리해야 하지만 C++ 계약, 자동 등록과 Editor 확장을 제공할 수 있습니다.

요구	Content Only	Code Plugin
Material·Texture·Blueprint 묶음	적합	필요할 때만
C++ Interface·Component	불가	Runtime Module 필요
ToolMenus·Slate·Validator	불가	Editor Module 필요
소비자 컴파일 환경 불필요	Binary/Content 구성에 따라	Source Plugin은 C++ Toolchain 필요

✎4. 단계별 실습

세 가지 후보를 결정합니다.

1. VFX와 Material Instance만 배포: Content Only 후보
2. Trace와 IInteractable C++ 계약: Runtime Code Plugin
3. UEditorValidatorBase, ToolMenus와 Slate: Editor Code Plugin

Content를 포함하려면 Descriptor를 명시합니다.

{
  "CanContainContent": true
}

이 값은 Content Browser의 Plugin Content 사용을 가능하게 하지만, 사용되지 않는 에셋 Cook과 Runtime 로드를 자동 보장하지 않습니다. Runtime 코드가 플러그인 에셋을 필요로 한다면 Soft Reference와 Asset Manager·Packaging 정책을 30강에서 검증합니다.

→5. 코드가 동작하는 이유

Code Plugin의 Module은 UBT 의존성 그래프와 현재 Target에 포함됩니다. Content Only Plugin은 C++ Symbol을 제공하지 않으므로 Engine 버전별 Source 컴파일 부담이 적지만, 복잡한 판정과 Editor 자동화 책임을 안정적인 네이티브 계약으로 제공할 수 없습니다.

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

!자주 하는 실수

• 템플릿 이름으로 유형 선택: 최종 소비자가 필요한 계약과 배포물을 먼저 적습니다.
• Content Only면 버전 영향이 없다고 가정: Asset 직렬화와 Blueprint API 변화도 검증합니다.
• Code Plugin에 모든 에셋 포함: 필요한 Content만 분리하고 Hard Reference를 점검합니다.
• Editor Utility를 Runtime 기능처럼 배포: 실행 환경과 자동화 요구가 다르면 Plugin을 분리합니다.

✎7. 직접 실습

✎직접 실습

재사용 후보 5개를 Content, Runtime Code, Editor Code로 분류하고 각 소비자, 빌드 필요 여부, Cook 필요 여부와 실패 가능성을 기록하세요. ReusableInteraction과 DataGuard가 서로 다른 Code Plugin이어야 하는 이유를 한 문단으로 정리합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Content Only Plugin과 Code Plugin의 가장 큰 빌드 차이는 무엇인가요?
2. CanContainContent가 true여도 Cook을 별도 검증해야 하는 이유는 무엇인가요?
3. DataGuard를 Content Only로 만들 수 없는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

Content Only는 에셋 패키지, Code Plugin은 C++ 계약과 자동화 Module이 필요한 경우 선택합니다. 두 실습은 각각 Runtime과 Editor Code Plugin입니다. 다음 강의에서는 Plugin을 Project 또는 Engine 범위 어디에 설치할지 결정합니다.