Keep your GDK up to date

To use the SpatialOS GDK for Unreal, you need software from two git repositories:

  • The SpatialOS Unreal Engine fork
  • The GDK
    You download both of these as part of the Get started steps.
    To ensure you benefit from the most up-to-date functionality, always develop your game on the latest version of the software by regularly updating it. Whenever you update your GDK software, you must also update your SpatialOS Unreal Engine fork software. If you don’t, you might get errors from them being out of synch.

We recommend that you update your version of the GDK and SpatialOS Unreal Engine fork every week. To do this, follow the steps below.

Step 1: Ensure you’re on the release branches.

If you followed our Get started guide, you have these repositories cloned on your computer.

  • Your UnrealEngine repository should have the branch ending with -SpatialOSUnrealGDK-releasechecked out.
  • Your UnrealGDK repository should have the release branch checked out.

You can find out which branch you have checked out by following the instructions below:

  1. In a terminal of your choice, change directory to the root of the repository.
  2. Run git status. This should return On *-SpatialOSUnrealGDK-release in your UnrealEngine repository and On release in your UnrealGDK repository.
    If it returns a different branch, run git checkout <branch-name> to check out the branch that you want.

Step 2: Update your Unreal Engine fork and GDK.

Before you begin, read the release notes on the releases page of the UnrealGDK GitHub so you understand the changes that you’re about to download.

To update your Unreal Engine fork and GDK to the latest version, complete the following steps:

  1. In a terminal, change directory to the root of UnrealEngine.
  2. Run git pull to update your Unreal Engine.
  3. In a terminal, change directory to the root of UnrealGDK.
  4. Run git pull to update your GDK.
  5. Open File Explorer, navigate to the root directory of the Unreal GDK repository, and then double-click Setup.bat. You might be prompted to sign into your SpatialOS account if you have not signed in yet.
  6. In File Explorer, navigate to the <GameRoot> directory that contains your project’s .uproject file.
    Right-click on your .uproject file and select Generate Visual Studio project files.
  7. In File Explorer, navigate to <GameRoot>\Content\Spatialand delete SchemaDatabase.uasset. This is necessary because some GDK upgrades change how we handle schema, and this sometimes invalidates previously generated schema.

You are now on the latest GDK and the latest SpatialOS Unreal Engine fork.

Be sure to join the community on our forums or on Discord. We announce GDK versions there.

2019-04-15 Page added with editorial review

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums