You are currently viewing content for use with Unity game engine software. See all AWS GameKit documentation
Install AWS GameKit with the Unity engine
Summary
Download and install AWS GameKit for use with a Unity project. This topic describes how to set up AWS GameKit in the Unity development environment.
Requirements
To use the AWS GameKit package:
-
Unity Hub and an engine version compatible with the package you plan to use (see AWS GameKit version information).
AWS GameKit source code is available for customization. To modify the code and generate a custom package, you need a code editor for working with C# game projects. For example, for Visual Studio you need these tools:
-
Visual Studio C# integration, as described in the Unity Documentation
-
Visual Studio 2019 with the following tools installed:
-
On the Workloads tab:
-
Desktop Development with C#
-
Game development with Unity:
-
C++ profiling tools
-
C++ AddressSanitizer (optional)
-
Windows 10 SDK (10.0.18362 or newer)
-
-
-
On the Individual components tab: .NET Framework 4.8 SDK
-
What's in the AWS GameKit package
The AWS GameKit package includes the following:
-
Binaries for the Unity Editor.
-
AWS GameKit C# libraries with functionality for each game feature.
-
C# example code with API calls for testing each game feature.
-
Automated scripts for setting up AWS users with permissions for AWS GameKit and security credentials.
-
Default configuration files, which AWS GameKit uses to create your game backend.
Install AWS GameKit
Download the AWS GameKit package and install it with your Unity project.
To install:
-
Get the AWS GameKit package as a
.tgz
file from the AWS GameKit for Unity GitHub repo: aws/aws-gamekit-unity. -
With you project open in the Unity Editor, go to the Editor main toolbar and choose Window, Package Manager.
-
In the Package Manager window, choose the Add button in the status bar and select the option Add package from tarball. Locate your downloaded
.tgz
file and select it.The Unity Package Manager automatically unpacks the tarball and sets up the package for use in the Editor.
-
Verify that AWS GameKit is now displayed in the main toolbar. The Project window now has AWS GameKit added in the Projects folder. In the Assets folder, a new
com.amazonaws.gamekit
folder contains the code that AWS GameKit uses to deploy and manage a game's backend on AWS.
You can now start use AWS GameKit to build cloud-based features into your Unity project. Next steps:
Set up an AWS account and user access. See Set up AWS account for AWS GameKit
Set up your Unity project with AWS GameKit. See Set up a Unity project with AWS GameKit .