search

Voidware-Prohibited / TargetVector

An Unreal Engine 5 Template utilizing EOS (Epic Online Services), Steam, Modular Gameplay, Common UI and ALS (Advanced Locomotion System Refactored XT).
MIT License
83 stars 16 forks source link
advanced-locomotion-system als common-ui commonui eos epic-online-services modular-gameplay steam template ue5 unreal-engine

readme

Target Vector

Target Vector

GitHub last commit Checks Status GitHub issues GitHub pull requests MIT License Become a Sponsor Become a Patron

An Unreal Engine 5 Template utilizing EOS (Epic Online Services), Dedicated Server, Steam, Modular Gameplay, Common UI, Advanced Locomotion System Refactored XT, Lyra Modeling Tools and more.

This template also employs Test-Driven Development (TDD) and Continuous Integration (CI) and assumes working knowledge of C++, Jenkins and Unit Testing.

Table of contents

  1. Introduction
  2. Basic Setup
    1. Requirements
    2. EOS Setup
    3. Code
    4. Testing
    5. Troubleshooting
  3. Advanced Setup
    1. Requirements
    2. The CI/TDD Development Process
    3. First Time Steps
    4. Jenkins Setup
    5. The Jenkinsfile
    6. Discord Setup
    7. Automated Testing
  4. License
  5. Attributions
  6. Special Thanks

Introduction

UPDATE

*Currently under re-factoring for modularity. All functionality has been migrated into TargetVector plugins (TargetVectorEOS, TargetVectorCommonUi etc.), leaving the project empty. Documentation update is coming soon. Please update your forks regularly.**

Features

Dependecies

Core Plugins

Included Additional Plugins

External Dependencies These plugins will need to be copied from the Lyra Sample Game plugin folder ([UE5_Source_Folder]\Samples\Games\Lyra\Plugins) into this projects Plugins folder.

This is currently a work in progress, and not production-ready

Basic Setup

Setup for EOS and Dedicated Server

Basis Requirements

Unreal Engine 5 Source Build Setup

  1. Clone or download the release branch from the Epic Games github repository. This will be the source build you base your project and builds on from now on.
  2. Launch Setup.bat and let it complete.
  3. Launch GenerateProjectFiles.bat and let it complete.
  4. Open UE5.sln
  5. In the Solution Explorer, Right click on UE5 and click Build and allow it to successfully complete its initial build.

Setup for Linux Cross-Compile

  1. Download and Install clang -20 13.0.1 to the default folder
  2. In the Unreal Engine top folder launch GenerateProjectFiles.bat again and allow it to complete.
  3. In the same folder launch Setup.bat again and allow it to complete.
  4. Open UE5.sln again. In the Standard Toolbar at the top Linux should now be available as a Target.
  5. Rebuild UE5 in Visual Studio
  6. After rebuilding, open the Target Vector project again. In open Map tab click the drop-down menu next to "Platforms". If everything is setup correctly Linux should appear in the Content/SDK/Device Management list

Linux Cross-Compile Notes

Additional Step for Linux-ARM platforms

An additional step is required for the packaged project to be runnable on Linux-ARM platforms. The following has been verified using the SunTemple project packaged using Unreal-4.6 and executed on NVIDIA's Jetson TK1 platform.

Assuming the packaged project is located at \Users\foo\SunTemple_Linux open the following location: \Users\foo\SunTemple_Linux\LinuxNoEditor\Engine\Binaries\Linux and replace libopenal.so.1 with the version from: ...\UnrealEngine\Engine\Source\ThirdParty\OpenAL\1.15.1\lib\Linux\arm-unknown-linux-gnueabihf\libopenal.so where ...\UnrealEngine is the location of the UE4 source code. Please be sure to rename libopenal.so to libopenal.so.1.

Project Setup

  1. Create a subdirectory at the top directory of your Unreal Engine 5 Source Build called Projects
  2. Clone this project into the Projects folder. The structure should look like /Projects/[Name of this Repository]
  3. In the Unreal Engine top folder launch GenerateProjectFiles.bat again.
  4. Once finished, open the UE5.sln file and TargetVector should appear under the Games folder.
  5. This will be the Visual Studio solution you will use for your project from now on.

EOS Setup

This project is configured to read EOS Artifacts from EOSSettings.ini, which for securirity purposes, requires you to create it, and is set up to be ignored in the .gitignore file.

In the Config folder create a text file named EOSSettings.ini and copy and paste the following:

[/Script/OnlineSubsystemEOS.EOSSettings] 
+Artifacts=(ArtifactName="EOSArtifact",ClientId="",ClientSecret="",ProductId="",SandboxId="",DeploymentId="",EncryptionKey="")

Complete the required Artifacts fields in the ini file. These values can be found in Application Details in your Epic Dev Portal. It is highly recommended to keep your Artifacts in this ini file instead of editing the values in the Editor.

Open the Project with the Editor and in Project Settings > Maps & Modes select the EOS_GameInstance class in the Game Instance Class drop-down menu.

Code

Source code for the EOS Game Instance class can be found in the Source folder inside the Project folder. You are encouraged to expand, improve or sub-class the EOSGameInstance C++ class to meet the unique requirements of your project.

CommonUI functionality is implemented in the B_PlayerController, B_MainMenuController and B_HUD Classes. Source code for ALS_Refactored_XT can be found in the Plugins folder inside the Project folder.

Testing

To test the basic EOS functionality use the EOS_Testing.bat file. Edit the "ue5path" varible to reflect your Unreal Engine 5 installation directory. Currently, to test EOS functionality between multiple players you will need an Epic and Steam login for each player.

Developer Authentication Tool should also work

Troubleshooting

When testing, the Epic Games Overlay and Steams Overlay should always appear. If not, check your log files and verify all the EOS Artefacts are correct. Incorrect or incomplete EOS setup may also result in crashes.

Advanced Setup

Setup for Test-Driven Development (TDD) and Continuous Integration (CI)

Advanced Requirements

The CI/TDD Development Process

  1. Make local changes

  2. Commit and push changes to git remote repository (or Pull Request)

  3. Github receives the push and uses it's webhook to notify Jenkins (via Domain Name, Dynamic DNS or ngrok).

  4. Jenkins receives a notification that a repository included in a pipeline has received a push.

  5. Jenkins pulls each change to the remote repository into the Jenkins workspace.

  6. Jenkins starts the pipeline associated with that repository.

  7. The Pipeline builds the project.

  8. The Pipeline runs tests while doing code coverage.

  9. The Pipeline displays build status and tests reports.

  10. Jenkins notifies Github and Discord of the results of the pipeline build.

The Rule: Test > Refactor > Test

First Time Steps

  1. Install all required programs.

  2. Setup a Domain Name, Dynamic DNS or use ngrok access Jenkins via port (default is 8080).

  3. Setup Jenkins

  4. Setup Discord

  5. Create Unreal Project

  6. Setup EOS

  7. Create Jenkins Multibranch Pipeline project

  8. Push project changes to remote git server to activate the build trigger in Jenkins

Install Programs

  1. Unreal Engine 5
  2. Git
  3. Java
  4. Jenkins
  5. OpenCppCoverage

Jenkins Setup

In Jenkins Install these plugins:

After installing plugins:

  1. Add Github Credentials: Go to Job > Configure > Branch Sources and Click Add your github credentials om the folder named after the project/job.
  2. Setup Discord Plugin

The Jenkinsfile

TODO: Pull requests

Discord Setup

The discordSend Jenkins plugin is used to send messages to a Discord channel. The Webhook for Discord must be defined with the TVDISCORDWEBHOOK Environment Variable in Jenkins.

  1. In Discord right click on the channel you want Jenkins to send messages to and click Edit Channel.
  2. Navigate to Integrations > Webhooks and click New Webhook
  3. Name it to whatever you want and click Copy Webhook
  4. In Jenkins Navigate to Manage Jenkins > Configure System > Global Variables and check Environment Variables (if not already checked).
  5. Click the Add button
  6. In the new entry enter TVDISCORDWEBHOOK as Name
  7. Paste the Webhook copied from your Discord Channel Settings
  8. Click the Save and Apply buttons

Automated Testing

Included are 2 simple C++ tests in the "Game." group that are already setup to run in the Jenkinsfile and a VoidWorld map. Create new C++ tests in the /Source/Tests folder and add them to the "Game." group to automatically run Testing and Code Coverage with Jenkins builds. Alternatively modify the Jenkinsfile to use another test group or a specific test.

License

Original content and code in this repository is under the MIT license. Any git submodules are covered by their respective licenses. Content listed in the Attributions are covered by their respective licenses.

Attributions

Special Thanks

Game UI Database

Freesound

Mike Prinke

Sixze