Skip to content

Latest commit

 

History

History
127 lines (87 loc) · 4.84 KB

README.md

File metadata and controls

127 lines (87 loc) · 4.84 KB

coop-game-fleep

build workflow status

This is my personal repo with exercises, experiments and classwork of the https://www.udemy.com/course/unrealengine-cpp class. It was forked and is related to @tomlooman's original work on: https://github.com/tomlooman/CoopHordeShooter

coopgamefleep

Note repository is in a WIP state.

Prerequisites

For Windows 10/11:

  • Install Unreal Engine 5.2 (and all needed sub-dependencies)
  • Install Visual Studio 2022
  • Install all dependencies mentioned on official documentation
    • .NET desktop development
    • Desktop development with C++
    • Universal Windows Platform development
    • Game Development with C++
    • (also mentioned)
      • C++ profiling tools
      • C++ AddressSanitizer
      • Windows 10 SDK (10.0.18362 or Newer)
      • Unreal Engine installer

(Tested on a Windows 10 Pro, version 22H2)

For Linux/MacOS: Not used yet, work in progress

How to build

First, clone the repository, make sure you have everything listed on Prerequisites setup and then cd into the cloned folder.

Use .\scripts\Build.bat batch file to compile/build the project:

# UNREAL_PATH - Unreal engine install path, e.g. C:\Epic Games\UE_5.2
# PROJECT_NAME - project name, e.g. CoopGameFleep.uproject

.\scripts\Build.bat $env:UNREAL_PATH (Get-Location).Path $env:PROJECT_NAME

How to run tests

To run tests, use the .\scripts\RunTests.bat batch file:

# UNREAL_PATH - Unreal engine install path, e.g. C:\Epic Games\UE_5.2
# PROJECT_NAME - project name, e.g. CoopGameFleep.uproject
# TEST_SUITE_TO_RUN - e.g. CoopGameFleepTests.
# TEST_REPORT_FOLDER - e.g. TestResults
# TEST_LOGNAME - e.g. RunTests.log

.\scripts\RunTests.bat $env:UNREAL_PATH (Get-Location).Path $env:PROJECT_NAME $env:TEST_SUITE_TO_RUN $env:TEST_REPORT_FOLDER $env:TEST_LOGNAME

How to package and run

To package a game build for Win64 platform, r un .\scripts\Package.bat on a Powershell terminal:

# UNREAL_PATH - Unreal engine install path, e.g. C:\Epic Games\UE_5.2
# PROJECT_NAME - project name, e.g. CoopGameFleep.uproject
# TARGET_NAME - name of target, e.g. CoopGameFleep
# PACKAGE_FOLDER - Folder name where to place the packaged game binaries, e.g. PackageResults

.\scripts\Package.bat $env:UNREAL_PATH (Get-Location).Path $env:PROJECT_NAME $env:TARGET_NAME $env:PACKAGE_FOLDER

If packaging works successfully, you should see a log like:

UATHelper: Packaging (Windows): ********** ARCHIVE COMMAND COMPLETED **********
UATHelper: Packaging (Windows): BuildCookRun time: 636.56 s
UATHelper: Packaging (Windows): BUILD SUCCESSFUL
UATHelper: Packaging (Windows): AutomationTool executed for 0h 10m 37s
UATHelper: Packaging (Windows): AutomationTool exiting with ExitCode=0 (Success)

And you should see a packaged build in PACKAGE_FOLDER (or the -archivedirectory you've picked in case you edit the .\scripts\Package.bat batch file).

Note: First packaging is can take between 10 to 20 minutes. This is what it took on an AMD Ryzen 7 5800 processor and an Intel Core i7 6700k. It might take longer or less time depending on your specs.

Problems using the project locally

Unable to find package errors

I see a handful of errors when I try to run project from VSCode like:

Unable to find package (...)
Unable to find package (...)
Unable to find package (...)

Try to use solution documented in https://stackoverflow.com/a/70584286

Error opening project about bStrictConformanceMode

When converting from Engine version 5.2 to 5.4, I see errors like:

modifies the values of properties: [ bStrictConformanceMode ]

There's some documentation about it https://forums.unrealengine.com/t/build-failed-in-unreal-5-4/1789560/9, editing CoopGameFleepEditor.Target.cs and CoopGameFleep.Target.cs files with

DefaultBuildSettings = BuildSettingsVersion.V5;
bOverrideBuildEnvironment = true;

appears to have solved the issue.