ModuleAndPlugin

언리얼 프로젝트의 모듈과 플러그인 구조를 직접 만들어보기 위한 과제 프로젝트입니다.

구현 내용

• Third Person C++ 프로젝트 생성
• Test 런타임 모듈 추가
• 두 Target 파일과 .uproject에 Test 모듈 등록
• 기본 게임 모듈에서 ATestActor를 생성하고 화면 메시지 출력
• Temporary 런타임 플러그인 수동 구성 및 활성화
• 플러그인의 StartupModule, ShutdownModule 구현
• UObject 기반 UTemporaryCharacterData 제작
• 기본 캐릭터에서 플러그인의 데이터 클래스를 생성하고 초기값 출력

모듈 제작 과정

Source/Test에 Test.Build.cs, Test.h, Test.cpp를 만들고 IMPLEMENT_MODULE(FDefaultModuleImpl, Test)로 일반 모듈을 등록했습니다.

외부 모듈에서 사용할 TestActor.h는 Public 폴더에 두었고 구현 파일은 Private 폴더에 배치했습니다. 기본 게임 모듈은 Test를 Private Dependency로 추가하고 캐릭터의 BeginPlay에서 ATestActor를 생성합니다.

플러그인 제작 과정

Plugins/Temporary에 .uplugin, Content, Source/Temporary 구조를 만들었습니다. 플러그인 모듈은 프로젝트가 시작될 때 StartupModule, 종료될 때 ShutdownModule을 실행합니다.

도전 기능으로 플러그인 안에 UTemporaryCharacterData를 추가했습니다. 캐릭터가 이 객체를 데이터 저장소로 사용하며 이름과 체력 초기값을 화면에 표시합니다.

실행 확인

에디터에서 Third Person 맵을 플레이하면 다음 메시지가 표시됩니다.

• Test module: TestActor spawned successfully!
• Plugin Character - Health: 150

UE 5.5, Development Editor 구성에서 전체 빌드를 확인했습니다.