Unreal Quickstart#

See the Unreal OSS Quickstart video, or continue below.

About#

This tutorial will teach you how to:

  • Clone lyrastartergame

  • Initialize git submodules

  • Setup Unreal plugins via PowerShell script

  • Generate project files

  • Open an arbitrary map in Unreal → Play

Also see: The repo README

Prerequisites#

  • PowerShell

  • Epic Games Account

  • Unreal Engine 5.4

  • Unreal-supported IDE of choice:

    • IDE such as VS2022 Community (used below) or JetBrains Rider

    • With Unreal Engine 5 SDK required components

    • With C++ and Windows SDKs

  • Git: GitLab access token from our private (but source-available) repository:

    • Navigate to the top-left profile icon

    • Select Preferences

    • Go to Access Tokens → Add new token

Getting Started#

  1. Clone and sync the lyrastartergame project repo:

git clone https://source.goxbe.io/Core/samples/lyrastartergame.git
  1. Initialize and update git submodules for the given repository to clone XsollaBackend into Plugins/XsollaBackend:

git submodule init
git submodule update
cd .\Plugins\XsollaBackend\
  1. Run the setup script with PowerShell:

./setup.ps1

Generate IDE Project Files#

Right-click LyraStarterGame.uprojectGenerate Visual Studio Project Files:

.uproject Generate Project Files (Context Menu)

Configure IDE Build Target#

Open your IDE and build the solution in the Development Editor configuration (VS2022):

  1. Change the top menu dropdown build target (to the left of Win64) to Development Editor

  2. From the top menu: Build → Rebuild Solution

VS2022 Build Solution via Development Editor Top Menu Build → Rebuild Solution

Open the Unreal Editor#

Using the Windows Explorer shell menu’s Open with… option on the .uproject file:

.uproject Context Menu - Open with Unreal Engine

Open a Level#

  1. File → Open level

  2. Open the map: level/system/frontend/maps/L_LyraFrontEnd

  3. Play

Unreal Editor - Open Level Unreal Editor - Select path level/system/frontend/maps/L_LyraFrontEnd Unreal Editor - Play Button

Done#

Observe a successful login through the Unreal Engine log console.

Looking to dive deeper? See the :