This page is not the current release of O3DE documentation. Click here to switch to the latest release, or select a version from the dropdown.

Version:

IN THIS ARTICLE

Getting Started with AWS Gems

To get started using AWS Gems with AWS services in your O3DE project, complete the following steps.

  1. Create an AWS account if you don’t have one.

  2. Configure AWS credentials following the instructions in Configuring AWS Credentials for O3DE .

    a. Confirm you have credentials using the command aws configure list.

  3. Install the AWS Cloud Development Kit (CDK) .

    a. Confirm the CDK is setup using the command cdk --version.

  4. Build your O3DE project with the AWS Core Gem (and other AWS Gems you need) enabled.

  5. Deploy the CDK applications for the AWS Gems you have enabled. See Deploying the CDK Application for instructions.

  6. Configure a resource mapping file using the Resource Mapping Tool .

  7. Associate the resource mapping file with the project. See the next section entitled Project Settings .

You should now be able to utilize AWS functions in Lua script, Script Canvas, or C++ to communicate with your AWS resources. See Scripting with AWS Core for scripting examples.

Project settings

On start up the AWS Core Gem will look for the awscoreconfiguration.setreg file in the project’s registry directory: <ProjectName>\Registry.

You will need to create this file if you want to set any of the following options. Use the format shown in the example.

SettingDescription
ProfileName[Optional] The project will use your default profile in ./aws/credentials (on macOS and Linux) or %USERPROFILE%\.aws\credentials (on Windows). Override the default profile or any environment variable setting by using this variable. Must be a named profile in your credentials file.
ResourceMappingConfigFileName[Optional] The name of the resource mapping file to load while starting up. Resource mapping files are expected to be located in <ProjectName>\Config. See Resource Mapping Files for more information.
Note:
If you make changes to this file, you will need to restart the O3DE Editor.

Example registry settings file:

{
    "Amazon":
    {
        "AWSCore": {
            "ProfileName": "testprofile",
            "ResourceMappingConfigFileName": "default_aws_resource_mappings.json"
        }
    }
}