This repository contains an Unreal Engine 5 C++ game project.
To build and run this project, ensure you have the following installed:
- Unreal Engine 5.7.4
- JetBrains Rider (Recommended IDE)
- Visual Studio Build Tools (with C++ desktop/game development workloads and required Windows SDK)
We use JetBrains Rider with the direct .uproject opening workflow. You do not need to generate Visual Studio project files (.sln).
- Clone this repository.
- Open JetBrains Rider.
- Select Open File or Folder and choose the
*.uprojectfile. - Rider will automatically index the project and resolve dependencies.
- Select your build configuration (e.g.,
Development Editor) and build the project (Ctrl+Shift+B).
The project uses CircleCI to automate build, packaging, and release workflows for Windows targets. The following variables must be set in the CircleCI github context
(Project Settings → Contexts) before a tagged build can succeed:
| Variable | Description |
|---|---|
GITHUB_TOKEN |
GitHub token with read:packages and write:packages permissions |
GITHUB_USERNAME |
GitHub username |
UE5_DOCKER_IMAGE |
UE5 Docker image reference |
PROJECT_NAME |
Unreal project name (.uproject) |
EOS_ARTIFACT_NAME |
EOS artifact name |
EOS_CLIENT_ID |
EOS Client ID |
EOS_CLIENT_SECRET |
EOS Client Secret |
EOS_PRODUCT_ID |
EOS Product ID |
EOS_SANDBOX_ID |
EOS Sandbox ID |
EOS_DEPLOYMENT_ID |
EOS Deployment ID |
EOS_ENCRYPTION_KEY |
64-character hex encryption key |
These values replace the placeholders in Config/DefaultEngine.ini at build time
and must never be committed to the repository.
To avoid compiling Unreal Engine from source during CI execution, the pipeline relies on a prebuilt Docker image containing a local Unreal Engine installation for Windows target. I wrote a doc to explain how to build this image here.