언리얼 엔진의 라이라 샘플 게임 | 언리얼 엔진 5.7 문서

라이라(Lyra)는 언리얼 엔진 5(UE5) 프레임워크의 이해를 돕기 위한 샘플 게임 프로젝트로 설계된 학습 리소스입니다. 모듈식 구조로 설계된 라이라에는 언리얼 엔진 5 개발과 함께 정기적으로 업데이트되는 코어 시스템 및 플러그인이 포함되어 있습니다.

크로스 플랫폼 호환성 및 확장성.
에픽 온라인 서비스 및 콘솔 온라인 서브시스템용 온라인 멀티플레이어 및 크로스 플레이 지원.
일리미네이션(팀 데스매치), 컨트롤(점령 지점 확보), 익스플로더(톱다운 파티 게임)의 세 가지 게임 모드 중 한 개를 선택할 수 있음.
커스터마이징된 게임플레이 어빌리티 시스템.
나이아가라 FX.
메뉴 세팅, 컨트롤러 키 스틱, 체력/마나/탄약 디스플레이 등 프로젝트의 게임플레이 콘셉트를 위한 언리얼 모션 그래픽(UMG) 위젯 클래스 및 UI 아이콘. 이러한 UI 기능은 모듈식으로 설계되었으므로 라이라와 무관한 게임에도 이 시스템을 활용할 수 있습니다.
모든 폰(Pawn)과 호환되는 로코모션 애니메이션 에셋, 사운드, 무기 시스템 등 최적화된 수제 콘텐츠.
UE5의 새로운 마네킹 매니(Manny)와 퀸(Quinn). 이 마네킹들은 메타휴먼과 동일한 코어 스켈레톤 계층구조를 공유하며, 애니메이션 시스템이 호환되는 플레이 가능 캐릭터입니다.

라이라 스타터 게임 다운로드하기

다음 단계에 따라 라이라(Lyra) 스타터 게임 샘플 프로젝트를 설치합니다.

팹(Fab)에서 Lyra Starter Game 샘플에 액세스하고 내 라이브러리에 추가(Add to My Library)를 클릭하여 에픽게임즈 런처에 프로젝트 파일이 표시되도록 합니다.
1. 아니면 런처에서 팹을 사용하거나 UE용 팹 플러그인을 사용하여 샘플 프로젝트를 검색할 수도 있습니다.
에픽게임즈 런처에서 언리얼 엔진 > 라이브러리(Library) > 팹 라이브러리(Fab Library)로 이동하여 프로젝트에 액세스합니다.
호환되는 엔진 버전을 설치한 경우에만 샘플 프로젝트가 팹 라이브러리에 표시됩니다.
프로젝트 생성(Create Project) 버튼을 클릭하고 화면의 지침에 따라 샘플을 다운로드한 뒤 새 프로젝트를 시작합니다.

팹에서 샘플 콘텐츠에 액세스하는 방법에 대한 자세한 내용은 샘플 및 튜토리얼을 참조하세요.

엔진 소스 빌드용 라이라 다운로드하기

언리얼 엔진 소스 빌드를 다운로드할 수 있습니다. 언리얼 엔진 소스 코드 다운로드하기를 참조하세요.

언리얼 엔진 소스 빌드의 다운로드를 마쳤다면 커스텀 빌드한 엔진의 최상위 디렉터리에 라이라를 다운로드하여 설치해야 합니다. 최상위 디렉터리를 선택하면 LyraStarterGame 하위 디렉터리가 생성되고, 소스 코드와 콘텐츠가 포함된 LyraStarterGame.uproject 파일이 생성됩니다.

설치된 샘플 사본을 실행하려면 .uproject 파일을 더블클릭하거나 런처의 라이브러리 탭에서 샘플을 바로 실행합니다.

커스텀 빌드 버전의 엔진을 사용 중이라면 프로젝트 파일을 재생성하고 라이라를 Visual Studio 등의 소스 코드 에디터 내에서 프로젝트로 실행할 수 있습니다.

엔진이 여러 버전으로 설치되었다면, LyraStarterGame.uproject 파일을 우클릭하여 다른 버전과 연결하거나 소스 코드 에디터로 컴파일하기 위한 프로젝트 파일을 생성할 수 있습니다.

게임 샘플 플레이하기

라이라를 실행하면 DefaultEditorOverview 레벨이 디폴트 맵(Default Map)으로 로드될 것입니다. 에디터에서 에디터에서 플레이(Play In Editor, PIE)를 클릭하여 디폴트 레벨을 실행할 수 있습니다.

PIE에서는 플레이어 컨트롤러가 라이라 폰에 빙의됩니다. 이 레벨에는 경험(Experience)을 로드하는 여러 포털이 있습니다.

아래 테이블은 각 맵에 대한 간단한 설명입니다.

게임 모드 맵	설명	콘텐츠 파일 경로
컨트롤(Control)	팀원들과 점령 지점을 확보해 점수를 모아서 승리하세요.	`/ShooterMaps/Maps/L_Convolution_Blockout`
처치	클래식 근접 팀 매치에서 적을 찾고 승리에 필요한 만큼 적을 제거하세요.	`/ShooterMaps/Maps/L_Expanse`
프론트엔드(Front End)	라이라 샘플 게임의 메인 메뉴가 포함되어 있습니다.	`/Game/System/FrontEnd/Maps/L_LyraFrontEnd`
디폴트 맵(Default Map)	사용자가 보는 맵의 베이스 예시입니다.	`/Game/System/DefaultEditorMap/L_DefaultEditorOverview`
슈팅 짐(Shooter Gym)	ShooterCore 플러그인 기능을 테스트하기 위한 소규모 테스트 레벨입니다.	`/ShooterCore/Maps/L_ShooterGym`
익스플로더(Exploder)	톱다운 파티 게임에서 블록을 파괴하고, 파워업을 수집하고, 폭파되지 않도록 피하세요.	`/TopDownArena/Maps/L_TopDownArenaGym`

에디터 내에서 파일(File) > 레벨 열기(Open Level)를 선택하고 위에 적힌 콘텐츠 파일 경로로 이동하여 각 게임 모드의 맵을 직접 로드할 수도 있습니다.

맵 대부분은 게임 피처 플러그인 내에 있습니다. 익스팬스(Expanse) 같은 맵을 처음 로드하면 에디터 뷰포트가 비어 있을 것입니다. 월드 파티션(World Partition) 맵이기 때문입니다.

레벨 액터를 보려면 우측 하단 월드 파티션(World Partition) 디테일 패널에서 월드 파티션 그리드 셀(world partition grid cells)을 클릭하고 드래그하여 선택한 다음 우클릭하고 선택된 셀 로드(Load Selected Cells)를 눌러서 맵의 해당 부분을 로드합니다.

게임 모드 레벨이 열린 상태로 에디터에서 플레이를 시작하면 마치 디폴트 맵에서 해당 포털로 들어간 것처럼 해당 게임 모드가 로드됩니다.

라이라 게임 맵 및 메뉴에 대한 추가 정보는 라이라 둘러보기 레퍼런스 페이지를 참고하세요.

라이라 프레임워크 시스템

라이라는 게임플레이 피처 플러그인(Gameplay Feature Plugin)을 사용하므로, Content 폴더에는 일반 에셋과 메인 로비만 들어 있습니다. 라이라 스타터 게임을 구성하는 다양한 핵심 엘리먼트는 Plugins 폴더에 있습니다.

로비에서 게임 경험을 선택하면 게임이 필요한 플러그인을 로드합니다. 예를 들어 익스팬스(Expanse) 팀 데스매치 맵을 선택하면 폰과 메커니즘을 위해 ShooterCore를 로드하고 레벨을 위해 ShooterMaps를 로드합니다.

플러그인 폴더 이름	설명
Lyra Example Content	그리드와 같은 공유 머티리얼이 있습니다.
Shooter Core Content	LyraShooterGame 경험의 핵심 엘리먼트입니다. 여기에는 대시와 같은 구체적인 게임플레이 어빌리티, 텔레포터나 수류탄 같은 액터의 블루프린트, 봇, 무기, 유저 인터페이스 엘리먼트 등 게임 모드를 위한 게임플레이 로직이 있습니다.
ShooterMaps Content	LyraShooterGame에서 사용하는 맵(익스팬스, 컨볼루션)과 관련 머티리얼 및 콘텐츠입니다.
TopDownArena Content	맵 생성기, 파워업 등 TopDownArena 경험을 위한 콘텐츠입니다.

경험은 LyraExperienceDefinition 클래스를 사용하여 정의됩니다. 툴바 > 창(Window) > 월드 세팅(World Settings) > 게임 모드(Game Mode)로 이동하여 월드 세팅에서 디폴트 게임플레이 경험(Default Gameplay Experience)에 액세스할 수 있습니다.

경험은 게임 모드의 훨씬 고급 버전이라고 생각하면 됩니다. 한 플러그인 내에 여러 경험이 있을 수 있습니다. 예를 들어 팀 데스매치와 점령 지점 경험은 둘 다 ShooterCore 플러그인을 사용하며, 동일한 부모 클래스(LyraExperienceDefinition의 자손 클래스 B_LyraShooterGameVase)에서 파생됩니다.

이 클래스들에는 라이라의 입력 및 게임플레이 메커니즘에 사용되는 정보가 포함됩니다. 다른 옵션들에는 팀 데스매치의 제거 및 점령 지점의 점령을 베이스로 하는 점수 시스템과 같은 정보가 포함됩니다.