Building PSUnreal on macOS

Reference docs

• Downloading Unreal Engine source code: https://docs.unrealengine.com/en-US/GettingStarted/DownloadingUnrealEngine/index.html
• Compiling Unreal Engine source code: https://github.com/EpicGames/UnrealEngine/blob/release/README.md

Compiling Unreal Engine

Note: As of 2020-05-05, you need ~120GB of disk space for a compiled version of the Unreal Engine.

• Step 1: Get access to the Unreal Engine source code.
  • You must be an Unreal Engine subscriber (if not, open an account there: https://www.unrealengine.com)
  • You must have a GitHub account (if not, open an account there: https://github.com)
  • Have associated your GitHub account with your Unreal Engine account as described on the UE4 on GitHub page.
  • At this point you should be able to access the Unreal Engine repository on GitHub.

• Step 2: Get the Unreal Engine source code.
  • Get the source code with: git clone -b 4.24.3-release https://github.com/EpicGames/UnrealEngine.git.
  • This will create an "Unreal Engine" sub-directory where you run the command.

• Step 3: Install the latest version of Xcode.
  • Install the latest version of Xcode.

• Step 4: Prepare the Xcode workspace.
  • In the UnrealEngine directory, run the following two scripts: Setup.command and GenerateProjectFiles.command.
  • The first command downloads 11.5 GB of dependencies and may take some time.
  • The second command generates the UE4.xcworkspace Xcode workspace.

• Step 5: Compile Unreal Engine with Xcode.
  • Load the UE4.xcworkspace into Xcode.
  • Select the ShaderCompileWorker > My Mac target in the title bar, then build with Product > Build menu item.
  • Wait for the build to complete.
  • Select the UE4 > My Mac target, and build again.
  • Compiling may take a long time, depending on your system specs.
  • After the compilation finishes, select the 'Product > Run' menu item to load the editor.